Consulte os conectores compatíveis com o Application Integration.

Criar agentes de conversação com o Application Integration

Pré-lançamento — Conversational agent tool

Este recurso está sujeito aos "Termos das Soluções Pré-GA" na seção Termos Gerais de Serviço dos Termos Específicos de Serviço. Os recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições das fases de lançamento.

Application Integration agora simplifica a criação de experiências de conversação ao se integrar diretamente aos Agentes de conversação (Dialogflow CX). Com esse recurso, é possível criar chatbots e ferramentas inteligentes que melhoram as interações dos usuários e automatizam tarefas diretamente dos fluxos de trabalho de integração usando gatilhos de API.

O que é um agente de conversa?

Um agente de conversação dos Agentes de Conversação (Dialogflow CX) é um agente virtual que se comunica em conversas de linguagem natural com os usuários. Ele analisa a entrada do usuário, interpreta a intenção e fornece respostas adequadas, permitindo experiências de conversa interativas e personalizadas. Eles foram criados para lidar com conversas em vários canais, como sites, apps para dispositivos móveis e plataformas de mensagens.

O que é uma ferramenta de agente de conversação?

Nos agentes de conversação (Dialogflow CX), uma ferramenta representa uma funcionalidade ou um serviço específico a que o agente de conversação pode acessar. As ferramentas são definidas em playbooks e permitem que o agente execute ações como recuperar dados, executar APIs ou interagir com sistemas externos. Application Integration gera essas ferramentas com base nos gatilhos de API da sua integração, facilitando a conexão da lógica de integração aos fluxos de conversa.

Antes de começar

Antes de criar uma ferramenta de agente de conversa usando Application Integration, verifique se:

• Atribua os seguintes papéis do IAM ao principal:
  • Administrador da conta de serviço (roles/iam.serviceAccountAdmin)
  • Administrador do Service Usage (roles/serviceusage.serviceUsageAdmin)
  • Editor do agente do console do Dialogflow (roles/dialogflow.consoleAgentEditor)

  Para informações sobre como conceder papéis a principais, consulte Conceder ou revogar um único papel.

Papéis do IAM necessários para contas de serviço

Os seguintes papéis do IAM são necessários para as contas de serviço usadas na criação de uma ferramenta de agente de conversa:

Conta de serviço	Descrição	Funções exigidas
Conta de serviço	Conta de serviço usada para criar a ferramenta de agente de conversação.	Invocador do Application Integration (roles/integrations.integrationInvoker)
Agente de serviço do Dialogflow (service-{$PROJECT_ID}@gcp-sa-dialogflow.iam.gserviceaccount.com)	Conta de serviço usada pelos agentes de conversação (Dialogflow CX) para acessar a integração.	Criador do token da conta de serviço (roles/iam.serviceAccountTokenCreator)

Criar uma nova ferramenta de agente de conversação

Para criar uma nova ferramenta de agente de conversa usando Application Integration, siga estas etapas:

1. No console do Google Cloud, acesse a página Application Integration.

   Acessar o Application Integration

2. No menu de navegação, clique em Integrações.

   A página Integrações aparece listando todas as integrações disponíveis no projeto do Google Cloud.

3. Selecione uma integração ou clique em Criar integração para criar uma.

   Se você estiver criando uma nova integração:

   1. Digite um nome e uma descrição no painel Criar integração.
   2. Selecione uma região para a integração.
      Observação: o menu suspenso Regiões lista apenas as regiões provisionadas no projeto do Google Cloud. Para provisionar uma nova região, clique em Ativar região. Consulte Ativar nova região para obter mais informações.
   3. Selecione uma conta de serviço para a integração. É possível mudar ou atualizar os detalhes da conta de serviço de uma integração a qualquer momento no painel Resumo da integração na barra de ferramentas de integração.
      Observação:a opção para selecionar uma conta de serviço só aparece se você tiver ativado a governança de integração para a região selecionada.
   4. Clique em Criar.

      Isso abre a integração na página do editor de integração.

4. Selecione uma integração. Isso abre a integração na página do editor de integração.
5. Verifique se a integração selecionada está configurada com um ou mais gatilhos de API.
6. Publique a versão da integração.
7. Na barra de ferramentas do designer, clique em (menu "Ações") e selecione Criar ferramenta de agente de conversação.

   O Application Integration verifica se as APIs necessárias estão ativadas. Caso contrário, você vai precisar ativar.

