Visão geral do serviço de feedback

O serviço de feedback da Gemini Enterprise Agent Platform permite coletar e analisar o feedback dos usuários sobre as interações com seus agentes. Ele fornece a infraestrutura necessária, eliminando a necessidade de manter seu próprio banco de dados de feedback. O serviço armazena as reações dos usuários e as vincula às linhas do tempo dos eventos de conversa correspondentes.

Para começar a coletar feedback dos usuários finais sobre seu agente, integre diretamente com a API do serviço de feedback ou use o SDK. A API e o SDK permitem gerenciar entradas de feedback usando operações CRUDL padrão (criar, recuperar, atualizar, excluir e listar) e anexar mais detalhes da conversa às entradas de feedback usando o recurso FeedbackContext.

Para mais informações, consulte Gerenciar feedback com o SDK do Python ou a API REST ou Ver feedback no console.

Principais conceitos

  • Entrada de feedback:rastreia dados qualitativos discretos fornecidos por um usuário final. Cada entrada captura um sentimento binário, rótulos de feedback específicos e texto livre opcional.
  • Tipo de feedback:o sentimento binário do usuário final, representado por thumbs_up e thumbs_down.
  • ID da sessão (session_id) e ID do evento (event_id): campos obrigatórios que conectam o feedback a uma conversa ou evento específico.
  • Contexto do feedback:um recurso opcional anexado a uma entrada de feedback que armazena transcrições ou registros de conversas, preservando o contexto mesmo que a sessão original seja excluída. Esse recurso pode armazenar a conversa inteira ou as mensagens selecionadas pelo usuário, dependendo do que você escolher incluir.
  • Rótulo de feedback:uma classificação que especifica a natureza de um problema operacional ou um resultado bem-sucedido.
    • Os rótulos de feedback positivo (normalmente usados com thumbs_up) incluem:
      • accurate
      • complete
      • helpful
      • on_topic
      • fast
      • safe
      • factual
      • tool_success
    • Os rótulos de feedback negativo (normalmente usados com thumbs_down) incluem:
      • inaccurate
      • incomplete
      • unhelpful
      • off_topic
      • too_slow
      • unsafe
      • hallucination
      • tool_error

Antes de começar

Para usar o serviço de feedback, você precisa do seguinte:

Ter os papéis necessários

Para receber as permissões necessárias para usar o serviço de feedback, peça ao administrador para conceder a você os seguintes papéis do IAM no projeto:

Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias usando papéis personalizados ou outros papéis predefinidos.

Se você estiver fazendo solicitações ao serviço de feedback do Google Cloud, verifique se a conta de serviço tem as permissões necessárias. As contas de serviço gerenciadas pelo usuário precisam ter a permissão Usuário da Agent Platform (aiplatform.user) para interagir com o serviço de feedback.

O agente de serviço do mecanismo de raciocínio já tem as permissões necessárias para gerenciar o feedback. Portanto, as solicitações de saída do Agent Runtime já devem ter permissão para acessar o serviço de feedback.

A seguir