翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# AI プロンプトと AI エージェントのアップグレードモデル
<a name="upgrade-models-ai-prompts-agents"></a>

Amazon Connect で AI プロンプトまたは AI エージェントをカスタマイズすると、各 AI プロンプトに関連付けられたモデルによって、どの大規模言語モデル (LLM) が指示を処理するかが決まります。時間の経過とともに、より新しく、より機能的なモデルが利用可能になります。このトピックでは、いくつかの一般的なシナリオでモデルをアップグレードする方法について説明します。
+ 非推奨モデルを使用する 1 つ以上のカスタム AI プロンプトを持つカスタム AI エージェントがある
+ プロンプトオーバーライドのないカスタム AI エージェントがある
+ 古いバージョンのシステム AI エージェントを使用している。

## 前提条件
<a name="upgrade-models-prerequisites"></a>

モデルをアップグレードする前に、以下があることを確認してください。
+ AI エージェントデザイナーが有効になっている Amazon Connect インスタンス。
+ 管理者アカウント、またはセキュリティプロファイルで AI エージェントデザイナーのアクセス許可を持つアカウント。
+ [AI プロンプト](create-ai-prompts.md)、[AI エージェント](create-ai-agents.md)、[デフォルトのシステム AI プロンプトとエージェント](default-ai-system.md)に精通していること。

## アップグレードのタイミング
<a name="upgrade-models-when-to-upgrade"></a>

Amazon Connect は、モデルの非推奨がスケジュールされたときに通知します。Amazon Connect は、モデルが廃止日を過ぎると、LLM 推論をサポートされているモデルに自動的にリダイレクトするため、サービスの中断はありません。ただし、非推奨日より前に手動でアップグレードすると、置き換えモデルを選択して環境でテストできます。以下のステップを使用して、どのシナリオが自分に適用されるかを判断します。

