> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent 連携

> AIHubMix が AI Agent 向けに提供するすべての連携エントリ：agents.md 連携ガイド、llms.txt 機械可読インデックス、モデル別 llms.txt 呼び出しガイド、Playground Skill、Playground ディープリンク。各項目にコピーして使えるコマンドを 1 つずつ用意しています。

AIHubMix は、AI Agent（Claude Code、Codex、Cursor、Cline などのコーディングアシスタント）向けに、機械可読な連携エントリを提供しています。Agent はモデルの発見、呼び出しコードの生成、疎通確認、設定済み Playground リンクの受け渡しまでを自律的に完了できます。本ページではすべてのエントリをまとめ、各項目にコピーして使えるコマンドを 1 つずつ用意しています。

## ひとことで始める

次の一文を、お使いの AI Agent に送信してください：

```text theme={null}
Fetch https://aihubmix.com/agents.md and follow it.
```

`agents.md` は Agent が直接実行できる形式で書かれた連携ガイドです。API Key の確認、リアルタイムカタログからのモデル選択、プロトコルに応じた呼び出し、エンドツーエンドの検証までを含み、トラブルシューティング表も収録しています。

## エントリ一覧

| エントリ             | アドレス                                                        | 用途                                                                    |
| ---------------- | ----------------------------------------------------------- | --------------------------------------------------------------------- |
| Agent 連携ガイド      | `https://aihubmix.com/agents.md`                            | Agent が連携と検証を自律的に完了するためのステップバイステップガイド                                 |
| サイト機械可読インデックス    | `https://aihubmix.com/llms.txt`                             | サイト全体の機能とドキュメントを収録した LLM 可読インデックス                                     |
| ドキュメント機械可読インデックス | `https://docs.aihubmix.com/llms.txt`                        | ドキュメントサイト全ページのインデックス。任意のドキュメントページの URL 末尾に `.md` を付けるとプレーンテキストを取得できます |
| モデル別呼び出しガイド      | `https://aihubmix.com/model/{model_id}/llms.txt`            | 個別モデルの価格、検証済み機能、プロトコルエンドポイント、実行可能なサンプル                                |
| Playground Skill | `https://aihubmix.com/skills/playground`                    | モデルの試用、パラメータ調整、比較、メディア生成のための Agent スキルファイル                            |
| リアルタイムモデルカタログ    | `https://aihubmix.com/api/v1/models?type=llm&sort_by=order` | 認証不要の JSON。価格とメタデータを含みます                                              |

## モデル別 llms.txt

各モデルには、価格、検証済みの機能一覧、対応プロトコルエンドポイント、実行可能なサンプルを含む機械可読な呼び出しガイドが用意されています：

```bash theme={null}
curl -s https://aihubmix.com/model/gemini-3.7-flash/llms.txt
```

モデル詳細ページの `llms.txt` タブから対応ファイルを直接開けます。検証が完了していないモデルの場合は、リアルタイムカタログとパラメータ schema を案内するガイドドキュメントが返され、未検証の機能に関する記述は含まれません。

## Playground Skill

Playground の機能（モデル試用、パラメータ調整、同一プロンプトでの比較、画像・動画生成、ディープリンクの受け渡し）を Agent に渡せます：

```text theme={null}
Run curl -fsSL https://aihubmix.com/skills/playground and follow it.
```

Skill は `/.well-known/skills/aihubmix-playground/SKILL.md` でも公開されており、[GitHub リポジトリ](https://github.com/AIhubmix/skills) から `npx skills add AIhubmix/skills` でインストールすることもできます。API 連携やインテグレーションの用途には [AIHubMix API Skill](/jp/skills) をご利用ください。

## Playground ディープリンク

Agent は直接アクセスできるリンクを生成でき、ユーザーはブラウザで設定済みの Playground セッションをそのまま引き継げます：

* 複数モデル比較：`https://playground.aihubmix.com/?models=gemini-3.7-flash,claude-opus-4-1`（最大 6 件）
* 設定の直接受け渡し：`https://playground.aihubmix.com/?config=<base64url エンコードされた JSON>`。JSON の形式は `{"model": "...", "proto": "chat", "params": {...}, "system": "...", "draft": "..."}` で、`draft` は入力欄に事前入力されますが送信はされません

リンクのパラメータはワンタイムです。ページ読み込み後にアドレスバーのパラメータは消去され、いかなるキーも含まれません。

## コード生成

npm パッケージ [`@aihubmix/codegen`](https://www.npmjs.com/package/@aihubmix/codegen) は、4 プロトコル・7 言語のプログラマティックなコード生成を提供し、構築されるリクエストボディは Playground が実際に送信するものと一致します。[`@aihubmix/model-schema`](https://www.npmjs.com/package/@aihubmix/model-schema) はパラメータ schema を codegen の入力形式に変換します。

## よくある質問

### Agent はどうやって連携の成功を検証しますか？

`agents.md` にはエンドツーエンドの検証手順が含まれています。厳密な応答を要求する最小リクエストを送信し、レスポンス本文とモデルのエコーを確認します。HTTP 200 は成功と同義ではなく、レスポンス内容の確認が必要です。

### 呼び出しに必要な認証情報は何ですか？

AIHubMix API Key が 1 つ必要です。環境変数 `AIHUBMIX_API_KEY` で渡し、[コンソール](https://console.aihubmix.com/token) で作成できます。Key をコード、スクリプト、会話に書き込まないでください。

### モデル別 llms.txt はどのモデルをカバーしていますか？

検証済みモデルには完全なドキュメント（機能一覧は公式の検証データに基づく）が返され、それ以外のモデルにはガイドドキュメントが返されます。カバー範囲は検証の進行に伴って拡大します。

### MCP への対応状況はどうなっていますか？

MCP エンドポイントは現在、画像生成サービスを提供しており、機能拡張を進めています。現段階では Skill と agents.md による連携を優先することをおすすめします。

***

更新日：2026-08-20