8. No painel Criar ferramenta de agente de conversação, forneça as seguintes entradas:
   1. Gatilhos de API: todos os gatilhos de API da sua integração são selecionados por padrão. Você pode desmarcar os gatilhos de API que não quer incluir na ferramenta.
   2. Tipo: selecione Criar novo agente de conversação e insira os seguintes detalhes:
      1. Região: selecione a região do agente.
      2. Nome do agente: insira um nome para o agente.
      3. Nome da ferramenta: digite um nome para a ferramenta.
      Observação:o idioma padrão do agente é inglês (Estados Unidos).
   3. Conta de serviço: escolha uma conta com os papéis e permissões necessários para o acesso aos recursos do agente. Se estiverem faltando, você vai precisar conceder esses papéis.
9. Clique em Ver especificação para analisar a especificação gerada dos acionadores selecionados. Você pode editar a especificação antes de salvar.
10. Clique em Salvar.

    Uma mensagem aparece indicando que a ferramenta foi criada. Clique em Visualizar para abrir o agente no console dos agentes de conversação (Dialogflow CX).

11. No console de agentes de conversação (Dialogflow CX), acesse Playbooks, clique no playbook do agente criado e adicione instruções para usar a ferramenta. Para mais informações, consulte Ferramentas de playbook.

Criar uma ferramenta de agente de conversação usando um agente atual

Para criar uma ferramenta de agente de conversa usando um agente existente, siga estas etapas:

1. No console do Google Cloud, acesse a página Application Integration.

   Acessar o Application Integration

2. No menu de navegação, clique em Integrações.

   A página Integrações aparece listando todas as integrações disponíveis no projeto do Google Cloud.

3. Selecione uma integração ou clique em Criar integração para criar uma.

   Caso você esteja criando uma nova integração, siga estas etapas:

   1. Digite um nome e uma descrição no painel Criar integração.
   2. Selecione uma região para a integração.
      Observação: o menu suspenso Regiões lista apenas as regiões provisionadas no projeto do Google Cloud. Para provisionar uma nova região, clique em Ativar região. Consulte Ativar nova região para obter mais informações.
   3. Selecione uma conta de serviço para a integração. É possível mudar ou atualizar os detalhes da conta de serviço de uma integração a qualquer momento no painel Resumo da integração na barra de ferramentas de integração.
      Observação:a opção para selecionar uma conta de serviço só aparece se você tiver ativado a governança de integração para a região selecionada.
   4. Clique em Criar.

      Isso abre a integração na página do editor de integração.

4. Selecione uma integração. Isso abre a integração na página do editor de integração.
5. Verifique se a integração selecionada está configurada com um ou mais gatilhos de API.
6. Publique a versão da integração.
7. Na barra de ferramentas do designer, clique em (menu "Ações") e selecione Criar ferramenta de agente de conversação.

   O Application Integration verifica se as APIs necessárias estão ativadas. Caso contrário, você vai precisar ativar.

8. No painel Criar ferramenta de agente de conversação, forneça as seguintes entradas:
   1. Gatilhos de API: todos os gatilhos de API da sua integração são selecionados por padrão. Você pode desmarcar os gatilhos de API que não quer incluir na ferramenta.
   2. Tipo: selecione Escolher agente de conversação existente e faça o seguinte:
      1. Agente de conversação: uma lista dos agentes disponíveis no seu projeto vai aparecer. Selecione o agente que você quer usar.
      2. Ferramenta: selecione Criar nova ferramenta ou Escolher ferramenta existente.

         Se você selecionar Criar nova ferramenta, insira um nome para ela.

         Se você selecionar Escolher ferramenta atual, uma lista de ferramentas disponíveis no agente selecionado vai aparecer. Selecione a ferramenta que você quer usar.

   3. Conta de serviço: escolha uma conta com os papéis e permissões necessários para o acesso aos recursos do agente. Se estiverem faltando, você vai precisar conceder esses papéis.
9. Clique em Ver especificação para analisar a especificação gerada dos acionadores selecionados. Você pode editar a especificação antes de salvar.
10. Clique em Salvar.

    Uma mensagem aparece indicando que a ferramenta foi criada. Clique em Visualizar para abrir o agente no console dos agentes de conversação (Dialogflow CX).

11. No console de agentes de conversação (Dialogflow CX), acesse Playbooks, clique no playbook do agente criado e adicione instruções para usar a ferramenta. Para mais informações, consulte Ferramentas de playbook.

Considerações

As seguintes considerações se aplicam ao usar ferramentas de agentes de conversa:

• As ferramentas de agente de conversação só podem ser criadas para integrações publicadas com gatilhos de API.
• Revise e teste seu agente no console de agentes de conversação (Dialogflow CX) após a criação.