Registe e faça a gestão de agentes Dialogflow

Esta página descreve como registar e usar agentes do Dialogflow com o Gemini Enterprise.

Vista geral

Para usar um agente do Dialogflow com o Gemini Enterprise, tem primeiro de implementar e, em seguida, registar o seu agente. O registo do seu agente do Dialogflow associa o agente implementado ao Gemini Enterprise para que possam comunicar.

Antes de começar

Antes de registar o seu agente do Dialogflow, tem de garantir que estes passos estão concluídos:

Registe um agente do Dialogflow com o Gemini Enterprise

Pode registar o seu agente do Dialogflow com o Gemini Enterprise através da Google Cloud consola ou da API REST. O registo torna o seu agente disponível para os utilizadores numa app Gemini Enterprise.

Consola

Para registar um agente do Dialogflow através da Google Cloud consola, siga estes passos:

  1. Na Google Cloud consola, aceda à página Gemini Enterprise.

    Aceder ao Gemini Enterprise

  2. Selecione o seu projeto.

  3. Clique no nome da app na qual quer registar o agente.

  4. Clique em Agentes > Adicionar agentes. É apresentado o painel Escolha um tipo de agente.

  5. No cartão Agente personalizado através do Dialogflow, clique em Adicionar para registar o seu agente do Dialogflow no Gemini Enterprise. É aberto o painel Configuração.

  6. Para configurar o seu agente, siga estes passos:

    1. Introduza um nome no campo Nome do agente. Este valor aparece no Gemini Enterprise como o nome a apresentar do seu agente.

    2. Introduza uma descrição no campo Descreva o seu agente. Este valor é usado por um GML para determinar se deve invocar o seu agente em resposta a uma consulta do utilizador.

    3. Introduza o caminho do recurso do agente Dialogflow que quer registar no Gemini Enterprise no campo Origem do agente Dialogflow.

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

      A opção Disponibilidade do agente, quando selecionada, está definida por predefinição.

    4. Na secção Definições da ferramenta, introduza uma descrição no campo Descrição da ferramenta. Esta descrição é usada pelo MDG para compreender a finalidade da ferramenta e decidir quando a usar.

    5. Introduza o nome no campo Nome do parâmetro de entrada. Este é o nome do parâmetro para a chamada de função. Este nome de parâmetro dá uma sugestão ao MDG sobre o tipo de conteúdo que o parâmetro deve conter, como um question, um command ou um search_query.

    6. Introduza a descrição do campo Descrição do parâmetro de entrada. Esta é uma descrição dos parâmetros para a chamada de função. Esta descrição dá ao MDG mais informações sobre o parâmetro, como o tipo de conteúdo que se espera que seja transmitido e as ações que devem ser realizadas.

    7. Clique em Criar.

curl

Este exemplo de código demonstra como pode registar o seu 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 do seu projeto Google Cloud .
  • APP_ID: o ID da sua app Gemini Enterprise.
  • DISPLAY_NAME: o nome fácil de usar do seu agente que é apresentado no Gemini Enterprise.
  • DESCRIPTION: uma breve explicação do que o seu agente faz que é visível para os utilizadores no Gemini Enterprise. Por exemplo, extrair informações importantes das faturas carregadas para viagens de negócios.
  • ICON_URI: o URI público de um ícone que é apresentado junto ao nome do seu agente do Dialogflow. Também pode fornecer uma imagem codificada em Base64 em icon.content.
  • DIALOGFLOW_PROJECT_ID: o Google Cloud ID do projeto que identifica a localização do seu agente do Dialogflow.
  • DIALOGFLOW_LOCATION: a localização geográfica específica onde o seu agente Dialogflow está alojado, como global ou us-central1.
  • DIALOGFLOW_AGENT_ID: o identificador exclusivo do seu agente do Dialogflow.

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

Liste agentes associados a uma app

O seguinte exemplo de código demonstra como pode obter os detalhes de todos os agentes ligados à sua 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 para o seu pedido de API. Atribua um dos seguintes valores:
    • us- para a multirregião dos EUA
    • eu- para a multirregião da UE
    • global- para a localização global
    Para mais informações, consulte o artigo Especifique várias regiões para o seu repositório de dados.
  • PROJECT_ID: o ID do seu projeto Google Cloud .
  • LOCATION: a multirregião da sua app: global, us ou eu.
  • APP_ID: o ID da sua app Gemini Enterprise.

Se o seu agente não for pré-criado pela Google, a resposta inclui um campo name nas primeiras linhas. O valor deste campo contém o ID do agente no final do caminho. Por exemplo, na resposta seguinte, o ID do agente é 12345678901234567890:

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

Veja os detalhes de um agente Dialogflow

O seguinte exemplo de código demonstra como pode obter os detalhes de um agente registado 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 para o seu pedido de API. Atribua um dos seguintes valores:
    • us- para a multirregião dos EUA
    • eu- para a multirregião da UE
    • global- para a localização global
    Para mais informações, consulte o artigo Especifique várias regiões para o seu repositório de dados.
  • PROJECT_ID: o ID do seu projeto Google Cloud .
  • LOCATION: a multirregião da sua app: global, us ou eu.
  • APP_ID: o ID da sua app Gemini Enterprise.
  • AGENT_ID: o ID do agente. Pode encontrar o ID do agente listando os agentes associados à sua app.

Atualize um agente do Dialogflow

Pode atualizar todos os campos fornecidos durante o registo do agente. Os seguintes campos são obrigatórios durante o processo de atualização:

  • displayName
  • description
  • reasoning_engine

Quando atualiza um campo, todos os campos e respetivos valores têm de ser redefinidos no pedido de atualização, mesmo que não sejam feitas alterações a um campo específico.

Este exemplo de código demonstra como pode atualizar o registo do seu 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 do seu projeto Google Cloud .
  • AGENT_RESOURCE_NAME: o nome do recurso do registo do agente a ser atualizado.
  • DISPLAY_NAME:tO nome a apresentar do agente.
  • DESCRIPTION: a descrição do agente apresentada no Gemini Enterprise. A descrição destina-se apenas a ajudar o utilizador.
  • ICON_URI: o URI público de um ícone que é apresentado junto ao nome do seu agente do Dialogflow. Também pode fornecer uma imagem codificada em Base64 em icon.content.
  • REASONING_ENGINE_LOCATION: a localização na nuvem do motor de raciocínio no qual está a criar um agente.
  • DIALOGFLOW_AGENT_ID: o identificador exclusivo do seu agente do Dialogflow.

Elimine um agente do Dialogflow

O seguinte exemplo de código demonstra como pode eliminar um agente que está ligado à sua 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 para o seu pedido de API. Atribua um dos seguintes valores:
    • us- para a multirregião dos EUA
    • eu- para a multirregião da UE
    • global- para a localização global
    Para mais informações, consulte o artigo Especifique várias regiões para o seu repositório de dados.
  • PROJECT_ID: o ID do seu projeto Google Cloud .
  • LOCATION: a multirregião da sua app: global, us ou eu
  • APP_ID: o ID da sua app Gemini Enterprise.
  • AGENT_ID: o ID do agente. Pode encontrar o ID do agente listando os agentes associados à sua app.