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

Amazon Connect で AI エージェントを作成する

AI エージェントは、end-to-endの AI エージェントエクスペリエンスを設定およびカスタマイズするリソースです。例えば、AI エージェントは、どの AI プロンプトと AI ガードレールを使用するか、どのロケールをレスポンスに使用するかなど、手動検索の処理方法を AI アシスタントに伝えます。

Amazon Connect には、すぐに使用できるシステム AI エージェントが用意されています。

各ユースケースは、デフォルトの AI システムエージェントを使用するように設定されています。これはカスタマイズすることもできます。

例えば、次の図は、エージェントアシスタンスユースケースにカスタマイズされた AI エージェントを使用するように設定され、残りはシステムのデフォルト AI エージェントを使用する Connect AI エージェントエクスペリエンスを示しています。

カスタマイズされた AI エージェントの仕組みは次のとおりです。

AI エージェントの作成方法

AI エージェントをフローに関連付ける

デフォルトのout-of-the-box使える Connect AI エージェント機能を使用するには、フローに接続アシスタントブロックを追加します。このブロックは、アシスタントと AI エージェントのデフォルトのマッピングを関連付けます。

このデフォルトの動作を上書きするには、Lambda を作成し、AWS Lambda 関数 ブロックを使用してフローに追加します。

AI エージェントを作成および管理するための CLI コマンドの例

このセクションでは、AI エージェントの作成と管理に役立ついくつかのサンプル AWS CLI コマンドについて説明します。

カスタマイズ済みのすべての AI プロンプトバージョンを使用する AI エージェントを作成する

Connect AI エージェントは、AI エージェントに AI プロンプトバージョンが指定されている場合、その機能に AI プロンプトバージョンを使用します。それ以外の場合は、システムデフォルトが使用されます。

次のサンプル CLI コマンドを使用して、カスタマイズされたすべての AI AWS プロンプトバージョンを使用して 回答のレコメンデーションを行う AI エージェントを作成します。

aws qconnect create-ai-agent \
  --assistant-id <YOUR_CONNECT_AI_AGENT_ASSISTANT_ID> \
  --name example_answer_recommendation_ai_agent \
  --visibility-status PUBLISHED \
  --type ANSWER_RECOMMENDATION \
  --configuration '{
    "answerRecommendationAIAgentConfiguration": {
      "answerGenerationAIPromptId": "<ANSWER_GENERATION_AI_PROMPT_ID_WITH_VERSION_QUALIFIER>",
      "intentLabelingGenerationAIPromptId": "<INTENT_LABELING_AI_PROMPT_ID_WITH_VERSION_QUALIFIER>",
      "queryReformulationAIPromptId": "<QUERY_REFORMULATION_AI_PROMPT_ID_WITH_VERSION_QUALIFIER>"
    }
  }'            

AI エージェントを部分的に設定する

一部のカスタマイズした AI プロンプトのバージョンを使用するよう指定して、AI エージェントを部分的に設定することもできます。指定されていないものについては、デフォルトの AI プロンプトが使用されます。

次のサンプル CLI コマンドを使用して、カスタマイズされた AI AWS プロンプトバージョンを使用し、システムのデフォルトが残りを処理できるようにする回答レコメンデーション AI エージェントを作成します。

aws qconnect create-ai-agent \
  --assistant-id <YOUR_CONNECT_AI_AGENT_ASSISTANT_ID> \
  --name example_answer_recommendation_ai_agent \
  --visibility-status PUBLISHED \
  --type ANSWER_RECOMMENDATION \
  --configuration '{
    "answerRecommendationAIAgentConfiguration": {
      "answerGenerationAIPromptId": "<ANSWER_GENERATION_AI_PROMPT_ID_WITH_VERSION_QUALIFIER>"
    }
  }'

手動検索用の AI プロンプトバージョンを設定する

手動検索 AI エージェントタイプには AI プロンプトのバージョンが 1 つしかないため、部分的な設定はできません。

次のサンプル CLI コマンドを使用して、手動検索用の AI AWS プロンプトバージョンを指定します。

aws qconnect create-ai-agent \
  --assistant-id <YOUR_CONNECT_AI_AGENT_ASSISTANT_ID> \
  --name example_manual_search_ai_agent \
  --visibility-status PUBLISHED \
  --type MANUAL_SEARCH \
  --configuration '{
    "manualSearchAIAgentConfiguration": {
      "answerGenerationAIPromptId": "<ANSWER_GENERATION_AI_PROMPT_ID_WITH_VERSION_QUALIFIER>"
    }
  }'            

AI エージェントを使用してナレッジベースの設定を上書きする

AI エージェントを使用して、Connect AI エージェントが使用するアシスタントの関連付けと使用方法を設定できます。カスタマイズでサポートされている関連付けは、以下をサポートするナレッジベースです。

