Funções: System, User, Assistant
Nesta página
O Sistema de Funções do Grok
As conversas com o Grok giram em torno de três funções distintas que estruturam a troca. Cada mensagem enviada ao modelo transporta uma função que indica o seu papel na conversa. Compreender estas funções é essencial para escrever prompts eficazes e obter respostas consistentes.
A API do Grok utiliza um formato de mensagem onde cada entrada é um objeto contendo um campo role e um campo content. Esta arquitetura permite-lhe controlar o comportamento do modelo com precisão.
A Função System (ou Developer)
A mensagem de sistema é a primeira mensagem da conversa. Define o comportamento global do modelo: a sua personalidade, restrições, área de especialização e as regras que deve seguir durante toda a troca.
{
"role": "system",
"content": "You are a cybersecurity expert. You always respond in English, concisely. You cite sources when relevant. You refuse to provide instructions for carrying out attacks."
}
O Grok também aceita a função developer como um alias para system. As duas são intercambiáveis e produzem o mesmo efeito.
O Que Incluir na Mensagem de Sistema
- Identidade: quem é o modelo nesta conversa (especialista, assistente, tradutor…)
- Restrições: idioma, formato de resposta, comprimento, tom
- Proibições: o que o modelo não deve fazer
- Contexto de negócio: o domínio, termos técnicos a utilizar
Melhores Práticas
- Coloque sempre a mensagem de sistema em primeiro lugar
- Seja exaustivo desde o início: é mais eficaz especificar tudo na mensagem de sistema do que a meio da conversa
- Utilize secções claras (com travessões ou títulos) para organizar as suas instruções
A Função User
As mensagens user representam as intervenções do utilizador humano. Esta é a função mais intuitiva: contém as suas perguntas, pedidos e dados de entrada.
{
"role": "user",
"content": "Analyze this network architecture and identify the three most critical vulnerabilities."
}
O conteúdo de uma mensagem de utilizador pode ser uma simples cadeia de texto ou um vetor de objetos para combinar texto e imagens (abordaremos isto na lição 4).
Dicas para Mensagens de Utilizador
- Formule um pedido por mensagem, sempre que possível
- Se tiver vários pedidos relacionados, numere-os
- Forneça os dados necessários diretamente na mensagem
A Função Assistant
As mensagens assistant contêm as respostas do modelo. Normalmente, não as escreve você mesmo: o Grok gera-as. No entanto, pode incluí-las no seu histórico de conversação para orientar o modelo.
{
"role": "assistant",
"content": "Here are the three identified vulnerabilities: ..."
}
Por Que Pré-Preencher Mensagens de Assistant?
Incluir mensagens falsas de assistente no seu histórico é uma técnica poderosa:
- Orientar o estilo: mostrar ao modelo o formato de resposta esperado
- Manter a consistência: simular uma conversa passada para que o modelo continue no mesmo tom
- Few-shot em contexto: criar pares de pergunta/resposta como exemplos
O Impacto da Estrutura de Funções
A ordem e a organização das mensagens influenciam diretamente a qualidade da resposta. Eis a estrutura recomendada:
[
{"role": "system", "content": "Global instructions..."},
{"role": "user", "content": "First user message..."},
{"role": "assistant", "content": "Model response..."},
{"role": "user", "content": "Next message..."}
]
O endpoint Chat Completions do Grok é stateless: não mantém histórico entre pedidos. Deve incluir todo o contexto conversacional em cada chamada. Isto significa que, se quiser uma conversa de 5 turnos, o seu 5.º pedido deve conter os 4 turnos anteriores.
Prática Guiada
Teste o impacto da mensagem de sistema enviando a mesma pergunta com duas configurações diferentes:
Configuração A:
[
{"role": "system", "content": "You are a math teacher for high school seniors."},
{"role": "user", "content": "Explain limits."}
]
Configuração B:
[
{"role": "system", "content": "You are a senior software engineer specialized in distributed systems."},
{"role": "user", "content": "Explain limits."}
]
A mesma pergunta produz duas respostas radicalmente diferentes dependendo da função de sistema definida. O professor falará sobre limites matemáticos, o engenheiro sobre limitação de taxa e quotas.
Pontos-chave
- Três funções estruturam as conversas:
system(oudeveloper),usereassistant - A mensagem de sistema define o comportamento global e deve ser colocada em primeiro lugar
- A API é stateless: inclua todo o histórico em cada pedido
- Pré-preencher mensagens de assistente permite-lhe orientar o estilo e o formato da resposta
- Uma mensagem de sistema bem escrita é frequentemente mais eficaz do que múltiplas correções a meio da conversa