Habilitando a interação com formulários no Slack

Editar online

Configure seu aplicativo Slack para exibir formulários interativos dos fluxos de trabalho da Agentic nas conversas dos agentes.

Neste tópico, você aprenderá como:

  • Configure escopos e tipos de token d OAuth s para seu aplicativo Slack

  • Inscreva-se nos eventos do bot para receber interações

  • Adicionar domínios de exibição de aplicativos para visualizações de links

  • Habilitar visualizações de objetos de trabalho para renderização de formulários

  • Configure o domínio para receber cargas úteis de interação

Todas essas etapas de configuração são necessárias para permitir que seu aplicativo Slack exiba formulários dos fluxos de trabalho do Agentic quando os usuários interagem com os agentes.

Antes de iniciar

Primeiro, você deve concluir a configuração inicial do Slack como um canal para o seu agente. Para obter instruções, consulte “Como conectar-se ao Slack ”.

Configurar escopos e tipos de token

  1. Acesse https://api.slack.com/apps e selecione seu aplicativo.

  2. Acesse “ OAuth ” (Configurações) e “Permissions” (Permissões) no menu e defina os escopos:

    • links:read

    • links:write

Você pode encontrar os detalhes de cada escopo em https://docs.slack.dev/reference/scopes.

Inscreva-se nos eventos

Inscreva-se em eventos em nome do usuário bot do seu aplicativo com o Bot Events. Depois de se inscrever nos eventos, você poderá receber eventos que sejam relevantes para o seu agente.

  1. Acesse https://api.slack.com/apps e selecione seu aplicativo.

  2. Vá para Assinaturas de eventos e adicione os eventos do bot na seção Assinar eventos do bot :

    • app_mention

    • entity_details_requested

    • link_shared

    • message.im

Você pode encontrar os detalhes de cada evento em https://docs.slack.dev/reference/events/.

Adicionar domínios de desdobramento de aplicativos

Configure domínios de exibição de aplicativos para habilitar visualizações avançadas de links e Objetos de Trabalho em conversas no Slack com seu agente. Quando os usuários compartilham links no Slack, os domínios desdobrados permitem que seu aplicativo exiba visualizações aprimoradas com informações contextuais.

Para adicionar um domínio de desdobramento de aplicativo ao seu aplicativo:

  1. Acesse https://api.slack.com/apps e selecione seu aplicativo.

  2. Vá para Assinaturas de eventos e selecione Domínios de desdobramento do aplicativo.

  3. Registre o domínio da sua instância do watsonx Orchestrate.

O nome de domínio deve seguir o padrão "https://channels.<host>", em que <host> é o nome de host totalmente qualificado da sua instância do watsonx Orchestrate. Por exemplo, "https://channels.dl.watson-orchestrate.ibm.com".

Adicione visualizações de objetos de trabalho ao seu aplicativo

Para que o Slack exiba formulários em uma conversa com um agente, você deve adicionar Visualizações de Objetos de Trabalho. Para configurar as visualizações de objetos de trabalho em seu aplicativo:

  1. Acesse https://api.slack.com/apps e selecione seu aplicativo.

  2. Vá para Visualizações de objetos no menu e defina a opção como Ativado.

  3. Adicione os tipos de entidade:

    • slack#/entities/item

  4. Clique em Salvar.

Configure o domínio para receber cargas úteis de interação

Quando o agente precisa executar um fluxo em resposta a uma interação, o Slack precisa saber para onde enviar a carga útil da interação. Para configurar um Request URL para seu aplicativo:

  1. Acesse https://api.slack.com/apps e selecione seu aplicativo.

  2. Vá para Interatividade e atalhos e defina a opção como Ativado.

  3. No campo Solicitação URL, insira a solicitação URL. Obtenha o URL na configuração do Slack para o seu agente na etapa Configurar agente no Slack.

A solicitação URL deve seguir o padrão “https://channels.<host>/tenants/<tenant_id>/agents/<agent_id>/environments/<environment_id>/channels/slack//events”.

Informações relacionadas

Para obter mais informações sobre implementações do Slack, consulte: