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

# 事前定義モデルとカスタムモデル

> エージェント用のLLMモデルを設定する - デフォルトモデルを使用するか、独自のAPIキーを持ち込む

EKBは最新で最も人気のあるモデルを提供するだけでなく、"Bring Your Own Keys"（BYOK）機能を使用して独自のカスタムモデルに接続することもできます。これにより、カスタムエージェントを作成し、それらがどのように応答し、割り当てられたタスクを完了するかをテストできるため、ユースケースに最適な結果を生み出すLLMを使用できます。この記事では、利用可能なさまざまなLLMと、独自のカスタムLLMをエージェントに接続する方法を学びます。

エージェントは2種類のモデルを使用できます：

<CardGroup cols={2}>
  <Card title="事前定義モデル" icon="sparkles">
    すべてのユーザーが利用可能な事前設定済みモデル — APIキーは不要です。
  </Card>

  <Card title="カスタムモデル（BYOK）" icon="key">
    独自のAPIキーで設定するモデル — 完全なコスト管理と柔軟性を実現します。
  </Card>
</CardGroup>

## 事前定義モデル

事前定義モデルはデフォルトで利用可能で、APIキーの設定は不要です。これらのモデルはEKBによって管理され、すぐに使用できます。

EKBはOpenAI、Anthropic、Google AIなどの主要AIプロバイダーから幅広いモデルへのアクセスを提供します。利用可能なモデルの完全な一覧は、エージェント設定時にモデルセレクターに表示されます。

### プロバイダー別の利用可能モデル

利用可能なすべてのモデルは、エージェント設定時のモデルセレクタードロップダウンに表示されます。モデルはプロバイダー別に整理され、コスト、機能、利用状況が表示されます。

| モデル                       | プロバイダー    | バージョン                                       | クレジット / 1M入力 | クレジット / 1M出力 | 非推奨化          |
| ------------------------- | --------- | ------------------------------------------- | ------------ | ------------ | ------------- |
| **Haiku 4.5**             | Anthropic | `claude-haiku-4-5-20251001`                 | 1,000        | 5,000        | 2026年10月15日以降 |
| **Sonnet 4.5**            | Anthropic | `claude-sonnet-4-5-20250929`                | 3,000        | 15,000       | 2026年9月29日以降  |
| **Sonnet 4.6**            | Anthropic | `claude-sonnet-4-6`                         | 3,000        | 15,000       | 2027年2月17日以降  |
| **DeepSeek Chat**         | DeepSeek  | `deepseek-chat`                             | 140          | 280          | 2026年7月24日    |
| **Gemini 2.5 Flash**      | Google AI | `gemini-2.5-flash`                          | 300          | 2,500        | 2026年10月16日以降 |
| **Gemini 3.1 Flash-Lite** | Google AI | `gemini-3.1-flash-lite`                     | 250          | 1,500        | N/A           |
| **Gemini 3.5 Flash**      | Google AI | `gemini-3.5-flash`                          | 1,500        | 9,000        | N/A           |
| **Llama 4 Scout**         | Groq      | `meta-llama/llama-4-scout-17b-16e-instruct` | 80           | 300          | N/A           |
| **GPT 4o**                | OpenAI    | `gpt-4o`                                    | 5,000        | 15,000       | N/A           |
| **GPT 4o Mini**           | OpenAI    | `gpt-4o-mini`                               | 150          | 600          | N/A           |
| **GPT 4.1**               | OpenAI    | `gpt-4.1-2025-04-14`                        | 2,000        | 8,000        | N/A           |
| **GPT 4.1 Mini**          | OpenAI    | `gpt-4.1-mini-2025-04-14`                   | 400          | 1,600        | N/A           |
| **GPT 4.1 Nano**          | OpenAI    | `gpt-4.1-nano-2025-04-14`                   | 100          | 400          | N/A           |
| **GPT 5**                 | OpenAI    | `gpt-5`                                     | 1,250        | 10,000       | N/A           |
| **GPT 5 Mini**            | OpenAI    | `gpt-5-mini`                                | 250          | 2,000        | N/A           |
| **GPT 5 Nano**            | OpenAI    | `gpt-5-nano`                                | 50           | 400          | N/A           |
| **GPT 5.1**               | OpenAI    | `gpt-5.1`                                   | 1,000        | 1,000        | N/A           |
| **GPT 5.2**               | OpenAI    | `gpt-5.2`                                   | 2,000        | 15,000       | N/A           |
| **GPT 5.4**               | OpenAI    | `gpt-5.4-2026-03-05`                        | 2,500        | 15,000       | N/A           |
| **GPT 5.4 Mini**          | OpenAI    | `gpt-5.4-mini-2026-03-17`                   | 750          | 4,500        | N/A           |
| **GPT 5.4 Nano**          | OpenAI    | `gpt-5.4-nano-2026-03-17`                   | 200          | 1,250        | N/A           |
| **GPT 5.5**               | OpenAI    | `gpt-5.5`                                   | 5,000        | 30,000       | N/A           |
| **o3 Mini**               | OpenAI    | `o3-mini`                                   | 1,100        | 4,400        | N/A           |

