Crie agentes de conversação com a solução Application Integration

A integração de aplicações simplifica agora a criação de experiências conversacionais através da integração direta com agentes conversacionais (Dialogflow CX). Esta funcionalidade permite-lhe criar chatbots e ferramentas inteligentes que melhoram as interações dos utilizadores e automatizam tarefas, diretamente a partir dos fluxos de trabalho de integração, através de acionadores de API.

O que é um agente conversacional?

Um agente de conversação (Dialogflow CX) é um agente virtual que comunica em conversas de linguagem natural com os utilizadores. Analisa a introdução do utilizador, interpreta a intenção e fornece respostas adequadas, permitindo experiências conversacionais interativas e personalizadas. Estes agentes foram concebidos para processar conversas em vários canais, como Websites, apps para dispositivos móveis e plataformas de mensagens.

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

Nos agentes conversacionais (Dialogflow CX), uma ferramenta representa uma funcionalidade ou um serviço específico ao qual o agente conversacional pode aceder. As ferramentas são definidas em manuais de procedimentos e permitem que o agente execute ações como obter dados, executar APIs ou interagir com sistemas externos. A integração de aplicações gera estas ferramentas com base nos acionadores da API da sua integração, o que facilita a ligação da lógica de integração aos fluxos de conversa.

Antes de começar

Certifique-se do seguinte antes de criar uma ferramenta de agente conversacional através da integração de aplicações:

Atribua as seguintes funções IAM ao seu principal:
- Administrador da conta de serviço (roles/iam.serviceAccountAdmin)
- Administrador de utilização de serviços (roles/serviceusage.serviceUsageAdmin)
- Editor do agente da consola do Dialogflow (roles/dialogflow.consoleAgentEditor)
Para obter informações sobre como conceder funções a responsáveis, consulte o artigo Conceda ou revogue uma única função.

Funções de IAM necessárias para contas de serviço

As seguintes funções de IAM são necessárias para as contas de serviço usadas para criar uma ferramenta de agente conversacional:

