SuperAPI AI 工具集

adding-models

编程与开发

查看项目

更新于 10-16 06:23

技能介绍

用途:该技能用于指导向 Letta Code 添加新的 LLM 模型,适合用户想新增模型支持、查询有效的模型 handle 或更新模型配置的场景。

关键文件:src/models.json 为模型定义文件(必需);.github/workflows/ci.yml 为 CI 测试矩阵(可选);src/tools/manager.ts 为工具集检测逻辑(通常无需改动)。

使用流程:

第一步,查找有效模型 handle。调用 Letta API 查看可用模型:curl -s https://api.letta.com/v1/models/ | jq '.[] | .handle'。也可按提供商过滤,例如:curl -s https://api.letta.com/v1/models/ | jq '.[] | select(.handle | startswith("google_ai/")) | .handle'。常见提供商前缀有 anthropic/、openai/、google_ai/、google_vertex/、openrouter/。

第二步,在 src/models.json 中添加条目。字段包括:id(配合 --model 使用的短标识)、handle(来自 API 的完整 provider/model 路径)、label(选择器中显示名)、description(简要说明)、isFeatured(可选,为 true 时出现在推荐列表)、updateArgs(模型专属配置,如 context_window、temperature 等)。

第三步,测试模型:bun run src/index.ts --new --model <model-id> -p "hi, what model are you?"。示例:bun run src/index.ts --new --model gemini-3-flash -p "hi, what model are you?"。

第四步(可选),将模型加入 .github/workflows/ci.yml 的 headless 任务矩阵,位置约在第 122 行附近。

工具集检测:模型会按提供商自动分配工具集,openai/* 使用 codex,google_ai/* 或 google_vertex/* 使用 gemini,其余使用 default,由 src/tools/manager.ts 中的 isGeminiModel() 与 isOpenAIModel() 处理,通常无需修改,除非新增提供商。

常见问题:出现 "Handle not found" 说明 handle 不正确,可运行校验脚本查看有效 handle;模型可用但工具集不对,检查 src/tools/manager.ts 是否识别该提供商前缀。