### モデル選択

<Steps>
  <Step title="エージェントに移動">
    サイドバーの**エージェント**に移動します。
  </Step>

  <Step title="エージェントを開く">
    新しいエージェントを作成するか、既存のものを選択します。
  </Step>

  <Step title="一般タブに移動">
    エージェント設定の**一般**タブを開きます。
  </Step>

  <Step title="モデルを選択">
    エージェント名の横にある**モデル**ドロップダウンセレクターを見つけて、ドロップダウンから事前定義モデルを選択します。
  </Step>
</Steps>

### モデル情報

各事前定義モデルには以下が表示されます：

| フィールド      | 説明                                                  |
| ---------- | --------------------------------------------------- |
| **モデル名**   | 表示名（例：「GPT 4o」）                                     |
| **プロバイダー** | APIプロバイダー（OpenAI、Anthropic、Google AI、DeepSeek、Groq） |
| **コスト**    | 1M入力および出力トークンあたりのクレジット                              |
| **非推奨化**   | 暫定の退役または非推奨化日                                       |

## カスタムモデル（BYOK）

Bring Your Own Key（BYOK）により、独自のAPIキーを使用してカスタムモデルを構成できます。これにより以下が可能になります：

<CardGroup cols={2}>
  <Card title="コスト管理" icon="circle-dollar-to-slot">
    自分のAPIキーと請求を使用します。
  </Card>

  <Card title="モデルの柔軟性" icon="sliders">
    事前定義リストにないモデルにアクセスします。
  </Card>

  <Card title="カスタムエンドポイント" icon="link">
    プライベートまたはカスタムモデルエンドポイントに接続します。
  </Card>

  <Card title="プロバイダーの選択" icon="building">
    任意の互換性のあるAPIプロバイダーを使用します。
  </Card>
</CardGroup>

### サポートされているプロバイダー

<AccordionGroup>
  <Accordion title="OpenAI">
    標準のOpenAI APIモデル、Azure OpenAIエンドポイント、カスタムOpenAI互換エンドポイントをサポートします。

    | フィールド       | 値                                  |
    | ----------- | ---------------------------------- |
    | **APIキー**   | ご自身のOpenAI APIキー                   |
    | **API URL** | `https://api.openai.com/v1`（デフォルト） |
    | **モデル名**    | 例：`gpt-4`、`gpt-3.5-turbo`          |
  </Accordion>

  <Accordion title="Anthropic">
    Anthropic APIおよびカスタムAnthropic互換エンドポイント経由のClaudeモデルをサポートします。

    | フィールド       | 値                                  |
    | ----------- | ---------------------------------- |
    | **APIキー**   | ご自身のAnthropic APIキー                |
    | **API URL** | `https://api.anthropic.com`（デフォルト） |
    | **モデル名**    | 例：`claude-sonnet-4-6`              |
  </Accordion>

  <Accordion title="Google AI">
    Google AI APIおよびカスタムGoogle AIエンドポイント経由のGeminiモデルをサポートします。

    | フィールド       | 値                                                   |
    | ----------- | --------------------------------------------------- |
    | **APIキー**   | ご自身のGoogle AI APIキー                                 |
    | **API URL** | `https://generativelanguage.googleapis.com/`（デフォルト） |
    | **モデル名**    | 例：`gemini-2.5-flash`                                |
  </Accordion>

  <Accordion title="OpenRouter">
    統合APIを通じて複数のモデルプロバイダーへのアクセスを提供し、さまざまなモデルに対応します。

    | フィールド       | 値                      |
    | ----------- | ---------------------- |
    | **APIキー**   | ご自身のOpenRouter APIキー   |
    | **API URL** | OpenRouterエンドポイント      |
    | **モデル名**    | OpenRouterで利用可能な任意のモデル |
  </Accordion>

  <Accordion title="AWS Bedrock">
    Amazon Bedrockモデルとさまざまな基盤モデルをサポートします。

    | フィールド       | 値              |
    | ----------- | -------------- |
    | **AWS認証情報** | 別途設定           |
    | **API URL** | Bedrockエンドポイント |
    | **モデル名**    | Bedrockモデル識別子  |
  </Accordion>

  <Accordion title="カスタムエンドポイント">
    プライベートデプロイメントやセルフホストモデルを含む、すべてのOpenAI互換APIエンドポイントをサポートします。

    | フィールド       | 値                |
    | ----------- | ---------------- |
    | **APIキー**   | カスタムAPIキー（必要な場合） |
    | **API URL** | カスタムエンドポイントURL   |
    | **モデル名**    | モデル識別子           |
  </Accordion>
