Criar agentes de conversação com a Application Integration

Application Integration agora simplifica a criação de experiências de conversação com a integração direta aos Agentes de conversação (Dialogflow CX). Com esse recurso, você pode criar ferramentas e chatbots inteligentes que melhoram as interações com os usuários e automatizam tarefas diretamente nos fluxos de trabalho de integração usando acionadores de API.

O que é um agente de conversação?

Um agente de conversação (Dialogflow CX) é um agente virtual que se comunica com os usuários em linguagem natural. Ele analisa a entrada do usuário, interpreta a intenção e fornece respostas adequadas, permitindo experiências de conversa interativas e personalizadas. Esses agentes 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 que o agente de conversação pode acessar. As ferramentas são definidas nos playbooks e permitem que o agente realize ações como recuperar dados, executar APIs ou interagir com sistemas externos. Application Integration gera essas ferramentas com base nos acionadores de API da integração, facilitando a conexão da lógica de integração com os fluxos de conversa.

Antes de começar

Antes de criar uma ferramenta de agente de conversação usando Application Integration, verifique o seguinte:

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 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 do 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ção usando Application Integration, siga estas etapas:

No console do Google Cloud, acesse a página Application Integration.
Acessar o Application Integration
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.
Selecione uma integração ou clique em Criar integração para criar uma nova.
Se você estiver criando uma nova integração:
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 Resumo da integração na barra de ferramentas de integração.
  Observação:a opção de selecionar uma conta de serviço só vai aparecer 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.
Selecione uma integração. Isso abre a integração na página do editor de integração.
Verifique se a integração selecionada está configurada com um ou mais acionadores de API.
Publicar a versão da integração.
Na barra de ferramentas do designer, clique em (menu "Ações") e selecione Criar ferramenta de agente de conversação.
Application Integration verifica se as APIs necessárias estão ativadas. Caso contrário, você vai receber uma solicitação para ativar.
No painel Criar ferramenta de agente de conversação, forneça as seguintes entradas:
1. Gatilho da API: todos os acionadores da API da sua integração são selecionados por padrão. Você pode desmarcar os acionadores de API que não quer incluir na ferramenta.
2. Tipo: selecione Criar um 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.
3. Conta de serviço: escolha uma conta de serviço com os papéis e as permissões necessários para o acesso aos recursos do agente. Se estiverem faltando, você vai precisar conceder.
Clique em Conferir especificação para revisar a especificação gerada dos acionadores selecionados. Você pode editar a especificação antes de salvar.
Clique em Salvar.
Uma mensagem vai aparecer indicando que a ferramenta foi criada. Clique em Visualizar para abrir o agente no console dos agentes de conversação (Dialogflow CX).
No console dos agentes de conversação (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 de playbook.

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

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

No console do Google Cloud, acesse a página Application Integration.
Acessar o Application Integration
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.
Selecione uma integração ou clique em Criar integração para criar uma nova.
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 Resumo da integração na barra de ferramentas de integração.
  Observação:a opção de selecionar uma conta de serviço só vai aparecer 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.
Selecione uma integração. Isso abre a integração na página do editor de integração.
Verifique se a integração selecionada está configurada com um ou mais acionadores de API.
Publicar a versão da integração.
Na barra de ferramentas do designer, clique em (menu "Ações") e selecione Criar ferramenta de agente de conversação.
Application Integration verifica se as APIs necessárias estão ativadas. Caso contrário, você vai receber uma solicitação para ativar.
No painel Criar ferramenta de agente de conversação, forneça as seguintes entradas:
1. Gatilho da API: todos os acionadores da API da integração são selecionados por padrão. Você pode desmarcar os acionadores de API que não quer incluir na ferramenta.
2. Tipo: selecione Escolher agente de conversação atual e faça o seguinte:
  1. Agente de conversação: uma lista de agentes disponíveis no projeto aparece. Selecione o agente que você quer usar.
  2. Ferramenta: selecione Criar nova ferramenta ou Escolher ferramenta.
    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 de serviço com os papéis e as permissões necessários para o acesso aos recursos do agente. Se estiverem faltando, você vai precisar conceder.
Clique em Conferir especificação para revisar a especificação gerada dos acionadores selecionados. Você pode editar a especificação antes de salvar.
Clique em Salvar.
Uma mensagem vai aparecer indicando que a ferramenta foi criada. Clique em Visualizar para abrir o agente no console dos agentes de conversação (Dialogflow CX).
No console dos agentes de conversação (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 agentes de conversação:

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 dos agentes de conversação (Dialogflow CX) após a criação.