**ステップ 1: カスタム AI エージェントを確認します。**管理ウェブサイトで、*AI エージェントデザイナー*、*AI エージェント*に移動します。Type **列を確認します。システムエージェントは *- タイプ名の*後にシステムを表示します (例：「Answer Recommendation - System」）。このサフィックスのないエージェントは、作成したカスタムエージェントです。
+ 1 つ以上のカスタム AI プロンプトが割り当てられているカスタム AI エージェントがある場合 → シナリオ 1 (一部のプロンプトタイプのみを上書きすると、未設定のプロンプトは自動的にアップグレードされます。カスタムプロンプトをアップグレードするだけで済みます)
+ プロンプトオーバーライドのないカスタム AI エージェントがある場合 → シナリオ 2 (自動アップグレードをプロンプトします。アクションは必要ありません)
+ カスタム AI エージェントがない場合は、ステップ 2 に進みます。

**ステップ 2: デフォルトの AI エージェント設定を確認します。**同じ *AI エージェント*ページで、「デフォルトの *AI エージェント設定*」セクションまでスクロールします。ユースケースが特定のバージョンに固定されている (*最新*に設定されていない) 場合は、シナリオ 3 に更新できます。これは、カスタムエージェントがない場合でも、すべてのお客様に適用されます。

## モデル解決の仕組み
<a name="upgrade-models-how-model-resolution-works"></a>

個々の AI エージェントを設定する場合、Connect が各プロンプトに使用する LLM を選択したり、各プロンプトで使用するモデルを選択したり、2 つのオプションの組み合わせを選択したりできます。
+ 各 AI プロンプトには、使用する LLM を指定するモデルプロパティがあります。
+ 各 AI エージェントは、1 つ以上の AI プロンプトバージョンを参照します。バージョンは、モデルの選択を含むプロンプトのイミュータブルなスナップショットです。
+ カスタム AI エージェントを作成し、エージェントに関連付けられたプロンプトの一部のみを上書きすると、残りのタイプは実行時にシステムのデフォルトから入力されます。明示的に設定したプロンプトは、選択したバージョンに固定されます。システムによって入力されるプロンプトは、最新のシステムデフォルトを使用します。このper-prompt-type解決は、回答レコメンデーション、手動検索、非エージェントセルフサービスなどの非エージェント AI エージェントタイプに適用されます。
+ 使用可能なモデルは、Amazon Connect インスタンスの AWS リージョンによって異なります。リージョンごとにサポートされているモデルのリストについては、「」を参照してください[システム/カスタムプロンプトでサポートされているモデル](create-ai-prompts.md#cli-create-aiprompt)。

## シナリオ 1: カスタム AI プロンプトを使用したカスタム AI エージェント
<a name="upgrade-models-scenario-1"></a>

このシナリオでは、カスタム AI エージェントを作成し、1 つ以上のカスタム AI プロンプトを割り当てました。カスタムプロンプトは、公開時に選択したモデルに固定されます。

カスタムプロンプトは、モデルのアップグレードを自動的に受信しません。モデルを手動で更新し、新しいプロンプトバージョンを発行して、AI エージェントを更新する必要があります。

### 一部のプロンプトタイプのみを上書きする場合
<a name="upgrade-models-scenario-1-partial-overrides"></a>

一部の AI エージェントタイプは、複数のプロンプトタイプをサポートしています。たとえば、回答レコメンデーション AI エージェントは、インテントのラベル付け生成、クエリの再生成、回答生成の 3 つのプロンプトタイプをサポートしています。これらの一部のみをカスタムプロンプトに設定し、残りを設定解除した場合、以下が適用されます。
+ 明示的に設定したプロンプトタイプ (管理ウェブサイトまたは CLI 経由) は、選択した特定のプロンプトバージョンに固定されます。更新しない限り変更されません。カスタムプロンプトごとに、以下のアップグレードステップに従います。
+ 未設定のままにしたプロンプトタイプは、AI エージェント設定に保存されません。実行時に、Amazon Connect は現在のシステムのデフォルトからそれらを解決します。これらのタイプは常に、モデルのアップグレードを含む最新のシステムプロンプトバージョンを使用します。設定解除プロンプトタイプにはアクションは必要ありません。

### 管理ウェブサイトを使用してアップグレードする
<a name="upgrade-models-scenario-1-admin-website"></a>

**ステップ 1: 更新されたモデルを使用して新しいプロンプトバージョンを作成する**

1. Amazon Connect 管理者ウェブサイトにログインします。

1. ナビゲーションメニューで、*AI エージェントデザイナー*、*AI プロンプト*を選択します。

1. *プロンプト* リストから、アップグレードするカスタム AI プロンプトを選択します。

1. *AI プロンプトビルダーで編集* (右上) を選択します。

1. 右上のドロップダウンには*、最新: 下書き*が表示されます。これは変更する作業コピーです。

1. *Models* セクションで、ドロップダウンを使用して新しいモデルを選択します。

1. *[公開]* を選択します。これにより、新しいモデルでプロンプトの新しいバージョンが作成されます。

1. 同じページの*「バージョン*」セクションまで下にスクロールします。新しいバージョンが作成されたことを確認できます。

1. 新しいバージョンを確認するには、*AI エージェントデザイナー**、AI プロンプト*に戻ります。リストからプロンプトを選択し、バージョンドロップダウン (右上) を使用して新しいバージョンを選択します。*概要*セクションには、更新されたモデル ID が表示されます。

**ステップ 2: 新しいプロンプトバージョンを使用するように AI エージェントを更新する**

1. *AI エージェントデザイナー*、*AI エージェント*に移動します。

1. このプロンプトを参照するカスタム AI エージェントを選択します。

1. *AI エージェントビルダーで編集*を選択して、エージェントビルダーページを開きます。

1. *プロンプトの追加* を選択します。ポップアップが表示され、使用可能なプロンプトが表示されます。

1. 新しいプロンプトバージョンを選択し、*追加*を選択します。ポップアップが閉じ、プロンプトがエージェントに追加されます。

1. *[公開]* を選択します。これにより、更新されたモデルでカスタムプロンプトを使用して新しい AI エージェントバージョンが作成されます。

1. *バージョン* セクションまでスクロールして、新しい AI エージェントバージョンが表示されることを確認します。

1. 必要に応じて、右上のドロップダウンから最新バージョンを選択します。*プロンプト*セクションには、新しいプロンプトバージョンが表示されます。

**ステップ 3: 新しい AI エージェントバージョンをデフォルトとして設定する**

1. *AI エージェントデザイナー*、*AI エージェント*に移動します。

1. *「デフォルトの AI エージェント設定*」セクションで、カスタム AI エージェントを使用しているユースケースを見つけて、新しいバージョンに更新します。

1. 保存するチェックマークアイコン (✓) を選択します。

1. 毎回バージョンを手動で更新しないようにするには、バージョンドロップダウンから*最新*を選択します。これにより、AI エージェントの最新公開バージョンが自動的に使用されます。

### AWS CLI を使用したアップグレード
<a name="upgrade-models-scenario-1-cli"></a>

新しいモデルで AI プロンプトを更新します。

```
aws qconnect update-ai-prompt \
  --assistant-id {{assistant-id}} \
  --ai-prompt-id {{custom-prompt-id}} \
  --model-id {{new-model-id}}
```

プロンプトの新しいバージョンを発行します。

```
aws qconnect create-ai-prompt-version \
  --assistant-id {{assistant-id}} \
  --ai-prompt-id {{custom-prompt-id}}
```

AI エージェントを更新して新しいプロンプトバージョンを参照します。

```
aws qconnect update-ai-agent \
  --assistant-id {{assistant-id}} \
  --ai-agent-id {{custom-agent-id}} \
  --configuration '{
    "{{agentTypeConfiguration}}": {
      "{{promptTypeAIPromptId}}": "{{custom-prompt-id}}:{{new-version-number}}"
    }
  }'
```

AI エージェントの新しいバージョンを発行します。

```
aws qconnect create-ai-agent-version \
  --assistant-id {{assistant-id}} \
  --ai-agent-id {{custom-agent-id}}
```

新しい AI エージェントバージョンをデフォルトとして設定します。

```
aws qconnect update-assistant-ai-agent \
  --assistant-id {{assistant-id}} \
  --ai-agent-type {{AGENT_TYPE}} \
  --configuration '{
    "aiAgentId": "{{custom-agent-id}}:{{new-version-number}}"
  }'
```

## シナリオ 2: プロンプトオーバーライドのないカスタム AI エージェント
<a name="upgrade-models-scenario-2"></a>

このシナリオでは、ロケールやナレッジベース設定などの設定をカスタマイズするカスタム AI エージェントを作成しましたが、プロンプトタイプを上書きしませんでした。すべてのプロンプトはシステムのデフォルトから解決されます。

### 自動アップグレード
<a name="upgrade-models-scenario-2-automatic"></a>

Amazon Connect がアップグレードされたモデルで新しいシステム AI エージェントとプロンプトバージョンを発行すると、カスタム AI エージェントは最新のシステムプロンプトバージョンを自動的に取得します。アクションは必要ありません。

これは、未設定のプロンプトタイプが、最新のシステムプロンプトバージョンを常に指す現在のシステムデフォルトから実行時に解決されるためです。

### システムアップグレードの前に特定のモデルを強制する
<a name="upgrade-models-scenario-2-force-model"></a>

Amazon Connect がシステムデフォルトとしてロールアウトする前に新しいモデルを使用する場合:

1. アップグレードするシステムプロンプトをコピーして、カスタム AI プロンプトを作成します。

1. モデルを希望の新しいモデルに変更します。

1. カスタムプロンプトを発行します。

1. カスタム AI エージェントを編集し、カスタムプロンプトを目的のタイプに追加します。

1. AI エージェントを公開します。

これにより、そのプロンプトタイプがシナリオ 1 の設定に変換されます。

## シナリオ 3: デフォルトの AI エージェント設定を更新する
<a name="upgrade-models-scenario-3"></a>

*AI エージェント*の概要ページの*デフォルトの AI エージェント設定*セクションは、各ユースケース (回答の推奨事項、手動検索、セルフサービスなど) でアクティブな AI エージェントバージョンを制御します。

Amazon Connect インスタンスが作成されると、各ユースケースは特定のシステム AI エージェントバージョンで自動的に設定されます。これらのバージョンは固定されます。Amazon Connect が新しいシステム AI エージェントバージョンを発行する場合や、新しいカスタム AI エージェントバージョンを発行する場合、これらのバージョンは自動更新されません。新しいバージョンを手動で選択する必要があります。

### 管理ウェブサイトを使用してアップグレードする
<a name="upgrade-models-scenario-3-admin-website"></a>

1. *AI エージェントデザイナー*、*AI エージェント*に移動します。

1. *「デフォルトの AI エージェント設定*」セクションで、更新するユースケースを見つけます (例: Answer Recommendation)。

1. バージョンドロップダウンから、新しい AI エージェントバージョンを選択します。

1. *[保存]* を選択します。

1. 毎回バージョンを手動で更新しないようにするには、バージョンドロップダウンから*最新*を選択します。これにより、AI エージェントの最新公開バージョンが自動的に使用されます。

### AWS CLI を使用したアップグレード
<a name="upgrade-models-scenario-3-cli"></a>

```
aws qconnect update-assistant-ai-agent \
  --assistant-id {{assistant-id}} \
  --ai-agent-type {{AGENT_TYPE}} \
  --configuration '{
    "aiAgentId": "{{ai-agent-id}}:{{new-version-number}}"
  }'
```

{{AGENT\_TYPE}} をユースケースタイプ (、、 など`SELF_SERVICE`) `ANSWER_RECOMMENDATION`に置き換え`MANUAL_SEARCH`ます。

## 概要
<a name="upgrade-models-summary"></a>


| \# | シナリオ | 自動アップグレード? | 必要なアクション | 
| --- | --- | --- | --- | 
| 1 | カスタム AI プロンプトを使用するカスタム AI エージェント | カスタムプロンプト: いいえ。プロンプトの設定解除: はい | プロンプトの編集、モデルの変更、プロンプトの発行、エージェントの更新、エージェントの発行。設定解除プロンプトの自動アップグレード。 | 
| 2 | プロンプトオーバーライドのないカスタム AI エージェント | はい | アクションは必要ありません | 
| 3 | デフォルトの AI エージェント設定の更新 | ユースケースの設定解除: はい。明示的な設定: いいえ | 明示的に固定されたバージョン: 新しいバージョンを選択して保存します | 

## 重要な考慮事項
<a name="upgrade-models-important-considerations"></a>
+ **テスト:** 変更を広範囲に展開する前に、非本番環境でモデルのアップグレードをテストします。`update-session` API を使用して、特定のセッションの AI エージェントバージョンを設定します。
+ **コードとしてのインフラストラクチャ:** CloudFormation または を使用して AI プロンプトと AI エージェントを管理する場合は AWS CDK、テンプレートのリソースプロパティを更新し ( など`ModelId``AWS::Wisdom::AIPrompt`)、スタックをデプロイします。このトピックで説明されているプロンプトタイプの動作は同じ方法で適用されます。実行時に解決されたプロンプトタイプの設定をシステムのデフォルト`AWS::Wisdom::AIAgent`から解除します。
+ **リージョンの可用性:** モデルの可用性は AWS リージョンによって異なります。モデルを選択する前に、サポートされているモデルテーブルを確認してください。詳細については、「[システム/カスタムプロンプトでサポートされているモデル](create-ai-prompts.md#cli-create-aiprompt)」を参照してください。
+ **セッションレベルのオーバーライド:** セッションに設定された AI エージェントバージョンは、アシスタントレベルのデフォルトよりも優先され、システムのデフォルトよりも優先されます。AI エージェントのバージョンをセッションレベルで設定する場合は、それらのリファレンスも更新する必要があります。
+ **システムのデフォルトに戻す:** 管理者ウェブサイトを使用してユースケースをシステム AI エージェントに戻すには、*AI エージェントデザイナー*、*AI エージェント*に移動します。*「デフォルトの AI エージェント設定*」セクションで、ユースケースを見つけ、エージェントドロップダウンからシステム AI エージェントを選択し、目的のバージョンまたは*最新*を選択し、*保存*を選択します。CLI `list-ai-agents --origin SYSTEM`を使用して、 を実行してユースケースタイプのシステム AI エージェント ID を検索し、 を使用して設定します`update-assistant-ai-agent`。