Funções: system, developer, user e assistant
Nesta página
As quatro funções de mensagem
Cada mensagem enviada ao endpoint Chat Completions inclui um campo role que determina como o modelo Grok a interpreta. Compreender estas funções é essencial para estruturar as suas conversas e obter respostas de qualidade.
A API xAI reconhece quatro funções: system, developer, user e assistant. Cada uma tem uma posição e um uso específicos dentro do vetor de mensagens.
A função system (ou developer)
A mensagem system surge em primeiro lugar no vetor de mensagens. Define o comportamento global do modelo para toda a conversa: tom, formato de resposta, limites, personalidade, idioma, entre outros.
{
"role": "system",
"content": "You are a cybersecurity expert. Always respond in English, concisely and technically. If you do not know the answer, state it clearly."
}
A função developer é um alias para system. As duas são intercambiáveis na API xAI. A OpenAI introduziu developer para refletir melhor a intenção: estas são as instruções do programador, não do “sistema”.
Melhores práticas para a mensagem system
- Seja específico: “Responda no máximo em 3 frases” é mais eficaz do que “Seja conciso”
- Defina o formato: especifique se espera JSON, Markdown ou listas com marcadores
- Estabeleça limites: indique o que o modelo não deve fazer
- Forneça contexto: dê contexto empresarial (“Você é um assistente para uma clínica veterinária”)
A função user
As mensagens user representam a entrada do utilizador final. São as perguntas, pedidos ou instruções enviados pela pessoa que interage com a sua aplicação.
{
"role": "user",
"content": "What are the 3 most common web vulnerabilities?"
}
Uma mensagem user pode aparecer em qualquer lugar da conversa após a mensagem system. Numa conversa com várias intervenções, alterna tipicamente entre mensagens user e assistant.
A função assistant
As mensagens assistant representam as respostas anteriores do modelo. Quando reenvia um histórico de conversação, cada resposta do Grok é marcada com esta função.
{
"role": "assistant",
"content": "The three most common web vulnerabilities are:\n1. SQL Injection\n2. Cross-Site Scripting (XSS)\n3. Broken Authentication"
}
Pode também utilizar a função assistant para few-shot prompting: injetar exemplos de respostas desejadas antes da mensagem real do utilizador.
{
"messages": [
{"role": "system", "content": "Classify the sentiment: positive, negative, or neutral."},
{"role": "user", "content": "I love this product!"},
{"role": "assistant", "content": "positive"},
{"role": "user", "content": "Customer service is deplorable."},
{"role": "assistant", "content": "negative"},
{"role": "user", "content": "The delivery arrived yesterday."}
]
}
Neste exemplo, as duas primeiras trocas user/assistant servem de demonstração. O modelo compreende o formato esperado e aplicará a mesma lógica à terceira mensagem.
Estrutura completa do pedido
Eis um pedido típico que combina as três funções numa conversa com várias intervenções:
{
"model": "grok-4.20-0309-reasoning",
"messages": [
{
"role": "system",
"content": "You are a teaching assistant specialized in mathematics. Explain concepts step by step."
},
{
"role": "user",
"content": "What is a derivative?"
},
{
"role": "assistant",
"content": "A derivative measures the instantaneous rate of change of a function..."
},
{
"role": "user",
"content": "Give me a concrete example."
}
]
}
A ordem é sempre a mesma: system em primeiro lugar, seguido de uma alternância entre user/assistant, sendo a última mensagem obrigatoriamente user (esta é a pergunta que o modelo deve responder).
Pontos-chave
- system/developer: instruções do programador, sempre em primeiro lugar, definem o comportamento global
- user: mensagens do utilizador final, desencadeiam a geração de respostas
- assistant: respostas anteriores do modelo, úteis para histórico e few-shot prompting
- As funções
systemedevelopersão intercambiáveis na API xAI - A última mensagem no vetor deve ser uma mensagem
user