Papéis de sistema, usuário e assistente
Compreenda os três papéis das mensagens nas APIs modernas de conversa e como eles afetam aquilo em que o modelo confia e que ele obedece.
Papéis de sistema, usuário e assistente é uma aula grátis de AI Agents no CoddyKit. Esta é a aula 2 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de AI Agents, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de AI Agents inclui 4 aulas no total.
Três funções, uma conversa
Toda API de conversa usa três funções de mensagem:
- sistema — metainstruções, persona e regras
- usuário — entrada do ser humano ou de um sistema anterior
- assistente — saída do modelo
Por que existem funções
Os modelos são treinados para tratar essas funções de maneira diferente. A função do sistema recebe o maior nível de confiança; as mensagens do usuário recebem o menor.
É assim que o modelo sabe que suas instruções têm prioridade sobre o que um @attacker digita na entrada do usuário.
O espaço do sistema é seu
A mensagem do sistema é o seu contrato com o modelo. Coloque aqui:
- Identidade e objetivo
- Regras rígidas (nunca revele X, sempre faça Y)
- Requisitos do formato da saída
- Política de uso de ferramentas
Mantenha o sistema estável e o usuário dinâmico
A mensagem do sistema raramente deve mudar durante uma sessão. Tudo o que muda a cada turno deve ficar nas mensagens do usuário.
Esse padrão também permite o armazenamento em cache de instruções — consulte o curso de Otimização de custos.
Exemplo: um agente de atendimento ao cliente
Uma configuração típica:
messages = [
{'role': 'system', 'content': '''
You are SupportBot, the customer-support agent for Acme Corp.
You help with order status, returns, and product info.
You never share internal pricing or roadmap info.
Answer in 2-3 sentences. Use the search_orders tool when asked about orders.
'''},
{'role': 'user', 'content': 'Where is my order #1234?'},
]
for m in messages:
print(f"[{m['role']}] {m['content'].strip()}")
Várias mensagens do sistema
A maioria das APIs aceita apenas uma mensagem do sistema. Se precisar organizar as instruções em camadas, concatene-as ou use seções XML separadas dentro do conteúdo do sistema.
Mensagens do assistente e memória
Os turnos anteriores do assistente fazem parte do contexto. O modelo vê a própria saída anterior e mantém a consistência.
É por isso que um "sim, seguirei suas regras" dito pelo modelo em um turno anterior o incentiva a realmente segui-las.
Preenchimento prévio do turno do assistente (Anthropic)
Anthropic permite que você inicie a mensagem do assistente com um texto que o modelo continuará:
messages = [
{'role': 'user', 'content': 'Return a JSON object with name and age.'},
{'role': 'assistant', 'content': '{'}
]
# The model continues from '{', forcing JSON output.
for m in messages:
print(f"{m['role']}: {m['content']}")
print("The model continues from '{', forcing JSON output.")
A função da ferramenta
As APIs modernas adicionam uma quarta função: tool (OpenAI) ou blocos de conteúdo com tool_result (Anthropic).
Você acrescenta uma mensagem de ferramenta depois de executar uma função solicitada pelo modelo.
Erros ao misturar funções
Erros comuns:
- Colocar os resultados de ferramentas nas mensagens do usuário — isso confunde a hierarquia de confiança
- Esquecer de enviar tool_call_id — erros da API
- Duas mensagens consecutivas do usuário ou do assistente — a maioria das APIs rejeita isso
A hierarquia das instruções
OpenAI publica uma especificação de modelo que diz:
"Em caso de conflito, o modelo deve seguir a instrução mais alta na hierarquia: plataforma > desenvolvedor (sistema) > usuário > ferramenta."
Anthropic oferece orientações semelhantes. O espaço do sistema prevalece.
Espaços das funções
Onde deve ficar uma regra rígida como "nunca exponha preços internos"?
Recapitulação
Três funções, três níveis de confiança. Use o sistema para regras, o usuário para entradas e o assistente para reproduções. Adicione mensagens de ferramenta depois das chamadas de função.
Perguntas Frequentes
A aula “Papéis de sistema, usuário e assistente” é grátis?
Sim — o texto completo de “Papéis de sistema, usuário e assistente” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de AI Agents, atualize para CoddyKit PRO. O curso de AI Agents inclui 4 aulas no total.
O que vou aprender em “Papéis de sistema, usuário e assistente”?
Compreenda os três papéis das mensagens nas APIs modernas de conversa e como eles afetam aquilo em que o modelo confia e que ele obedece. Você pratica AI Agents com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.
Preciso ter experiência prévia para começar AI Agents?
Nenhuma experiência prévia é necessária. AI Agents no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 2 de 4.
Quanto tempo leva a aula “Papéis de sistema, usuário e assistente”?
A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.
Posso escrever e executar código nesta aula de AI Agents?
Sim. Cada aula de AI Agents inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.
Todas as aulas deste curso
- Zero-shot, few-shot e cadeia de pensamento
- Papéis de sistema, usuário e assistente
- Formatação da saída (JSON, XML, Markdown)
- Como evitar injeção de prompt nas entradas