AskSage
AskSage 专注于教育和学习场景的 AI 模型提供商,为学术研究和教学提供专业支持。
支持的模型
- asksage-v1 - 主要的 AskSage 模型
- asksage-v1-tutor - 专门的辅导模型
- asksage-v1-research - 学术研究模型
- asksage-v1-math - 数学专用模型
配置
基础配置
在 config.yaml 或 ~/.bytebuddy/config.yaml 中配置:
yaml
models:
- name: "asksage-general"
provider: "asksage"
model: "asksage-v1"
apiKey: "${ASKSAGE_API_KEY}"
roles: ["chat"]
defaultCompletionOptions:
temperature: 0.7
maxTokens: 4096辅导专用配置
yaml
models:
- name: "asksage-tutor"
provider: "asksage"
model: "asksage-v1-tutor"
apiKey: "${ASKSAGE_API_KEY}"
roles: ["chat"]
defaultCompletionOptions:
temperature: 0.5
maxTokens: 2048多模型配置
yaml
models:
- name: "asksage-general"
provider: "asksage"
model: "asksage-v1"
apiKey: "${ASKSAGE_API_KEY}"
roles: ["chat"]
defaultCompletionOptions:
temperature: 0.7
maxTokens: 4096
- name: "asksage-math"
provider: "asksage"
model: "asksage-v1-math"
apiKey: "${ASKSAGE_API_KEY}"
roles: ["chat"]
defaultCompletionOptions:
temperature: 0.3
maxTokens: 2048配置字段
必需字段
- name: 模型配置的唯一标识符
- provider: 设置为
"asksage" - model: 模型名称
- apiKey: AskSage API 密钥
可选字段
- roles: 模型角色 [
chat,edit,apply] - defaultCompletionOptions:
temperature: 控制随机性 (0-1)maxTokens: 最大令牌数topP: 核采样参数frequencyPenalty: 频率惩罚presencePenalty: 存在惩罚
环境变量
bash
# ~/.bashrc 或 ~/.zshrc
export ASKSAGE_API_KEY="your-asksage-api-key"获取 API 密钥
- 访问 AskSage 网站
- 注册账户并登录
- 导航到 API 密钥页面
- 生成新的 API 密钥
- 将密钥保存到环境变量
使用场景配置
教育辅导
yaml
models:
- name: "tutor"
provider: "asksage"
model: "asksage-v1-tutor"
apiKey: "${ASKSAGE_API_KEY}"
roles: ["chat"]
defaultCompletionOptions:
temperature: 0.5
maxTokens: 2048学术研究
yaml
models:
- name: "research"
provider: "asksage"
model: "asksage-v1-research"
apiKey: "${ASKSAGE_API_KEY}"
roles: ["chat"]
defaultCompletionOptions:
temperature: 0.3
maxTokens: 4096数学辅导
yaml
models:
- name: "math-tutor"
provider: "asksage"
model: "asksage-v1-math"
apiKey: "${ASKSAGE_API_KEY}"
roles: ["chat"]
defaultCompletionOptions:
temperature: 0.2
maxTokens: 2048故障排除
常见错误
- 401 Unauthorized: 检查 API 密钥是否正确
- 429 Too Many Requests: 达到速率限制,请稍候重试
- 模型不可用: 确认订阅计划支持该模型
调试步骤
- 验证 API 密钥格式和有效性
- 检查速率限制和配额
- 确认模型名称拼写正确
- 查看错误日志了解详情
最佳实践
1. 安全性
- 使用环境变量存储 API 密钥
- 定期轮换密钥
- 监控异常使用
2. 性能优化
- 根据任务选择合适的模型
- 为教育场景使用较低的温度值
- 设置合理的 maxTokens 限制
3. 成本控制
- 监控 API 使用量
- 根据任务复杂度选择模型
- 设置配额警报