adding-models

添加模型

本技能将指导你如何向 Letta Code 添加新的 LLM 模型。

快速参考

关键文件：

• src/models.json - 模型定义（必需）
• .github/workflows/ci.yml - CI 测试矩阵（可选）
• src/tools/manager.ts - 工具集检测逻辑（很少需要修改）

工作流

步骤 1：查找有效的模型句柄

查询 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/ - Claude 模型
• openai/ - GPT 模型
• google_ai/ - Gemini 模型
• google_vertex/ - Vertex AI
• openrouter/ - 各种提供商

步骤 2：添加到 models.json

向 src/models.json 添加一个条目：

{
  "id": "model-shortname",
  "handle": "provider/model-name",
  "label": "Human Readable Name",
  "description": "Brief description of the model",
  "isFeatured": true,  // Optional: shows in featured list
  "updateArgs": {
    "context_window": 180000,
    "temperature": 1.0  // Optional: provider-specific settings
  }
}

字段参考：

• id：与 --model 标志搭配使用的简短标识符（例如，gemini-3-flash）
• handle：API 提供的完整提供商/模型路径（例如，google_ai/gemini-3-flash-preview）
• label：模型选择器中显示的名称
• description：模型选择器中显示的简短说明
• isFeatured：如果为 true，则显示在精选模型部分
• updateArgs：模型专属配置（上下文窗口、温度、推理设置等）

提供商前缀：

• anthropic/ - Anthropic（Claude 模型）
• openai/ - OpenAI（GPT 模型）
• google_ai/ - Google AI（Gemini 模型）
• google_vertex/ - Google Vertex AI
• openrouter/ - OpenRouter（各种提供商）

步骤 3：测试模型

使用无头模式进行测试：

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?"

步骤 4：添加到 CI 测试矩阵（可选）

若要将模型纳入自动化测试，请将其添加到 .github/workflows/ci.yml：

# Find the headless job matrix around line 122
model: [gpt-5-minimal, gpt-4.1, sonnet-4.5, gemini-pro, your-new-model, glm-4.6, haiku]

工具集检测

系统会根据提供商自动为模型分配工具集：

• openai/* → codex 工具集
• google_ai/* 或 google_vertex/* → gemini 工具集
• 其他 → default 工具集

此逻辑由 src/tools/manager.ts 中的 isGeminiModel() 和 isOpenAIModel() 处理。通常无需修改，除非要添加新的提供商。

常见问题

“未找到句柄”错误：模型句柄不正确。运行验证脚本以查看有效的句柄。

模型可用，但工具集不正确：检查 src/tools/manager.ts，确保已识别该提供商前缀。