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

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

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

Amazon Q in Connect は、ユースケースごとにシステム AI エージェントを提供します。

システム AI エージェントには、ユースケースごとにデフォルトの AI プロンプトが入力されます。

例えば、次の図は、回答の推奨や手動検索にカスタマイズされた AI エージェントを使用するように設定された Amazon Q in Connect エクスペリエンスを示していますが、セルフサービスのユースケースにはシステムのデフォルト AI エージェントを使用します。

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

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

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

すぐに使用可能なデフォルトの Amazon Q in Connect 機能を使用するには、フローに Amazon Q in Connect ブロックを追加します。このブロックは、アシスタントと AI エージェントのデフォルトのマッピングを関連付けます。

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

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

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

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

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

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

aws qconnect create-ai-agent \
  --assistant-id <YOUR_Q_IN_CONNECT_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_Q_IN_CONNECT_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_Q_IN_CONNECT_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 エージェントを使用して、Amazon Q in Connect でどのアシスタントの関連付けをどのように使用するかを設定することができます。カスタマイズでサポートされている関連付けは、以下をサポートするナレッジベースです。

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

aws qconnect create-ai-agent \
  --assistant-id <YOUR_Q_IN_CONNECT_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 エージェントが作成されると、ランタイムに Amazon Q in Connect で使用できる AI エージェントのイミュータブルなインスタンスであるバージョンを作成することができます。

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

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

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

 <AI_AGENT_ID>:<VERSION_NUMBER>            

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

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

Amazon Q in Connect アシスタントでの AI エージェントのバージョンの設定

Amazon Q in Connect アシスタントで使用する AI エージェントのバージョンをデフォルトとして設定できます。

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

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

Amazon Q in Connect セッションでの AI エージェントのバージョンの設定

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

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

aws qconnect update-session \
  --assistant-id <YOUR_Q_IN_CONNECT_ASSISTANT_ID> \
  --session-id <YOUR_Q_IN_CONNECT_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 エージェントのバージョンは、Amazon Q in Connect アシスタントのレベルで設定されたバージョンよりも優先され、システムのデフォルトよりも優先されます。この優先順位を使用して、特定のコンタクトセンターのビジネスセグメント用に作成されたセッションに AI エージェントのバージョンを設定することができます。例えば、フローを使用して、Lambda フローブロックを使用した特定の Amazon Connect キューの AI エージェントのバージョンの設定を自動化します。

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

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

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

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