Amazon Bedrock AgentCoreとSlackの統合

Amazon Bedrock AgentCore を Slack と統合することで、AI エージェントをワークスペースに直接導入できます。チームはアプリケーション間を行き来したり、会話履歴を失ったり、再認証を行ったりすることなく、エージェントと対話できるようになります。この統合では、セキュリティのために Slack イベントリクエストを検証し、スレッド間で会話の文脈を維持し、Slack のタイムアウト制限を超えるレスポンスを管理するという 3 つの技術要件に対応します。 開発者は通常、Slack 統合用のカスタム Webhook ハンドラー構築に時間を費やしています。AgentCore は、Slack 内で完結して、組み込みの会話メモリ、エージェントおよびそのツールへの安全なアクセス、エージェントの使用状況を追跡するアイデンティティ管理を提供することで、この作業を不要にします。 本稿では、AWS Cloud Development Kit (AWS CDK) を使用した Slack 統合の構築方法を実演します。3 つの専門的な AWS Lambda 関数でインフラストラクチャを展開し、Slack のセキュリティ要件に対応するためにイベントサブスクリプションを適切に設定する方法、そして多くのエージェントユースケースで機能する会話管理パターンを実装する方法を学びます。例として天気予報用エージェントを使用していますが、構築している統合層は完全に再利用可能です。Slack がエージェントと通信する方法を変更することなく、ランタイムやツールを特定のビジネスニーズに合わせてカスタマイズできます。 ## ソリューションの概要 本ソリューションは、主に 2 つのコンポーネントで構成されています。1 つ目は Slack とエージェント間の通信をルーティングおよび管理する Slack 統合インフラストラクチャであり、もう 1 つはクエリを処理して応答を行う [Amazon AgentCore Runtime](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/agents-tools-runtime.html) です。 本ソリューションにおける統合インフラストラクチャでは、サーバーレス型の統合を実現するために、[Amazon API Gateway](https://aws.amazon.com/api-gateway/)、[AWS Lambda](https://aws.amazon.com/lambda/)、[AWS Secrets Manager](https://aws.amazon.com/secrets-manager/)、および [Amazon Simple Queue Service (Amazon SQS)](https://aws.amazon.com/sqs/) を使用しています。 エージェントはコンテナ化され、AgentCore Runtime 上で実行されるようにホストされています。このエージェントは、ツールのアクセスに [Amazon Bedrock AgentCore Gateway](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/gateway.html) と、会話履歴の管理に [AgentCore Memory](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/memory.html) を統合した [Strands Agents SDK](https://strandsagents.com/latest/) を用いて構築されています。ランタイムは会話全体を通じてコンテキストを維持し、ツールの実行と通信のための標準化されたプロトコルである [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) を使用してツールを呼び出します。 これらのコンポーネントが整った状態で、以下のセクションではこれらがアーキテクチャ内でどのように連携して動作するかを検証します。 ## アーキテクチャ図 以下の図は、3 つの主要セクションを含むソリューションアーキテクチャを示しています： **セクション A – イメージビルドインフラストラクチャ** – まず、WeatherAgentImageStack CDK がコンテナイメージビルドパイプライン（[Amazon Simple Storage Service (Amazon S3)](https://aws.amazon.com/s3/) バケット、[AWS CodeBuild](https://aws.amazon.com/codebuild/) プロジェクト、および [Amazon Elastic Container Registry (Amazon ECR)](https://aws.amazon.com/ecr/) リポジトリ）をデプロイします。これにより、CodeBuild を使用して [AWS Graviton](https://aws.amazon.com/pm/ec2-graviton/)（ARM64 対応）のコンテナイメージが作成され、AgentCore Runtime で利用できるよう ECR リポジトリに格納されます。 **セクション B – AgentCore コンポーネント** – 次に、WeatherAgentCoreStack CDK が AgentCore Runtime、Gateway、Memory、および AWS Lambda 関数をデプロイします。Runtime は [Strands Agents Framework](https://aws.amazon.com/blogs/opensource/introducing-strands-agents-an-open-source-ai-agents-sdk/)（オープンソース AI エージェント SDK）を使用して、モデル呼び出し、ツール呼び出し、会話メモリのオーケストレーションを行います。 **セクション C – Slack 統合インフラストラクチャ** – 最後に、WeatherAgentSlackStack が統合インフラストラクチャ（API Gateway、Secrets Manager、Lambda 関数、SQS）をデプロイします。この層は、Webhook の検証、Amazon Simple Queue Service (Amazon SQS) によるキューイング、および 3 つの Lambda 関数を介したメッセージ処理を担当します。このレイヤーは AgentCore のユースケースに対して再利用可能です。 リクエストフローは以下の手順で構成されます： - ユーザーが Slack でダイレクトメッセージまたはチャンネル内で @appname と宛先を指定してメッセージを送信します。 - Slack が API Gateway に対して Webhook の POST リクエストを送信します。 - このリクエストは検証用 Lambda 関数に転送されます。 - Lambda は Secrets Manager から Slack の署名シークレットとボットトークンを取得し、真正性を検証します。 - 検証完了後、Lambda は非同期で SQS 統合 Lambda を呼び出します。 - SQS 統合 Lambda は、Slack のスレッド内でユーザーに「リクエストを処理中…」というメッセージを送信します。 - SQS 統合 Lambda はそのメッセージを SQS FIFO キューへ送信します。 - このキューが Agent 統合 Lambda をトリガーします。 - Lambda は、ユーザーのクエリと Slack スレッドタイムスタンプから取得したセッション ID を用いて、AgentCore Runtime を呼び出します。 - AgentCoreMemorySessionManager は、セッション ID（スレッドタイムスタンプ）およびアクター ID（ユーザー ID）を使用して、AgentCore Memory から会話履歴を取得します。 - Strands Framework は MCP プロトコルを用いて AgentCore Gateway からツールを取得します。 - Strands Framework は、メッセージ、コンテキスト、およびツールを指定して Amazon Bedrock モデル（Nova Pro）を呼び出します。 - モデルはどのツールを呼び出すかを判断し、リクエストを生成します。 - Gateway はツールの呼び出しを Lambda 上の MCP サーバーへルーティングし、そこで気象関連のツールが実行されます。 - ツール結果が Strands Framework に返され、必要に応じて再度モデルを呼び出します。 - Strands Framework は会話のターンを AgentCore Memory に保存します。 - Agent 統合 Lambda は、「リクエストを処理中…」というメッセージをエージェントの応答に更新します。 ## 事前準備 このソリューションには、以下の事前条件が必要です: - Amazon Bedrock AgentCore, Lambda, API Gateway, SQS, ECR, CodeBuild, AWS Identity and Access Management (IAM), Secrets Manager, Amazon Bedrock に対する権限を持つ AWS アカウント - 認証情報で設定された AWS Command Line Interface (AWS CLI) (v2.x) - Node.js (v18 以降) と npm のインストール済み - AWS CDK が AWS アカウント内でインストールされ、ブートストラップされていること インストール: npm install -g aws-cdk ブートストラップ: cdk bootstrap aws://ACCOUNT-NUMBER/REGION - Slack アカウント (2 つのオプション): 企業の Slack アカウントの場合、管理者と連携して統合アプリケーションを作成・公開するか、サンドボックス組織を使用してください。 または、テストや実験のために独自の Slack アカウントとワークスペースを作成することもできます。 - アプリ名には、agent-core-weather-agent と入力してください。 - アプリを開発するワークスペースを選択するには、このアプリケーションを使用したいワークスペースを選んでください。 - [Create App] を選択します。 アプリケーションが作成されると、**Basic Information** ページに移動されます。 - ナビゲーションペインの Features 下で、[OAuth & Permissions] を選択してください。 - Scopes セクションに移動し、Bot Token Scopes の下で、[Add an OAuth Scope] を選択して以下を入力することで、以下のスコープを追加します： app_mentions:read - chat:write - im:history - im:read - im:write - [OAuth & Permissions] ページで、[OAuth Tokens] セクションに移動し、[Install to ExampleCorp] を選択してください。 - 次のページで、プロセスを完了するために [Allow] を選択します。 - [OAuth & Permissions] ページで、[OAuth Tokens] に移動し、作成された Bot User OAuth Token の値をコピーしてください。この値は、インフラストラクチャのデプロイ時に後で使用できるよう、メモ帳に保存しておいてください。 - ナビゲーションペインの Settings 下で、[Basic Information] を選択してください。 - Signing Secret に移動し、 - この値をコピーしてメモ帳に保存し、インフラストラクチャのデプロイ時に後で使用してください。 - Slack 内でアプリとのダイレクトメッセージングを有効にするには、ナビゲーションペインの App Home に移動します。 - [Show Tabs] セクションで、[Allow users to send Slash commands and messages from the messages tab] を有効にします。 **注意:** イベントサブスクリプションの設定は、インフラストラクチャのデプロイと Webhook URL の取得後、ステップ 3 で完了します。 ## ステップ 2: インフラストラクチャのデプロイ [GitHub](https://github.com/aws-samples/sample-Integrating-Amazon-Bedrock-AgentCore-with-Slack) リポジトリをクローンし、プロジェクトディレクトリに移動してください: git clone https://github.com/aws-samples/sample-Integrating-Amazon-Bedrock-AgentCore-with-Slack cd sample-Integrating-Amazon-Bedrock-AgentCore-with-Slack デプロイには、Slack の認証情報を環境変数として設定し、デプロイスクリプトを実行する必要があります。 export SLACK_BOT_TOKEN="xoxb-your-token-here" export SLACK_SIGNING_SECRET="your-signing-secret-here" ./deploy.sh デプロイには約 10〜15 分かかり、3 つの CDK スタックが作成されます。コンテナビルド用のイメージスタック、ランタイム、ゲートウェイ、メモリを含むエージェントスタック、および API Gateway と Lambda 関数を含む Slack スタックです。デプロイ出力には、次のステップで使用する Webhook URL が含まれています。 ## ステップ 3: Slack イベントサブスクリプションの設定 インフラストラクチャのデプロイと Webhook URL の取得後、Slack アプリの設定を完了できます。 - 設定には、Slack API の Slack アプリに戻り、agent-core-weather-agent を選択する必要があります - ナビゲーションペインの「機能」セクションで、「イベントサブスクリプション」を選択します。 - 「イベントを有効にする」をオンに切り替えます。 - 「リクエスト URL」フィールドに、デプロイ出力から取得した Webhook URL を貼り付けます。 - URL が検証されたことを示す緑色のチェックマークと「Verified」という表示が現れたら、「ボットイベントの購読へ移動」します。 - 「ボットユーザーイベントを追加」を選択し、以下のイベントを追加します： app_mention - im - ページ下部にある「変更を保存」をクリックします。 - 「設定」セクションで、「アプリのインストール」へ移動し、「ExampleCorp への再インストール」を選択します。ポップアップ画面が表示されたら、「許可」を選択してください。 ## ステップ 4: AgentCore の Slack 統合テスト テストには、Slack の**「Apps」**セクションで agent-core-weather-agent を見つける必要があります。このアプリを既存のチャンネルに招待するには、/invite @agent-core-weather-agent と入力します。このアプリケーションをチャンネルに追加した後、ユーザーは @agent-core-weather-agent を使用して天候情報を取得したり、AgentCore Agent と対話したりできます。また、直接チャットすることも可能です

Amazon Bedrock AgentCoreとSlackの統合

背景や根拠まで確認しますか？

関連記事

調べる

選ぶ

サイト