Oriente o comportamento do agente com contexto criado

Esta página descreve a estrutura recomendada para escrever comandos eficazes para os agentes de dados da API Conversational Analytics. Estes comandos são contexto criado que define como strings através do parâmetro system_instruction. As instruções do sistema bem estruturadas podem melhorar a precisão e a relevância das respostas fornecidas pela API.

Para ver exemplos de contexto criado em diferentes ambientes, consulte as seguintes páginas de documentação:

O que são instruções do sistema?

As instruções do sistema são orientações definidas pelo utilizador que os programadores podem fornecer para moldar o comportamento de um agente de dados e refinar as respostas da API. As instruções do sistema fazem parte do contexto que a API usa para responder a perguntas. Este contexto também inclui origens de dados associadas (tabelas do BigQuery, explorações do Looker, origens de dados do Looker Studio) e o histórico de conversas (para conversas com várias interações).

Ao fornecer orientações claras e estruturadas através de instruções do sistema, pode melhorar a capacidade do agente de interpretar as perguntas dos utilizadores e gerar respostas úteis e precisas. As instruções do sistema bem definidas são especialmente úteis se estiver a estabelecer ligação a dados, como tabelas do BigQuery, onde pode não existir uma camada semântica predefinida, como acontece com uma análise detalhada do Looker.

Por exemplo, pode usar instruções do sistema para fornecer os seguintes tipos de orientações a um agente:

  • Lógica específica da empresa: defina um cliente "fiel" como um cliente que fez mais de cinco compras num determinado período.
  • Formatação de respostas: resuma todas as respostas do seu agente de dados em 20 palavras ou menos para poupar tempo aos utilizadores.
  • Apresentação de dados: formate todos os números de acordo com o guia de estilo da empresa.

Forneça instruções do sistema

Pode fornecer instruções do sistema à API Conversational Analytics como uma string formatada em YAML através do parâmetro system_instruction. Embora o parâmetro system_instruction seja opcional e a estrutura seja da sua responsabilidade, é recomendável fornecer instruções do sistema bem estruturadas para receber respostas precisas e relevantes.

Pode definir a string formatada em YAML no seu código durante a configuração inicial, conforme mostrado em Configure as definições iniciais e a autenticação (HTTP) ou Especifique o projeto de faturação e as instruções do sistema (SDK Python). Em seguida, pode incluir o parâmetro system_instruction nas seguintes chamadas da API: