PPAgent 文档

Appearance

讯飞星火 ​

讯飞星火是科大讯飞推出的大型语言模型，提供了多个不同性能和参数规模的版本，可以通过OpenAI兼容接口进行使用。

特点 ​

  • 提供多个不同级别的模型版本：从轻量级的Spark Lite到大规模的Spark4.0 Ultra
  • 基于OpenAI兼容接口扩展实现，支持标准的OpenAI调用方式
  • 支持纯文本模式，适合问答、对话等文本交互场景
  • 可配置自定义API基础URL，方便接入第三方代理

使用代码配置 ​

您可以通过以下方式配置讯飞星火模型：

typescript
const ppagent = new PPAgent({
  bots: [
    {
      name: "xunfei-bot",
      options: {
        instanceName: "xunfei-bot-instance", // 实例名称，需全局唯一
        apiKey: "您的API密钥", // 必填，讯飞接口认证密钥
        apiBase: "https://spark-api-open.xf-yun.com/v1", // 可选，服务URL，使用官方服务可留空
        modelName: "lite", // 必填，模型名称，默认为"lite"
        chatOptions: {
          // 可选，除模型名称外的其他对话配置
          temperature: 0.7,
          // 其他参数...
        }
      }
    }
  ],
  source: {
    // ... 消息源配置 ...
  },
  agents: {
    // ... 智能体配置 ...
  }
})

配置项说明 ​

  • instanceName: 实例名称，需要全局唯一
  • apiKey: 必填，讯飞接口认证密钥
  • apiBase: 可选，服务URL，使用科大讯飞官方服务可留空，默认为"https://spark-api-open.xf-yun.com/v1"
  • modelName: 必填，模型名称，可选值：
    • lite - Spark Lite (默认)
    • generalv3 - Spark Pro
    • pro-128k - Spark Pro-128K
    • generalv3.5 - Spark Max
    • max-32k - Spark Max-32K
    • 4.0Ultra - Spark4.0 Ultra
  • chatOptions: 可选，除模型名称之外的其他对话配置，参考讯飞官网文档

服务器运行请参考 install_code 文件。

注意事项 ​

  • 无论是否在chatOptions中指定model，系统都会优先使用modelName配置项的值
  • 该模型被设置为纯文本模型(onlyText: true)，不支持多模态输入
  • 使用前请确保您已在讯飞开放平台获取了有效的API密钥
  • 如需使用第三方代理，请在apiBase中指定完整的OpenAI兼容接口URL