メインコンテンツへスキップ

​
LLM の仕組み

すべてのエージェントには、エージェントが話す内容と行動を制御する LLM モデル（llm_id）があります。エージェントと LLM モデルは別々のリソースなので、1 つの頭脳を複数のエージェントで共有できます — システムプロンプトを 1 回更新すれば、そのモデルを使用しているすべてのエージェントに即座に反映されます。 
エージェント（ボイス、最初のメッセージ、通話動作）
  └── LLM モデル（システムプロンプト、プロバイダー、モデル、ツール、ナレッジベース）
エージェントを作成すると、OneInbox が適切なデフォルト値で LLM モデルを自動的に作成し、その id を llm_id として返します。

​
プロバイダー

OneInbox はいくつかの LLM プロバイダーをサポートしています。プラットフォームプロバイダーはすぐに使用できます — 認証情報は不要です。
プロバイダーモデル認証情報
OpenAIgpt-4o, gpt-4o-mini, gpt-5不要 — プラットフォーム提供
Shisashisa-v2-llama3.3-70b不要 — プラットフォーム提供
Anthropicclaude-sonnet-4-5, claude-haiku-4-5必要 — インテグレーションを追加
Groqllama-3.3-70b-versatile, gemma2-9b-it必要 — インテグレーションを追加

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

システムプロンプトはエージェントのペルソナ、目標、ルールを定義します。エージェントを再構築せずにいつでも更新できます： 
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汎用アシスタントエージェントのペルソナ、目標、ルール
temperature0.7創造性。低いほど一貫性が高く、高いほどバリエーションが増える

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

別のプロバイダーまたはモデルを使用するには、provider と model を一緒に指定します： 
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 も渡します： 
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 の認証情報の追加方法については インテグレーション を参照してください。

​
ツールを接続する

ツールを使うと、通話中にエージェントがアクションを実行できます。ツールはエージェントではなく LLM モデルに接続します： 
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 を含めてください — リストにないものは切り離されます。 ツールの作成方法については ツール を参照してください。

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

ナレッジベースを使うと、エージェントがドキュメントや URL から質問に答えられるようになります。ナレッジベースは LLM モデルではなくエージェントに接続します： 
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 を含めてください — リストにないものは切り離されます。 作成と管理方法については ナレッジベース を参照してください。

​
LLM モデルを取得する

curl https://api.oneinbox.ai/v1/models/<llm_id> \
  -H "Authorization: Bearer <api_key>"

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

​
API リファレンス

モデル一覧 · モデル取得 · モデル更新