Registrar e gerenciar agentes do Dialogflow

Nesta página, descrevemos como registrar e usar agentes do Dialogflow com o Gemini Enterprise.

Visão geral

Para usar um agente do Dialogflow com o Gemini Enterprise, primeiro implante e registre o agente. O registro do agente do Dialogflow vincula o agente implantado ao Gemini Enterprise para que eles possam se comunicar.

Antes de começar

Antes de registrar o agente do Dialogflow, verifique se estas etapas foram concluídas:

  • Implante o agente do Dialogflow. Para conferir o painel do Dialogflow e dos agentes de conversação, consulte Agentes de conversação.

  • O papel de administrador do Gemini Enterprise.

  • Ative a API Discovery Engine. Para ativar a API Discovery Engine para o Google Cloud projeto, no Google Cloud console, acesse a página API Discovery Engine.

    Acessar a API Discovery Engine

  • Crie um app do Gemini Enterprise. Para mais informações, consulte Criar um app.

Registrar um agente do Dialogflow com o Gemini Enterprise

É possível registrar o agente do Dialogflow com o Gemini Enterprise usando o Google Cloud console do ou a API REST. O registro disponibiliza o agente para os usuários em um app do Gemini Enterprise.

Console

Para registrar um agente do Dialogflow usando o Google Cloud console, siga estas etapas:

  1. No Google Cloud console do, acesse a página Gemini Enterprise.

    Acessar o Gemini Enterprise

  2. Selecione o projeto.

  3. Clique no nome do app em que você quer registrar o agente.

  4. Clique em Agentes > Adicionar agentes. O painel Escolher um tipo de agente aparece.

  5. No card Agente personalizado via Dialogflow, clique em Adicionar para registrar o agente do Dialogflow com o Gemini Enterprise. O painel Configuração é aberto.

  6. Para configurar o agente, siga estas etapas:

    1. Insira um nome no campo Nome do agente. Esse valor aparece no Gemini Enterprise como o nome de exibição do agente.

    2. Insira uma descrição no campo Descreva seu agente. Esse valor é usado por um LLM para determinar se o agente deve ser invocado em resposta a uma consulta do usuário.

    3. Insira o caminho do recurso do agente do Dialogflow que você quer registrar no Gemini Enterprise no campo Origem do agente do Dialogflow.

      Use este formato: projects/{project}/locations/{location}/agents/{agent}

      A opção Disponibilidade do agente, Quando selecionado, é definida por padrão.

    4. Clique em Criar.

curl

Este exemplo de código demonstra como registrar o agente:

  curl -X POST \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    -H "X-Goog-User-Project: PROJECT_ID" \
    "https://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/assistants/default_assistant/agents" \
    -d '{
      "displayName": "DISPLAY_NAME",
      "description": "DESCRIPTION",
      "icon": {
        "uri": "ICON_URI"
      },
      "dialogflowAgentDefinition": {
        "dialogflowAgent": "projects/DIALOGFLOW_PROJECT_ID/locations/DIALOGFLOW_LOCATION/agents/DIALOGFLOW_AGENT_ID"
      }
    }'

Substitua as variáveis por valores:

  • PROJECT_ID: o ID doprojeto. Google Cloud
  • APP_ID: o ID do app do Gemini Enterprise.
  • DISPLAY_NAME: o nome amigável do agente que aparece no Gemini Enterprise.
  • DESCRIPTION: uma breve explicação do que o agente faz visível para os usuários no Gemini Enterprise. Por exemplo, Extrair informações importantes de faturas enviadas para viagens de negócios.
  • ICON_URI: o URI público de um ícone que aparece ao lado de seu nome de agente do Dialogflow. Também é possível fornecer uma imagem codificada em Base64 em icon.content.
  • DIALOGFLOW_PROJECT_ID: o ID do projeto que identifica o local do agente do Dialogflow. Google Cloud
  • DIALOGFLOW_LOCATION: a localização geográfica específica em que o agente do Dialogflow está hospedado, como global ou us-central1.
  • DIALOGFLOW_AGENT_ID: o identificador exclusivo do seu agente do Dialogflow.

A resposta bem-sucedida a esse comando retorna todos os campos do recurso do agente do Dialogflow recém-criado, que inclui o nome do recurso exclusivo no campo "name". Esse nome de recurso pode ser usado para atualizações ou referências futuras.

Listar agentes conectados a um app

O exemplo de código a seguir demonstra como receber os detalhes de todos os agentes conectados ao app:

REST 

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID/assistants/default_assistant/agents"

Substitua as variáveis por valores:

  • ENDPOINT_LOCATION: a multirregião da sua solicitação de API. Especifique um dos seguintes valores:
    • us para a multirregião dos EUA
    • eu para a multirregião da UE
    • global para o local global
    Para mais informações, consulte Especificar uma multirregião para seu repositório de dados.
  • PROJECT_ID: o ID doprojeto. Google Cloud
  • LOCATION: a multirregião do app: global, us ou eu.
  • APP_ID: o ID do app do Gemini Enterprise.

Se o agente não for pré-criado pelo Google, a resposta vai incluir um campo name nas primeiras linhas. O valor desse campo contém o ID do agente no final do caminho. Por exemplo, na resposta a seguir, o ID do agente é 12345678901234567890:

{
"name": "projects/123456/locations/global/collections/default_collection/engines/my-app/assistants/default_assistant/agents/12345678901234567890",
...
}

Conferir detalhes de um agente do Dialogflow

O exemplo de código a seguir demonstra como recuperar os detalhes de um agente registrado no Gemini Enterprise:

REST 

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID/assistants/default_assistant/agents/AGENT_ID"

Substitua as variáveis por valores:

  • ENDPOINT_LOCATION: a multirregião da sua solicitação de API. Especifique um dos seguintes valores:
    • us para a multirregião dos EUA
    • eu para a multirregião da UE
    • global para o local global
    Para mais informações, consulte Especificar uma multirregião para seu repositório de dados.
  • PROJECT_ID: o ID doprojeto. Google Cloud
  • LOCATION: a multirregião do app: global, us ou eu.
  • APP_ID: o ID do app do Gemini Enterprise.
  • AGENT_ID: o ID do agente. É possível encontrar o ID do agente por listar os agentes conectados ao app.

Atualizar um agente do Dialogflow

Todos os campos fornecidos durante o registro do agente podem ser atualizados. Os campos a seguir são obrigatórios durante o processo de atualização:

  • displayName
  • description
  • reasoning_engine

Ao atualizar um campo, todos os campos e valores precisam ser redefinidos na solicitação de atualização, mesmo que nenhuma mudança seja feita em um campo específico.

Este exemplo de código demonstra como atualizar o registro do agente do Dialogflow:

curl 

  curl -X PATCH \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    -H "X-Goog-User-Project: PROJECT_ID" \
  "https://discoveryengine.googleapis.com/v1alpha/AGENT_RESOURCE_NAME" \
    -d '{
      "displayName": "DISPLAY_NAME",
      "description": "DESCRIPTION",
      "icon": {
        "uri": "ICON_URI"
      },
      "dialogflowAgentDefinition": {
        "dialogflowAgent": "projects/PROJECT_ID/locations/REASONING_ENGINE_LOCATION/agents/DIALOGFLOW_AGENT_ID"
      }
    }'

Substitua as variáveis por valores:

  • PROJECT_ID: o ID doprojeto. Google Cloud
  • AGENT_RESOURCE_NAME: o nome do recurso do registro do agente a ser atualizado.
  • DISPLAY_NAME:o nome de exibição do agente.
  • DESCRIPTION: a descrição do agente que aparece no Gemini Enterprise. A descrição é apenas para o benefício do usuário.
  • ICON_URI: o URI público de um ícone que aparece ao lado de seu nome de agente do Dialogflow. Também é possível fornecer uma imagem codificada em Base64 em icon.content.
  • REASONING_ENGINE_LOCATION: o local na nuvem do mecanismo de raciocínio em que você está criando um agente.
  • DIALOGFLOW_AGENT_ID: o identificador exclusivo do seu agente do Dialogflow.

Excluir um agente do Dialogflow

O exemplo de código a seguir demonstra como excluir um agente conectado ao app:

REST 

curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID/assistants/default_assistant/agents/AGENT_ID"

Substitua as variáveis por valores:

  • ENDPOINT_LOCATION: a multirregião da sua solicitação de API. Especifique um dos seguintes valores:
    • us para a multirregião dos EUA
    • eu para a multirregião da UE
    • global para o local global
    Para mais informações, consulte Especificar uma multirregião para seu repositório de dados.
  • PROJECT_ID: o ID doprojeto. Google Cloud
  • LOCATION: a multirregião do app: global, us ou eu
  • APP_ID: o ID do app do Gemini Enterprise.
  • AGENT_ID: o ID do agente. É possível encontrar o ID do agente por listar os agentes conectados ao app.