Conta de serviço	Descrição	Funções necessárias
Conta de serviço	Conta de serviço usada para criar a ferramenta de agente conversacional.	Application Integration Invoker (`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 conversacionais (Dialogflow CX) para aceder à integração.	Criador de tokens de contas de serviço (`roles/iam.serviceAccountTokenCreator`)

Crie uma nova ferramenta de agente conversacional

Para criar uma nova ferramenta de agente de conversação através da integração de aplicações, siga estes passos:

Na Google Cloud Console, aceda à página Integração de aplicações.
Aceda à solução Application Integration
No menu de navegação, clique em Integrações.
A página Integrações é apresentada com todas as integrações disponíveis no projeto do Google Cloud.
Selecione uma integração existente ou clique em Criar integração para criar uma nova.
Se estiver a criar uma nova integração:
1. Introduza um nome e uma descrição no painel Criar integração.
2. Selecione uma região para a integração.
  Nota: o menu pendente Regiões apenas apresenta as regiões aprovisionadas no seu projeto do Google Cloud. Para aprovisionar uma nova região, clique em Ativar região. Consulte o artigo Ative uma nova região para mais informações.
3. Selecione uma conta de serviço para a integração. Pode alterar ou atualizar os detalhes da conta de serviço de uma integração em qualquer altura no painel Resumo da integração na barra de ferramentas de integração.
  Nota: a opção para selecionar uma conta de serviço é apresentada apenas se tiver ativado a gestão da integração para a região selecionada.
4. Clique em Criar.
  Esta ação abre a integração no editor de integração.
Selecione uma integração existente. Esta ação abre a integração no editor de integração.
Certifique-se de que a integração selecionada está configurada com um ou mais acionadores da API.
Publicar a versão da integração.
Na barra de ferramentas do criador, clique em (menu Ações) e selecione Criar ferramenta de agente conversacional.
A integração de aplicações verifica se as APIs necessárias estão ativadas. Caso contrário, é-lhe pedido que as ative.
No painel Criar ferramenta de agente de conversação, forneça as seguintes entradas:
1. Acionadores de API: todos os acionadores de API da sua integração estão selecionados por predefinição. Opcionalmente, pode desmarcar todos os acionadores de API que não quer incluir na ferramenta.
2. Tipo: selecione Criar novo agente conversacional e introduza os seguintes detalhes:
  1. Região: selecione a região do agente.
  2. Nome do agente: introduza um nome para o agente.
  3. Nome da ferramenta: introduza um nome para a ferramenta.
3. Conta de serviço: escolha uma conta de serviço com as funções e as autorizações necessárias para o acesso aos recursos do agente. Se estiverem em falta, é-lhe pedido que as conceda.
Clique em Ver especificação para rever a especificação gerada para os acionadores selecionados. Opcionalmente, pode editar a especificação antes de guardar.
Clique em Guardar.
É apresentada uma mensagem a indicar que a ferramenta foi criada com êxito. Clique em Ver para abrir o agente na consola de agentes conversacionais (Dialogflow CX).
Na consola de agentes conversacionais (Dialogflow CX), aceda a Playbooks, clique no playbook do agente criado e adicione instruções ao playbook para usar a ferramenta. Para mais informações, consulte o artigo Ferramentas do Playbook.

Crie uma ferramenta de agente conversacional com um agente existente

Para criar uma ferramenta de agente de conversação com um agente existente, siga estes passos:

Na Google Cloud Console, aceda à página Integração de aplicações.
Aceda à solução Application Integration
No menu de navegação, clique em Integrações.
A página Integrações é apresentada com todas as integrações disponíveis no projeto do Google Cloud.
Selecione uma integração existente ou clique em Criar integração para criar uma nova.
Se estiver a criar uma nova integração:
1. Introduza um nome e uma descrição no painel Criar integração.
2. Selecione uma região para a integração.
  Nota: o menu pendente Regiões apenas apresenta as regiões aprovisionadas no seu projeto do Google Cloud. Para aprovisionar uma nova região, clique em Ativar região. Consulte o artigo Ative uma nova região para mais informações.
3. Selecione uma conta de serviço para a integração. Pode alterar ou atualizar os detalhes da conta de serviço de uma integração em qualquer altura no painel Resumo da integração na barra de ferramentas de integração.
  Nota: a opção para selecionar uma conta de serviço é apresentada apenas se tiver ativado a gestão da integração para a região selecionada.
4. Clique em Criar.
  Esta ação abre a integração no editor de integração.
Selecione uma integração existente. Esta ação abre a integração no editor de integração.
Certifique-se de que a integração selecionada está configurada com um ou mais acionadores da API.
Publicar a versão da integração.
Na barra de ferramentas do criador, clique em (menu Ações) e selecione Criar ferramenta de agente conversacional.
A integração de aplicações verifica se as APIs necessárias estão ativadas. Caso contrário, é-lhe pedido que as ative.
No painel Criar ferramenta de agente de conversação, forneça as seguintes entradas:
1. Acionadores de API: todos os acionadores de API da sua integração estão selecionados por predefinição. Opcionalmente, pode desmarcar todos os acionadores de API que não quer incluir na ferramenta.
2. Tipo: selecione Escolher agente conversacional existente e faça o seguinte:
  1. Agente conversacional: é apresentada uma lista de agentes disponíveis no seu projeto. Selecione o agente que quer usar.
  2. Ferramenta: selecione Criar nova ferramenta ou Escolher ferramenta existente.
    Se selecionar Criar nova ferramenta, introduza um nome para a ferramenta.
    
    Se selecionar Escolher ferramenta existente, é apresentada uma lista de ferramentas disponíveis no agente selecionado. Selecione a ferramenta que quer usar.
3. Conta de serviço: escolha uma conta de serviço com as funções e as autorizações necessárias para o acesso aos recursos do agente. Se estiverem em falta, é-lhe pedido que as conceda.
Clique em Ver especificação para rever a especificação gerada para os acionadores selecionados. Opcionalmente, pode editar a especificação antes de guardar.
Clique em Guardar.
É apresentada uma mensagem a indicar que a ferramenta foi criada com êxito. Clique em Ver para abrir o agente na consola de agentes conversacionais (Dialogflow CX).
Na consola de agentes conversacionais (Dialogflow CX), aceda a Playbooks, clique no playbook do agente criado e adicione instruções ao playbook para usar a ferramenta. Para mais informações, consulte o artigo Ferramentas do Playbook.

Considerações

As seguintes considerações aplicam-se quando usa ferramentas de agente conversacional:

As ferramentas de agente conversacional só podem ser criadas para integrações publicadas com acionadores de API.
Reveja e teste o seu agente na consola de agentes conversacionais (Dialogflow CX) após a criação.