Assistência de conhecimento generativa

O assistente de conhecimento generativo fornece respostas às perguntas do seu agente com base nas informações dos documentos que você fornece. É possível especificar seu nome de domínio ou fazer upload de documentos para um agente de repositório de dados baseado em fluxo ou em playbook. O assistente de conhecimento generativo sintetiza essas informações com a conversa em andamento e os metadados do cliente disponíveis para dar uma resposta mais relevante e oportuna ao seu agente.

Antes de começar

A menos que você seja o proprietário do projeto, precisará destes papéis para criar um agente de repositório de dados:

- Dialogflow API Admin
- Discovery Engine Admin

Criar um agente de repositório de dados baseado em fluxo

  1. Ative a API AI Applications no console do Vertex AI.

  2. Para criar o agente, siga as etapas em Agentes de repositório de dados baseados em fluxo.

Criar um agente de repositório de dados baseado em playbook

  1. Ative a API AI Applications no console do Vertex AI.

  2. Para criar o agente, siga as etapas em Agentes de repositório de dados baseados em playbook.

  3. Para conectar o agente a um repositório de dados, crie uma ferramenta de repositório de dados. Consulte Exemplos de ferramentas de repositório de dados de playbook para mais informações.

Responder a perguntas dos seus agentes humanos

O agente de repositório de dados baseado em fluxo ou em playbook pode responder às perguntas dos seus agentes humanos com base nos documentos que você forneceu.

Etapa 1: criar um perfil de conversa

Crie um perfil de conversa usando o console do Agent Assist ou a API.

Criar no console

  1. É necessário ativar o tipo de sugestão do assistente de conhecimento generativo e vinculá-lo ao agente de repositório de dados baseado em fluxo ou em playbook da etapa anterior.
  2. Opcional: use a caixa de seleção Desativar o registro de consultas de pesquisa do agente para indicar se você quer que o Google colete e armazene consultas de pesquisa editadas para uma possível melhoria de qualidade.
  3. Você pode usar a caixa de seleção Ativar consulta aumentada de conversa para indicar se quer considerar o contexto da conversa entre o agente humano e o usuário ao gerar a resposta para a consulta de pesquisa.

Criar na API

As etapas a seguir ilustram como criar um ConversationProfile com um objeto HumanAgentAssistantConfig. Também é possível realizar essas ações usando o console do Agent Assist.

Para criar um perfil de conversa, chame o método create no recurso ConversationProfile.

Antes de usar os dados da solicitação abaixo, faça estas substituições:
  • PROJECT_ID: ID do projeto
  • LOCATION_ID: o ID do seu local
  • AGENT_ID: o ID do agente de repositório de dados baseado em fluxo ou em playbook da etapa anterior
Confira a seguir um exemplo de JSON: 
  {
    "displayName": "my-conversation-profile-display-name",
    "humanAgentAssistantConfig": {
      "humanAgentSuggestionConfig": {
        "featureConfigs": [
          {
            "suggestionFeature": {
              "type": "KNOWLEDGE_SEARCH"
            },
            "queryConfig": {
              "dialogflowQuerySource": {
                "humanAgentSideConfig": {
                  "agent": "projects/PROJECT_ID/locations/LOCATION_ID/agents/AGENT_ID"
                }
              }
            },
            "disableAgentQueryLogging": false,
            "enableConversationAugmentedQuery": false,
          }
        ]
      }
    }
  }

Quando você cria um perfil de conversa no console do Agent Assist, o recurso de assistência de conhecimento generativo é ativado automaticamente.

Etapa 2: usar um agente de repositório de dados

Opcionalmente, use a SearchKnowledge API para receber as respostas do agente de repositório de dados. Também é possível usar as seguintes configurações como parte da solicitação SearchKnowledge:

  • querySource: defina esse campo para indicar se um agente digitou a consulta ou se o assistente de conhecimento generativo a sugeriu automaticamente.
  • exactSearch: defina esse campo para indicar se a consulta de entrada exata deve ser pesquisada sem reescrita.
  • endUserMetadata: defina esse campo para incluir mais informações sobre o usuário final que melhorem a resposta gerada. Para mais detalhes, consulte a página Personalização de desempenho do agente de repositório de dados.
  • searchConfig: defina esse campo para ter mais controle sobre como promover e filtrar documentos de conhecimento. Para mais detalhes, consulte a página Configuração de pesquisa de desempenho do agente de repositório de dados.

Antes de usar os dados da solicitação abaixo, faça estas substituições:

  • PROJECT_ID: ID do projeto
  • LOCATION_ID: o ID do seu local
  • CONVERSATION_PROFILE_ID: o ID do perfil de conversa da etapa anterior
  • SESSION_ID: o ID da sessão de pesquisa
    • O histórico de pesquisa da mesma sessão pode afetar o resultado da pesquisa. É possível usar o ID de conversa a seguir para o ID da sessão.
  • CONVERSATION_ID: a conversa (entre o agente humano e o usuário final) em que a solicitação de pesquisa é acionada
  • MESSAGE_ID: a mensagem de conversa mais recente quando a solicitação de pesquisa é acionada

Confira a seguir um exemplo de solicitação JSON:

{
  "parent": "projects/PROJECT_ID/locations/LOCATION_ID"
  "query": {
    "text": "What is the return policy?"
  }
  "conversationProfile": "projects/PROJECT_ID/locations/LOCATION_ID/conversationProfiles/CONVERSATION_PROFILE_ID"
  "sessionId": "SESSION_ID
  "conversation": "projects/PROJECT_ID/locations/LOCATION_ID/conversations/CONVERSATION_ID"
  "latestMessage": "projects/PROJECT_ID/locations/LOCATION_ID/conversations/CONVERSATION_ID/messages/MESSAGE_ID
  "querySource": AGENT_QUERY
  "exactSearch": false
  "searchConfig": {
    "filterSpecs": {
      "filter": "category: ANY(\"persona_B\")"
    }
  }
  "endUserMetadata": {
    "deviceOwned": "Google Pixel 7"
  }
}

Opcionalmente, forneça nomes de recursos conversation e latest_message se a pesquisa do agente acontecer durante uma conversa com um usuário. Esses dois campos são obrigatórios se você ativar a opção enable_conversation_augmented_query e preferir melhorar a experiência de resposta da consulta com o contexto conversacional entre o agente e o usuário.

Simulador

Teste o agente de repositório de dados baseado em fluxo ou em playbook no simulador do Agent Assist.

No exemplo anterior, o agente de repositório de dados baseado em fluxo responde à consulta do usuário What is the refund processing time? com as seguintes informações:

  • Resposta gerada por IA generativa: quando o pacote com sua devolução chegar ao centro de devolução do vendedor, pode levar até sete dias úteis adicionais para ser processado. Verifique o status do reembolso com o número de rastreamento da devolução encontrado na página de pedidos.
  • Título do documento de conhecimento relevante: Devoluções e reembolsos.

Enviar feedback

Para conferir as etapas de envio de feedback, acesse Enviar feedback ao Agent Assist.

Responder a perguntas do agente

Confira a seguir um exemplo de solicitação JSON para enviar feedback sobre como responder a perguntas do agente.

{
  "name": "projects/PROJECT_ID/locations/LOCATION_ID/answerRecords/ANSWER_RECORD_ID",
  "answerFeedback": {
    "displayed": true
    "clicked": true
    "correctnessLevel": "FULLY_CORRECT"
    "agentAssistantDetailFeedback": {
      "knowledgeSearchFeedback": {
        "answerCopied": true
        "clickedUris": [
          "url_1",
          "url_2",
          "url_3",
        ]
      }
    }
  }
}

Metadados

Se você configurar metadados para um documento de conhecimento, o assistente de conhecimento generativo e o Assistente proativo de conhecimento generativo vão retornar os metadados do documento junto com a resposta.

Por exemplo, é possível usar metadados para marcar se o documento de conhecimento é um artigo particular interno ou um artigo público externo. Nos módulos do simulador do Agent Assist e da interface, o assistente de conhecimento generativo e o assistente de conhecimento generativo proativo mostram automaticamente um valor de metadados do documento para determinadas chaves.

  • gka_source_label: o valor é mostrado diretamente no card de sugestão.
  • gka_source_tooltip: quando o valor é do tipo struct, manter o cursor sobre o link de origem expande e mostra o valor em uma dica de ferramenta.

Se você tiver os seguintes metadados para um documento de conhecimento, o card de sugestão vai listar a origem como External Doc e a dica de ferramenta vai adicionar doc_visibility: public doc.

Metadados: None { "title": "Public Sample Doc", "gka_source_label": "External Doc", "gka_source_tooltip": { "doc_visibility": "public doc" } }

Metadados do usuário final

Anexe metadados do usuário final para melhorar e personalizar a resposta gerada pelo agente do Datastore. Para o assistente de conhecimento generativo, é possível anexar metadados do usuário final ao campo end_user_metadata ou ingerir esses dados em uma conversa com a API IngestContextReferences. É possível usar metadados do usuário final ingeridos para o assistente de conhecimento generativo e o assistente proativo de conhecimento generativo.

Exemplo 1: anexar metadados do usuário final

{
  "query": {
     "text": "test query"
  },
  "conversationProfile": "projects/PROJECT_ID/locations/LOCATION_ID/conversationProfiles/CONVERSATION_PROFILE_ID",
  "sessionId": "SESSION_ID",
  "conversation": "projects/PROJECT_ID/locations/LOCATION_ID/conversations/CONVERSATION_ID",
  "querySource": "AGENT_QUERY",
  "endUserMetadata": {
    "Name": "Jack",
    "Age": 33,
    "City": "Tokyo"
  }
}

Exemplo 2: ingerir metadados do usuário final

{
  "conversation": "projects/PROJECT_ID/locations/global/conversations/CONVERSATION_ID",
  "contextReferences": {
   "gka_end_user_metadata": {
      "contextContents": [{
"content": "{\"Name\":\"Jack\",\"Age\":33,\"city\":\"Tokyo\"}",
        "contentFormat": "JSON"
      }],
      "updateMode": "OVERWRITE",
      "languageCode": "en-US"
    }
  }
}

Para mais detalhes sobre metadados do usuário final no repositório de dados, consulte as informações sobre a personalização do Dialogflow.

Suporte ao idioma

Confira a lista completa de idiomas disponíveis.