Prompts do sistema

Um prompt é uma entrada de texto que determina como o modelo gera uma resposta. Existem dois tipos de prompts:

• Prompt do usuário: o texto do pedido do usuário final.
• Prompt do sistema: uma instrução em texto que define o comportamento do agente, incluindo seu objetivo, papel, estilo de comunicação e limitações.

O prompt do sistema influencia o contexto em que o agente interpreta os pedidos. Ele é enviado junto com cada solicitação ao modelo, tanto no widget incorporado quanto na API. Um prompt bem elaborado melhora a precisão e relevância das respostas.

Prompts do sistema permitem adaptar um agente para cenários específicos. Por exemplo:

• um especialista em determinado domínio;
• um assistente especializado;
• um personagem com estilo de comunicação específico.

Antes de implantar o agente em um projeto, você pode testá-lo no playground e refinar a instrução, se necessário.

Como adicionar um prompt do sistema

O método depende de como o agente será usado:

API compatível com OpenAI

Ao usar a API compatível com OpenAI, o prompt do sistema é fornecido em cada solicitação como uma mensagem com o papel sistema.

Widget e API nativa

Para o widget e a API nativa, o prompt do sistema é configurado no painel de controle. Você pode adicionar uma instrução:

• Ao criar o agente, selecionando um dos exemplos predefinidos ou digitando sua própria instrução:

• Posteriormente, na seção Área de Testes, nas configurações de um agente existente.

Diretrizes para prompts

Para criar a instrução mais eficaz, inclua os seguintes elementos-chave:

• quem é o agente (por exemplo, um agente de viagens ou especialista de suporte);
• seus objetivos (responder perguntas, validar dados fornecidos, recomendar serviços);
• quais dados ele deve usar (recursos específicos ou bases de conhecimento);
• suas limitações (quais tópicos pode tratar e quais idiomas pode usar).

1. Identidade do agente

Defina a identidade do agente especificando seu nome, tarefas e área de especialização.

Exemplo bom:

Seu nome é Hosti. Você é um assistente virtual que ajuda usuários a encontrar respostas na documentação do Hostman e fornece recomendações especializadas com base nela.

Exemplo ruim:

Você é um assistente virtual no site do Hostman.

2. Objetivo do agente

Defina os objetivos:

• especifique o principal objetivo do agente;
• liste suas responsabilidades e escopo;
• descreva prioridades, tipo de assistência e limitações.

Exemplo bom:

Sua principal tarefa é ajudar os usuários a entender e utilizar os serviços do Hostman. Você deve fornecer respostas precisas, claras e completas com base na documentação do Hostman.

Exemplo ruim:

Responder perguntas sobre os serviços do Hostman.

3. Especialização do agente

A especialização define os tópicos e áreas onde o agente pode fornecer respostas precisas e relevantes.

Use uma linguagem clara e:

• descreva capacidades específicas do agente;
• especifique em quais dados e bases de conhecimento ele deve confiar;
• ensine o agente a fornecer exemplos ao explicar tópicos complexos, usando fontes verificadas e evitando exemplos inventados;
• instrua o agente a fornecer instruções passo a passo, formatando-as com tabelas ou blocos de código quando apropriado.

Exemplo bom:

Você é especialista nos serviços e na resolução de problemas do Hostman. Seu foco principal são bancos de dados na nuvem, servidores na nuvem e Kubernetes.

Use a documentação do Hostman como fonte principal e os guias do Hostman como fonte secundária. Seu conhecimento deve se basear primeiro na documentação e depois nos guias.

Nunca invente informações.

Ao responder perguntas técnicas, forneça instruções passo a passo e use exemplos da documentação ou dos guias do Hostman. Utilize tabelas quando ajudarem a apresentar informações de forma clara.

Exemplo ruim:

Você sabe tudo sobre a plataforma Hostman com base em sua documentação. Não invente respostas. Adicione exemplos quando necessário.

4. Tópicos e estilo de comunicação

Defina o escopo de tópicos e o estilo de comunicação:

• especifique sobre o que o agente pode falar e quais tópicos são restritos;
• indique o idioma principal e os idiomas suportados;
• defina o tom e estilo de comunicação necessários.

Exemplo bom:

Forneça respostas apenas com base na documentação e nos guias do Hostman. Não discuta questões legais nem trate reclamações; nesses casos, direcione o usuário para o suporte.

Você entende e se comunica em inglês, alemão, francês, espanhol, italiano, holandês e português brasileiro. Se um usuário contatá-lo em outro idioma, peça educadamente que reformule o pedido em um dos idiomas suportados.

Comunique-se de maneira educada e amigável.

Exemplo ruim:

Não responda perguntas legais ou reclamações. Comunique-se apenas em inglês. Seja educado.

5. Limitações do agente

Defina claramente como o agente deve agir se não souber responder:

• O agente deve reconhecer quando não sabe a resposta.
• O agente deve fazer perguntas de esclarecimento se o pedido estiver incompleto ou não for claro.
• O agente deve direcionar os usuários para a documentação ou suporte quando necessário.

Exemplo bom:

Se você não souber a resposta, diga: "Não tenho informações suficientes para responder a esta pergunta. Ficarei feliz em ajudar com outra coisa."

Se o pedido estiver incompleto, peça esclarecimentos: "Por favor, forneça mais detalhes sobre o que você gostaria de fazer."

Se tiver dúvidas, informe claramente e recomende consultar a documentação do Hostman ou contatar o suporte.

Exemplo ruim:

Se não puder responder, informe o usuário e forneça um link para a documentação.