mcpField
A
adding-models

adding-models

github.com/letta-ai開発3.7k64 回インストール今日更新
リポジトリ

adding-models について

adding-models は、プロジェクトに LLM モデルを追加する手順を案内する Letta Code スキルです。モデルハンドルの確認、models.json の設定、テスト、任意の CI 更新を扱います。

主な機能

  1. 01有効なモデルハンドルの確認
  2. 02models.json へのモデル定義の追加
  3. 03ヘッドレスモードでのモデルテスト
  4. 04必要に応じた CI テストマトリックスの更新

活用シーン

  1. 01Letta Code へのプロバイダーモデルの追加
  2. 02モデル表示と引数の設定
  3. 03ヘッドレス実行によるモデルの確認
  4. 04モデルの自動テストへの追加

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/letta-ai/letta-code --skill adding-models

インストール後、Claude Code で/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：モデル固有の設定（コンテキストウィンドウ、temperature、推論設定など）

プロバイダープレフィックス：

  • 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() で処理されます。新しいプロバイダーを追加する場合を除き、通常は変更する必要はありません。

よくある問題

「Handle not found」エラー：モデルハンドルが正しくありません。有効なハンドルを確認するには、検証スクリプトを実行してください。

モデルは動作するが、ツールセットが違う：プロバイダープレフィックスが認識されるように、src/tools/manager.ts を確認してください。

コメント

Markdown 対応