</AccordionGroup>

## カスタムモデルの追加

<Steps>
  <Step title="エージェントに移動">
    サイドバーの**エージェント**に移動します。
  </Step>

  <Step title="エージェントを開く">
    新しいエージェントを作成するか、編集する既存のエージェントを選択します。
  </Step>

  <Step title="設定タブに移動">
    エージェント設定の**設定**タブを開きます。
  </Step>

  <Step title="カスタムモデルを開く">
    **カスタムモデル**セクションまでスクロールし、**+モデルを追加**をクリックします。
  </Step>

  <Step title="モデルの詳細を入力">
    モデル設定モーダルが開きます。以下を入力します：

    | フィールド         | 説明                                                                                 |
    | ------------- | ---------------------------------------------------------------------------------- |
    | **モデル名**      | APIで認識される正確なモデル名（例：`gpt-4`、`claude-sonnet-4-6`）                                    |
    | **モデルプロバイダー** | ドロップダウンからプロバイダーを選択（OpenAI、Anthropic、Azure、Google AI、OpenRouter、AWS Bedrock、カスタムなど） |
    | **APIキー**     | 選択したプロバイダーのAPIキー。安全に保存されます。                                                        |
    | **API URL**   | APIエンドポイントURL                                                                      |
    | **タイムアウト**    | APIリクエストのタイムアウト。デフォルトは300秒です。長時間実行の推論モデルの場合は増やしてください。                              |
    | **最大入力トークン**  | 最大入力トークン。デフォルトは3000です。モデルの機能に応じて調整してください。                                          |
    | **最大応答トークン**  | 最大応答トークン。デフォルトは1000です。ニーズとモデルの制限に応じて調整してください。                                      |
  </Step>

  <Step title="モデルを作成">
    **作成**をクリックします。EKBがAPI接続とモデル設定を検証します。成功した場合、モデルが保存され、エージェントで使用可能になります。
  </Step>
</Steps>

## カスタムモデルの使用

### カスタムモデルの選択

<Steps>
  <Step title="一般タブを開く">
    エージェントエディタで**一般**タブに移動し、**モデル**セクションを見つけてください。
  </Step>

  <Step title="カスタムモデルを選択">
    ドロップダウンには事前定義モデルとカスタムモデルの両方が表示されます。カスタムモデルにはマーカーが付いているか、別のセクションに表示されます。カスタムモデルを選択してください。
  </Step>
</Steps>

<Note>
  カスタムモデルは**プロジェクト固有**です。プロジェクト内のすべてのエージェントが利用でき、各プロジェクトは独自のカスタムモデルセットを持つことができます。
</Note>

## カスタムモデルの管理

