Criar agentes de conversação com o Application Integration

Visualização — Ferramenta de agente de conversação

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 da fase de lançamento.

O Application Integration agora simplifica a criação de experiências de conversação ao se integrar diretamente ao Dialogflow CX. Esse recurso permite criar chatbots e ferramentas inteligentes que melhoram as interações do usuário e automatizam tarefas diretamente dos fluxos de trabalho de integração usando acionadores de API.

O que é um agente de conversação?

Um agente de conversação do Dialogflow CX é um agente virtual que se comunica em conversas em 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ção interativas e personalizadas. Esses agentes são projetados 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?

No Dialogflow CX, uma ferramenta representa uma funcionalidade ou 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. O Application Integration gera essas ferramentas com base nos acionadores de API da integração, facilitando a conexão da lógica de integração aos fluxos de conversação.

Antes de começar

Verifique o seguinte antes de criar uma ferramenta de agente de conversação usando o Application Integration:

• 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 aos principais, consulte Conceder ou revogar um único papel.

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

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

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 pelo 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ção usando o 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 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. Insira 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 de informações Resumo da integração na barra de ferramentas de integração.
      Observação:a opção de selecionar uma conta de serviço só será exibida 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 acionadores de API.
6. Publique a versão de 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 receber uma solicitação para ativá-las.

8. No painel Criar ferramenta de agente de conversação, forneça as seguintes entradas:
   1. Acionadores de API: todos os acionadores de API da integração são selecionados por padrão. Opcionalmente, você pode desmarcar os acionadores 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: insira 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 de serviço com os papéis e permissões necessários para o acesso ao recurso do agente. Se estiver faltando, você vai receber uma solicitação para concedê-los.
9. Clique em Visualizar especificação para revisar a especificação gerada para os acionadores selecionados. Opcionalmente, 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 do Dialogflow CX.

11. No console do Dialogflow CX, acesse Playbooks, clique no playbook do agente criado e adicione instruções ao playbook para usar a ferramenta. Para mais informações, consulte Ferramentas do playbook.

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

Para criar uma ferramenta de agente de conversação 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 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. Insira 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 de informações Resumo da integração na barra de ferramentas de integração.
      Observação:a opção de selecionar uma conta de serviço só será exibida 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 acionadores de API.
6. Publique a versão de 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 receber uma solicitação para ativá-las.

8. No painel Criar ferramenta de agente de conversação, forneça as seguintes entradas:
   1. Acionadores de API: todos os acionadores de API da integração são selecionados por padrão. Opcionalmente, você pode desmarcar os acionadores 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 de agentes disponíveis no seu projeto aparece. 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 a ferramenta.

         Se você selecionar Escolher ferramenta existente, 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 de serviço com os papéis e permissões necessários para o acesso ao recurso do agente. Se estiver faltando, você vai receber uma solicitação para concedê-los.
9. Clique em Visualizar especificação para revisar a especificação gerada para os acionadores selecionados. Opcionalmente, 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 do Dialogflow CX.

11. No console do Dialogflow CX, acesse Playbooks, clique no playbook do agente criado e adicione instruções ao playbook para usar a ferramenta. Para mais informações, consulte Ferramentas do playbook.

Considerações

As considerações a seguir se aplicam ao uso de ferramentas de agente de conversação:

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