たとえば、次の AWS CLI コマンドを使用して、カスタマイズされたナレッジベース設定で AI エージェントを作成します。

aws qconnect create-ai-agent \
  --assistant-id <YOUR_CONNECT_AI_AGENT_ASSISTANT_ID> \
  --name example_manual_search_ai_agent \
  --visibility-status PUBLISHED \
  --type MANUAL_SEARCH \
  --configuration '{
    "manualSearchAIAgentConfiguration": {
      "answerGenerationAIPromptId": "<ANSWER_GENERATION_AI_PROMPT_ID_WITH_VERSION_QUALIFIER>",
      "associationConfigurations": [
        {
          "associationType": "KNOWLEDGE_BASE",
          "associationId": "<ASSOCIATION_ID>",
          "associationConfigurationData": {
            "knowledgeBaseAssociationConfigurationData": {
              "overrideKnowledgeBaseSearchType": "SEMANTIC",
              "maxResults": 5,
              "contentTagFilter": {
                "tagCondition": { "key": "<KEY>", "value": "<VALUE>" }
              }
            }
          }
        }
      ]
    }
  }'  

AI エージェントのバージョンを作成する

AI プロンプトと同様に、AI エージェントを作成したら、実行時に Connect AI エージェントで使用できる AI エージェントのイミュータブルインスタンスであるバージョンを作成できます。

次のサンプル AWS CLI コマンドを使用して、AI エージェントバージョンを作成します。

aws qconnect create-ai-agent-version \
  --assistant-id <YOUR_CONNECT_AI_AGENT_ASSISTANT_ID> \
  --ai-agent-id <YOUR_AI_AGENT_ID>            

バージョンが作成されると、次の形式を使用して AI エージェントの ID を指定できます。

 <AI_AGENT_ID>:<VERSION_NUMBER>            

Connect AI エージェントで使用する AI エージェントを設定する

ユースケース用に AI プロンプトバージョンと AI エージェントバージョンを作成したら、Connect AI エージェントで使用するように設定できます。

Connect AI agents Assistant で AI エージェントのバージョンを設定する

Connect AI agents Assistant で使用する AI エージェントバージョンをデフォルトとして設定できます。

次のサンプル AWS CLI コマンドを使用して、AI エージェントのバージョンをデフォルトに設定します。AI エージェントバージョンが設定されると、次の Amazon Connect 問い合わせと関連する Connect AI エージェントセッションが作成されたときに使用されます。

aws qconnect update-assistant-ai-agent \
  --assistant-id <YOUR_CONNECT_AI_AGENT_ASSISTANT_ID> \
  --ai-agent-type MANUAL_SEARCH \
  --configuration '{
    "aiAgentId": "<MANUAL_SEARCH_AI_AGENT_ID_WITH_VERSION_QUALIFIER>"
  }'                

Connect AI エージェントセッションで AI エージェントバージョンを設定する

セッションを作成または更新するときに、個別の Connect AI エージェントセッションごとに AI エージェントバージョンを設定することもできます。

次のサンプル AWS CLI コマンドを使用して、個別のセッションごとに AI エージェントのバージョンを設定します。

aws qconnect update-session \
  --assistant-id <YOUR_CONNECT_AI_AGENT_ASSISTANT_ID> \
  --session-id <YOUR_CONNECT_AI_AGENT_SESSION_ID> \
  --ai-agent-configuration '{
    "ANSWER_RECOMMENDATION": { "aiAgentId": "<ANSWER_RECOMMENDATION_AI_AGENT_ID_WITH_VERSION_QUALIFIER>" },
    "MANUAL_SEARCH": { "aiAgentId": "<MANUAL_SEARCH_AI_AGENT_ID_WITH_VERSION_QUALIFIER>" }
  }'                

セッションに設定された AI エージェントバージョンは、Connect AI エージェントアシスタントのレベルで設定されたバージョンよりも優先され、システムのデフォルトよりも優先されます。この優先順位を使用して、特定のコンタクトセンターのビジネスセグメント用に作成されたセッションに AI エージェントのバージョンを設定することができます。例えば、フローを使用して、Lambda フローブロックを使用した特定の Amazon Connect キューの AI エージェントのバージョンの設定を自動化します。

システムデフォルトに戻す

何らかの理由でカスタマイズの削除が必要な場合は、デフォルトの AI エージェントのバージョンに戻すこともできます。

次のサンプル AWS CLI コマンドを使用して AI エージェントのバージョンを一覧表示し、元のバージョンに戻します。

aws qconnect list-ai-agents \
  --assistant-id <YOUR_CONNECT_AI_AGENT_ASSISTANT_ID> \
  --origin SYSTEM