Skip to content

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 密钥

  1. 访问 AskSage 网站
  2. 注册账户并登录
  3. 导航到 API 密钥页面
  4. 生成新的 API 密钥
  5. 将密钥保存到环境变量

使用场景配置

教育辅导

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

故障排除

常见错误

  1. 401 Unauthorized: 检查 API 密钥是否正确
  2. 429 Too Many Requests: 达到速率限制,请稍候重试
  3. 模型不可用: 确认订阅计划支持该模型

调试步骤

  1. 验证 API 密钥格式和有效性
  2. 检查速率限制和配额
  3. 确认模型名称拼写正确
  4. 查看错误日志了解详情

最佳实践

1. 安全性

  • 使用环境变量存储 API 密钥
  • 定期轮换密钥
  • 监控异常使用

2. 性能优化

  • 根据任务选择合适的模型
  • 为教育场景使用较低的温度值
  • 设置合理的 maxTokens 限制

3. 成本控制

  • 监控 API 使用量
  • 根据任务复杂度选择模型
  • 设置配额警报