Visão geral da integração entre Amazon Bedrock AgentCore e Slack
\n
Integrar o Amazon Bedrock AgentCore ao Slack permite que equipes acessem agentes de IA diretamente em seu ambiente de trabalho, sem a necessidade de alternar entre aplicativos, perder o histórico de conversas ou se reautenticar. Essa integração aborda três desafios técnicos principais: validação segura dos eventos do Slack, manutenção do contexto das conversas em threads e gerenciamento de respostas que ultrapassam o limite de timeout do Slack.
\n
O uso do AWS Cloud Development Kit (AWS CDK) simplifica a implantação da infraestrutura necessária, composta por funções AWS Lambda especializadas, Amazon API Gateway, Amazon Simple Queue Service (SQS) e AWS Secrets Manager, garantindo uma arquitetura serverless escalável e segura.
\n\n
Componentes da solução e arquitetura
\n
A solução é dividida em três seções principais:
\n
- \n
- Construção da imagem do agente: Utiliza AWS CodeBuild para criar imagens containerizadas otimizadas para AWS Graviton (ARM64), armazenadas no Amazon Elastic Container Registry (ECR).
- Componentes do AgentCore: Implementa o AgentCore Runtime, Gateway e Memory, utilizando o Strands Agents SDK para orquestrar invocações de modelos, chamadas a ferramentas e gerenciamento do histórico de conversas.
- Infraestrutura de integração com Slack: Composta por API Gateway, Secrets Manager, três funções Lambda e SQS para validação, enfileiramento e processamento assíncrono das mensagens do Slack.
\n
\n
\n
\n
O fluxo de requisição funciona da seguinte forma: o usuário envia uma mensagem no Slack; o Slack encaminha um webhook ao API Gateway; a função Lambda de verificação valida a requisição usando segredos armazenados no Secrets Manager; após a verificação, a mensagem é colocada na fila SQS e processada pela função Lambda de integração com o AgentCore, que consulta o histórico da conversa, invoca o modelo Amazon Bedrock Nova Pro e retorna a resposta atualizada ao Slack.
\n\n
Pré-requisitos para implantação
\n
- \n
- Conta AWS com permissões para Amazon Bedrock AgentCore, Lambda, API Gateway, SQS, ECR, CodeBuild, IAM e Secrets Manager.
- AWS CLI v2 configurado com credenciais.
- Node.js v18 ou superior e npm instalados.
- AWS CDK instalado e configurado (comando
npm install -g aws-cdkecdk bootstrap). - Conta Slack com permissões para criar apps ou acesso a workspace sandbox para testes.
\n
\n
\n
\n
\n
\n\n
Passo a passo para criar a integração
\n
1. Criar um app no Slack
\n
- \n
- Acesse Slack API e clique em “Create New App”.
- Escolha “From scratch”, defina o nome “agent-core-weather-agent” e selecione o workspace.
- Em “OAuth & Permissions”, adicione as seguintes permissões ao Bot Token Scopes:
app_mentions:read,chat:write,im:history,im:read,im:write. - Instale o app no workspace e copie o “Bot User OAuth Token” e o “Signing Secret” para uso posterior.
- Em “App Home”, habilite o envio de comandos Slash e mensagens na aba de mensagens.
\n
\n
\n
\n
\n
\n\n
2. Implantar a infraestrutura com AWS CDK
\n
Clone o repositório oficial do GitHub:
\n
git clone https://github.com/aws-samples/sample-Integrating-Amazon-Bedrock-AgentCore-with-Slack\ncd sample-Integrating-Amazon-Bedrock-AgentCore-with-Slack\n\n
Configure as variáveis de ambiente com as credenciais do Slack:
\n
export SLACK_BOT_TOKEN="xoxb-seu-token-aqui"\nexport SLACK_SIGNING_SECRET="seu-signing-secret-aqui"\n\n
Execute o script de deploy:
\n
./deploy.sh\n\n
Essa etapa cria três stacks CDK e pode levar de 10 a 15 minutos. Ao final, será exibida a URL do webhook necessária para a configuração no Slack.
\n\n
3. Configurar assinaturas de eventos no Slack
\n
- \n
- Retorne ao app no Slack API e acesse “Event Subscriptions”.
- Ative “Enable Events” e cole a URL do webhook fornecida pela implantação no campo “Request URL”. Aguarde a verificação com o ícone verde.
- Em “Subscribe to bot events”, adicione os eventos
app_mentioneim. - Salve as alterações e reinstale o app no workspace para ativar as permissões.
\n
\n
\n
\n
\n\n
4. Testar a integração no Slack
\n
Localize o app “agent-core-weather-agent” na seção de Apps do Slack. Você pode convidar o app para um canal com o comando /invite @agent-core-weather-agent ou interagir via mensagem direta.
\n
Exemplo de comando: “What’s the weather in Dallas today”. O app responde inicialmente com “Processing your request…” e, após o processamento pelo AgentCore, atualiza a mensagem com a resposta do agente.
\n
O histórico da conversa é mantido graças ao AgentCore Memory, permitindo continuidade sem repetição de contexto.
\n\n
Detalhes técnicos da integração
\n
Gerenciamento de sessões e contexto
\n
O AgentCore utiliza o timestamp da thread do Slack como session ID e o ID do usuário como actor ID para identificar e manter o histórico da conversa. Essa abordagem elimina a necessidade de gerenciamento externo de estado e isola conversas em threads distintas.
\n\n
Processamento assíncrono para respeitar timeout do Slack
\n
Como as respostas do agente podem ultrapassar o limite de 3 segundos do Slack para webhooks, a arquitetura usa três funções Lambda:
\n
- \n
- Verification Lambda: valida a assinatura do Slack e responde imediatamente.
- SQS Integration Lambda: filtra eventos e coloca as mensagens na fila SQS.
- Agent Integration Lambda: processa a fila, invoca o AgentCore e atualiza as mensagens no Slack.
\n
\n
\n
\n\n
Comunicação segura e acesso a ferramentas
\n
O AgentCore Gateway utiliza autenticação AWS Signature Version 4 (SigV4) para comunicação segura e o protocolo Model Context Protocol (MCP) para invocar ferramentas, como o agente de clima usado no exemplo.
\n
É possível estender o modelo para permitir autenticação individual de usuários via Identity Provider (IdP), embora essa funcionalidade não seja abordada neste tutorial.
\n\n
Personalização e reutilização da solução
\n
A camada de integração Slack pode ser reaproveitada para diferentes agentes construídos com AgentCore. Basta substituir as ferramentas do agente no stack AgentCore para adaptá-lo a outras necessidades de negócio, mantendo o gerenciamento de memória e padrões de comunicação.
\n\n
Limpeza e remoção dos recursos
\n
Para remover todos os recursos criados, execute o script:
\n
./cleanup.sh\n\n\n
Links úteis para aprofundamento
\n