<AccordionGroup>
  <Accordion title="カスタムモデルの表示">
    1. **エージェント** → **エージェントを編集** → **一般**タブに移動します。
    2. AIモデルセクションの**カスタム**タブをクリックします。
    3. すべてのカスタムモデルが一覧表示されます。
  </Accordion>

  <Accordion title="カスタムモデルの編集">
    1. カスタムモデルリストでモデルを見つけてください。
    2. **編集**アイコン（3点メニュー）をクリックします。
    3. 設定を変更します。
    4. **保存**をクリックして更新します。

    <Warning>
      APIキーを編集すると既存のキーが置き換えられます。保存前に正しいキーがあることを確認してください。
    </Warning>
  </Accordion>

  <Accordion title="カスタムモデルの削除">
    1. カスタムモデルリストでモデルを見つけてください。
    2. **削除**アイコン（3点メニュー）をクリックします。
    3. 削除を確認します。
    4. モデルがプロジェクトから削除されます。

    <Warning>
      カスタムモデルを削除すると、そのモデルを使用しているすべてのエージェントに影響します。先にそれらのエージェントを更新してください。
    </Warning>
  </Accordion>
</AccordionGroup>

## モデル設定例

<CodeGroup>
  ```json OpenAI Custom Model theme={null}
  {
    "model_name": "My GPT-4",
    "version": "gpt-4",
    "api_provider": "openai",
    "api_type": "openai",
    "api_key": "sk-...",
    "api_url": "https://api.openai.com/v1",
    "max_input_tokens": 60000,
    "max_response_tokens": 4096
  }
  ```

  ```json Azure OpenAI theme={null}
  {
    "model_name": "Azure GPT-4",
    "version": "gpt-4",
    "api_provider": "openai",
    "api_type": "azure",
    "api_key": "your-azure-key",
    "api_url": "https://your-resource.openai.azure.com",
    "api_version": "2024-12-01-preview",
    "max_input_tokens": 60000,
    "max_response_tokens": 4096
  }
  ```

  ```json Anthropic Claude theme={null}
  {
    "model_name": "Company Claude",
    "version": "claude-sonnet-4-6",
    "api_provider": "anthropic",
    "api_type": "anthropic",
    "api_key": "sk-ant-...",
    "api_url": "https://api.anthropic.com",
    "max_input_tokens": 60000,
    "max_response_tokens": 4000
  }
  ```

  ```json Custom Endpoint theme={null}
  {
    "model_name": "Private Model",
    "version": "custom-model-v1",
    "api_provider": "custom",
    "api_type": "custom",
    "api_key": "your-custom-key",
    "api_url": "https://your-custom-endpoint.com/v1",
    "max_input_tokens": 100000,
    "max_response_tokens": 8000,
    "auth_header_template": "{\"Authorization\": \"Bearer <API_KEY>\"}"
  }
  ```
</CodeGroup>

## ベストプラクティス

<AccordionGroup>
  <Accordion title="APIキーセキュリティ">
    * **鍵を共有しない** - APIキーを機密に保持してください
    * **環境変数を使用** - 開発時は安全なストレージを使用してください
    * **定期的に鍵を更新** - 定期的にキーを更新してください
    * **使用量を監視** - API使用量を追跡して問題を検出してください
  </Accordion>

  <Accordion title="モデル選択">
    * **ユースケースに適合** - タスクに適したモデルを選択してください
    * **コストを考慮** - パフォーマンスとコストのバランスを取ってください
    * **パフォーマンスをテスト** - ニーズに対するモデル品質を評価してください
    * **制限を監視** - トークン制限とクォータに注意してください
  </Accordion>

  <Accordion title="設定">
    * **正確なモデル名** - 正確なモデル識別子を使用してください
    * **正しいURL** - APIエンドポイントURLを確認してください
    * **適切な制限** - 現実的なトークン制限を設定してください
    * **接続をテスト** - モデルの接続を確認してください
  </Accordion>

  <Accordion title="コスト管理">
    * **使用量を追跡** - API使用量とコストを監視してください
    * **予算を設定** - 利用可能な場合は支出制限を構成してください
    * **トークンを最適化** - 適切なトークン制限を使用してください
    * **定期的に見直し** - 定期的にモデル使用量を監査してください
  </Accordion>
</AccordionGroup>

## トラブルシューティング

