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

# LLM

> エージェントの推論を駆動する AI モデルを設定します — システムプロンプト、プロバイダー、パラメーター、ツールの設定。

## LLM の仕組み

すべてのエージェントには、エージェントが話す内容と行動を制御する **LLM モデル**（`llm_id`）があります。エージェントと LLM モデルは別々のリソースなので、1 つの頭脳を複数のエージェントで共有できます — システムプロンプトを 1 回更新すれば、そのモデルを使用しているすべてのエージェントに即座に反映されます。

```
エージェント（ボイス、最初のメッセージ、通話動作）
  └── LLM モデル（システムプロンプト、プロバイダー、モデル、ツール、ナレッジベース）
```

エージェントを作成すると、OneInbox が適切なデフォルト値で LLM モデルを自動的に作成し、その `id` を `llm_id` として返します。

***

## プロバイダー

OneInbox はいくつかの LLM プロバイダーをサポートしています。プラットフォームプロバイダーはすぐに使用できます — 認証情報は不要です。

| プロバイダー        | モデル                                       | 認証情報                                           |
| ------------- | ----------------------------------------- | ---------------------------------------------- |
| **OpenAI**    | `gpt-4o`, `gpt-4o-mini`, `gpt-5`          | 不要 — プラットフォーム提供                                |
| **Shisa**     | `shisa-v2-llama3.3-70b`                   | 不要 — プラットフォーム提供                                |
| **Anthropic** | `claude-sonnet-4-5`, `claude-haiku-4-5`   | 必要 — [インテグレーションを追加](/jp/concepts/integrations) |
| **Groq**      | `llama-3.3-70b-versatile`, `gemma2-9b-it` | 必要 — [インテグレーションを追加](/jp/concepts/integrations) |

***

## システムプロンプトを設定する

システムプロンプトはエージェントのペルソナ、目標、ルールを定義します。エージェントを再構築せずにいつでも更新できます：

```bash theme={null}
curl -X PATCH https://api.oneinbox.ai/v1/models/<llm_id> \
  -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "system_prompt": "You are Aria, a friendly sales rep for Acme Corp. Keep replies under two sentences. When the caller says goodbye, call end_call.",
    "temperature": 0.7
  }'
```

| フィールド           | デフォルト    | 役割                             |
| --------------- | -------- | ------------------------------ |
| `system_prompt` | 汎用アシスタント | エージェントのペルソナ、目標、ルール             |
| `temperature`   | `0.7`    | 創造性。低いほど一貫性が高く、高いほどバリエーションが増える |

***

## プロバイダーまたはモデルを切り替える

別のプロバイダーまたはモデルを使用するには、`provider` と `model` を一緒に指定します：

```bash theme={null}
curl -X PATCH https://api.oneinbox.ai/v1/models/<llm_id> \
  -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "openai",
    "model": "gpt-4o-mini"
  }'
```

Anthropic または Groq の場合は、`credential_id` も渡します：

```bash theme={null}
curl -X PATCH https://api.oneinbox.ai/v1/models/<llm_id> \
  -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "anthropic",
    "model": "claude-haiku-4-5",
    "credential_id": "<crd_abc123>"
  }'
```

Anthropic または Groq の認証情報の追加方法については [インテグレーション](/jp/concepts/integrations) を参照してください。

***

## ツールを接続する

ツールを使うと、通話中にエージェントがアクションを実行できます。ツールはエージェントではなく LLM モデルに接続します：

```bash theme={null}
curl -X PATCH https://api.oneinbox.ai/v1/models/<llm_id> \
  -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "tool_ids": ["<tool_id_1>", "<tool_id_2>"]
  }'
```

これにより `tool_ids` リスト全体が置き換えられます。アクティブにしたいすべてのツール ID を含めてください — リストにないものは切り離されます。

ツールの作成方法については [ツール](/jp/guides/tools) を参照してください。

***

## ナレッジベースを接続する

ナレッジベースを使うと、エージェントがドキュメントや URL から質問に答えられるようになります。ナレッジベースは LLM モデルではなくエージェントに接続します：

```bash theme={null}
curl -X PATCH https://api.oneinbox.ai/v1/agents/<agent_id> \
  -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "kb_ids": ["<kb_id_1>", "<kb_id_2>"]
  }'
```

これにより `kb_ids` リスト全体が置き換えられます。アクティブにしたいすべてのナレッジベース ID を含めてください — リストにないものは切り離されます。

作成と管理方法については [ナレッジベース](/jp/guides/knowledge-bases) を参照してください。

***

## LLM モデルを取得する

```bash theme={null}
curl https://api.oneinbox.ai/v1/models/<llm_id> \
  -H "Authorization: Bearer <api_key>"
```

```json theme={null}
{
  "id": "llm_xyz789",
  "provider": "openai",
  "model": "gpt-4o-mini",
  "system_prompt": "You are Aria...",
  "temperature": 0.7,
  "tool_ids": ["tool_abc123"]
}
```

***

## API リファレンス

[モデル一覧](/api-reference/llm-models/list-llm-models) · [モデル取得](/api-reference/llm-models/get-llm-model) · [モデル更新](/api-reference/llm-models/update-llm-model)