SuperAPI AI 工具集

provider-integration

智能体与模型

查看项目

更新于 10-15 22:12

技能介绍

用途:为 claude-council 添加新的 AI 提供商,配置提供商 API 设置,排查提供商连接问题,并记录提供商脚本接口。

提供商脚本接口:每个提供商是 scripts/providers/ 下的一个 shell 脚本,需接受提示词作为第一个参数,将 AI 响应输出到 stdout,成功退出码为 0,失败为非 0。

快速开始:创建 scripts/providers/{name}.sh(模板见 api-patterns.md);执行 chmod +x scripts/providers/{name}.sh;设置 {NAME}_API_KEY 环境变量;测试:./scripts/providers/{name}.sh "Hello"。

当前提供商及对应密钥变量与默认模型:Gemini 用 GEMINI_API_KEY,默认 gemini-flash-latest;OpenAI 用 OPENAI_API_KEY,默认 gpt-6-astra;Grok 用 XAI_API_KEY(或 GROK_API_KEY),默认 grok-latest;Perplexity 用 PERPLEXITY_API_KEY,默认 sonar-reasoning-pro;Kimi 用 KIMI_API_KEY,默认 kimi-k3;Ollama 无需密钥(本地),默认取 ollama list 显示的第一个模型;OpenRouter 用 OPENROUTER_API_KEY,默认 anthropic/claude-fable-5.1(或按 OPENROUTER_MODELS 每项一个席位)。

CLI 提供商(codex、antigravity、grok-cli、kimi-cli、cursor-cli)无需密钥:当其二进制文件在 PATH 中时会被发现,并使用该 CLI 自身的登录。无头运行模式可参考 scripts/providers/kimi-cli.sh 与 cursor-cli.sh:只读模式、从 JSON 输出格式中解析答案、仅在显式 *_CLI_MODEL 覆盖时使用 --model,并以 run_with_deadline 替代 API 提供商的 retry。

排错:未被发现时检查 API 密钥是否设置、脚本是否可执行;API 错误时验证密钥、检查速率限制、确认模型名;解析失败时添加 echo "$RESPONSE" 调试并检查响应格式。

参考:API 模式与代码模板见该目录下的 api-patterns.md。