<AccordionGroup>
  <Accordion title="モデルが利用できない — カスタムモデルがドロップダウンに表示されない">
    **考えられる原因：**

    * モデルが正しく保存されていない
    * APIキーが無効
    * モデル設定エラー

    **解決策：**

    * モデルが正常に保存されたことを確認
    * APIキーが正しいことを確認
    * モデル設定を確認
    * ページをリフレッシュ
  </Accordion>

  <Accordion title="APIキーエラー — 無効なAPIキーまたは認証エラー">
    **考えられる原因：**

    * 不正なAPIキー
    * 期限切れのAPIキー
    * 間違ったAPIプロバイダーが選択されている
    * キーに必要な権限がない

    **解決策：**

    * APIキーが正しいことを確認
    * キーが期限切れでないことを確認
    * 正しいプロバイダーが選択されていることを確認
    * キーに必要な権限があることを確認
  </Accordion>

  <Accordion title="接続障害 — モデルエンドポイントに接続できない">
    **考えられる原因：**

    * 不正なAPI URL
    * ネットワーク接続の問題
    * エンドポイントにアクセスできない
    * ファイアウォールが接続をブロック

    **解決策：**

    * API URLが正しいことを確認
    * ネットワーク接続を確認
    * エンドポイントにアクセスできることを確認
    * ファイアウォールルールを確認
  </Accordion>

  <Accordion title="トークン制限エラー — トークン制限を超過">
    **考えられる原因：**

    * 入力が長すぎる
    * 応答制限が高すぎる
    * モデルの制限を超過

    **解決策：**

    * 入力長を短縮
    * 最大応答トークンを下げる
    * モデルの実際の制限を確認
    * 大きな入力を分割
  </Accordion>
</AccordionGroup>

## モデル互換性

<Warning>
  ナレッジベースv2を使用する場合、**OpenAI**（openai、azure）および**Anthropic**モデルのみがサポートされます。他のプロバイダーはナレッジベースv2と互換性がありません。
</Warning>

異なるモデルは異なる機能をサポートします：

| 機能             | サポートされているモデル                            |
| -------------- | --------------------------------------- |
| **ストリーミング**    | ほとんどのモデル                                |
| **ファンクションコール** | OpenAIおよびAnthropicモデル                   |
| **ビジョン**       | GPT-4o、Claude 4 Sonnet、Gemini 2.5 Flash |
| **長コンテキスト**    | Claude Sonnet 4.6、GPT 4.1               |

## APIキー管理

### APIキーの取得

<AccordionGroup>
  <Accordion title="OpenAI">
    1. [OpenAI Platform](https://platform.openai.com)にアクセスします。
    2. **API Keys**に移動します。
    3. 新しいシークレットキーを作成します。
    4. キーをコピーします（`sk-`で始まります）。
  </Accordion>

  <Accordion title="Anthropic">
    1. [Anthropic Console](https://console.anthropic.com)にアクセスします。
    2. **API Keys**に移動します。
    3. 新しいキーを作成します。
    4. キーをコピーします（`sk-ant-`で始まります）。
  </Accordion>

  <Accordion title="Google AI">
    1. [Google AI Studio](https://makersuite.google.com/app/apikey)にアクセスします。
    2. 新しいAPIキーを作成します。
    3. キーをコピーします。
  </Accordion>

  <Accordion title="OpenRouter">
    1. [OpenRouter](https://openrouter.ai)にアクセスします。
    2. **Keys**に移動します。
    3. 新しいキーを作成します。
    4. キーをコピーします。
  </Accordion>
</AccordionGroup>

### キーセキュリティ

* **安全に保存** - キーはデータベースで暗号化されます
* **共有しない** - APIキーを決して共有しないでください
* **定期的に更新** - 定期的にキーを更新してください
* **使用量を監視** - 不正使用に注意してください

## コストに関する考慮事項

<CardGroup cols={2}>
  <Card title="事前定義モデル" icon="sparkles">
    * コストはEKBが管理
    * EKBサブスクリプションを通じて請求
    * クレジットベースの価格設定
    * 透明性のある価格モデル
  </Card>

  <Card title="カスタムモデル（BYOK）" icon="key">
    * プロバイダーに直接支払い
    * 追加のEKB料金なし
    * コストの完全な管理
    * プロバイダーからの直接請求
  </Card>
</CardGroup>

**コスト最適化のヒント：**

* **適切なモデルを選択** - タスクに適したモデルを使用してください。
* **プロンプトを最適化** - 可能な限りトークン使用量を削減してください。
* **制限を設定** - 最大トークンを適切に構成してください。
* **使用量を監視** - 定期的にAPI使用量を追跡してください。