Ir para o conteúdo principal
Português— Escolher um idioma
Menu

Funções: system, developer, user e assistant

Aula 2 de 12 Atualizada a 30 de julho de 2026 Programador
Nesta página
  1. As quatro funções de mensagem
  2. A função system (ou developer)
  3. A função user
  4. A função assistant
  5. Estrutura completa do pedido
  6. Pontos-chave

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 system e developer são intercambiáveis na API xAI
  • A última mensagem no vetor deve ser uma mensagem user