Construtor de Mensagens de Conversa

Construa e teste arrays de mensagens de chat completion com edição visual baseada em papéis

~/message-builder
Adicionar:
#1
#2

JSON de Saída(0 ({count} mensagens))

[]

O que é um Construtor de Mensagens de Conversa?

Um construtor de mensagens de conversa é uma ferramenta visual para construir os arrays de mensagens usados por APIs de chat completion de IA. Quando você chama a API Chat Completions da OpenAI, a API Messages da Anthropic ou a API Gemini do Google, você envia um array ordenado de mensagens — cada uma com um papel (system, user ou assistant) e conteúdo. Esta ferramenta permite construir esses arrays visualmente em vez de escrever JSON manualmente.

Escrever arrays de mensagens manualmente é tedioso e propenso a erros, especialmente para conversas de múltiplos turnos, configurações de few-shot prompting ou system prompts complexos. Esquecer uma vírgula, descasar aspas ou errar os nomes dos papéis leva a erros de API que podem ser difíceis de depurar. Nosso construtor oferece uma interface visual com codificação de cores por papel, reordenação e saída JSON em tempo real.

A ferramenta suporta tanto o formato OpenAI/Google (mensagens system no array) quanto o formato Anthropic (system prompt separado das mensagens). Alterne entre formatos com um único clique e copie o JSON pronto para uso diretamente no seu código.

Como Usar o Construtor de Mensagens

Construir um array de mensagens leva apenas alguns cliques:

  1. Adicione mensagens — Clique nos botões "+ System", "+ User" ou "+ Assistant" para adicionar mensagens. Cada papel tem uma cor: roxo para system, azul para user, verde para assistant.
  2. Escreva o conteúdo — Digite ou cole o conteúdo da sua mensagem em cada área de texto. A saída JSON é atualizada automaticamente conforme você digita.
  3. Reordene as mensagens — Use os botões de seta para cima/baixo para reorganizar a ordem das mensagens. Você também pode mudar o papel de uma mensagem usando o dropdown.
  4. Escolha o formato de saída — Selecione "OpenAI / Google" ou "Anthropic" no dropdown de formato. Para Anthropic, as mensagens system são automaticamente extraídas para um campo separado.
  5. Copie o JSON — Clique em "Copiar JSON" para copiar a saída formatada para sua área de transferência, pronta para colar no seu código ou ferramenta de teste de API.

Entendendo os Papéis de Mensagem

Cada mensagem em um array de chat completion tem um papel específico que diz ao modelo como interpretá-la:

Papel System

A mensagem system define o comportamento geral e as restrições para a IA. Ela age como instruções persistentes que influenciam cada resposta. System prompts comuns incluem definições de persona ("Você é um desenvolvedor sênior"), requisitos de formato de saída ("Sempre responda em JSON"), restrições de segurança ("Nunca forneça aconselhamento médico") ou contexto de domínio. A mensagem system é tipicamente a primeira mensagem no array.

Papel User

Mensagens user representam entrada do usuário humano. São as perguntas, instruções ou dados que o modelo deve processar. Em conversas de múltiplos turnos, mensagens user alternam com mensagens assistant para criar um histórico de conversa.

Papel Assistant

Mensagens assistant representam respostas anteriores do modelo de IA. Incluir mensagens assistant no array permite fornecer histórico de conversa ou implementar few-shot prompting — onde você mostra ao modelo exemplos de pares de entrada/saída desejados antes de fazer sua pergunta real.

Casos de Uso Comuns

  • Few-shot prompting — Construa exemplos de conversa onde mensagens user mostram entradas e mensagens assistant mostram saídas desejadas, ensinando ao modelo o padrão.
  • Teste de system prompt — Prototipe rapidamente diferentes system prompts e veja como eles se combinam com mensagens user no JSON final.
  • Teste de API — Gere arrays de mensagens para ferramentas como Postman, curl ou playgrounds de API sem formatar JSON manualmente.
  • Migração entre provedores — Converta arrays de mensagens entre formatos OpenAI e Anthropic ao trocar de provedor.
  • Documentação — Construa exemplos de conversas para documentação de API ou materiais de onboarding da equipe.

Perguntas Frequentes

O que é um array de mensagens de chat completion?

Um array de mensagens de chat completion é o formato de entrada usado por APIs de IA como OpenAI, Anthropic e Google. É uma lista ordenada de mensagens, cada uma com um "role" (system, user ou assistant) e "content" (o texto da mensagem). O modelo usa esse histórico de conversa para gerar respostas contextualmente apropriadas.

Qual é a diferença entre os formatos de mensagens da OpenAI e da Anthropic?

A OpenAI inclui mensagens system diretamente no array de mensagens com role: "system". A Anthropic separa o system prompt em um parâmetro dedicado "system" fora do array de mensagens, e o array de mensagens contém apenas papéis "user" e "assistant". Nosso construtor lida com essa conversão automaticamente quando você alterna formatos de saída.

O que a mensagem system faz?

A mensagem system define o comportamento, personalidade e restrições para o modelo de IA. Ela é processada antes da conversa e age como instruções persistentes. Usos comuns incluem definir o papel do assistente ("Você é um agente de suporte ao cliente"), definir requisitos de formato de saída ou estabelecer diretrizes de segurança. Nem todas as chamadas de API precisam de uma mensagem system, mas é recomendado para aplicações em produção.

Por que a ordem das mensagens importa?

A ordem das mensagens define o fluxo da conversa. Modelos processam mensagens sequencialmente, e a ordem afeta como o modelo interpreta o contexto. Mensagens system devem vir primeiro, seguidas por mensagens user e assistant alternadas. Colocar mensagens fora de ordem (ex: duas mensagens user seguidas sem uma resposta assistant) pode confundir o modelo ou causar erros de API em alguns provedores.

Posso usar este construtor para conversas de múltiplos turnos?

Sim. O construtor suporta mensagens ilimitadas, tornando-o ideal para construir históricos de conversas de múltiplos turnos. Você pode adicionar mensagens user e assistant em ordem alternada para simular uma conversa completa, depois copiar o JSON resultante para usar em suas chamadas de API ou para testar cadeias de prompts.

Ferramentas Relacionadas

Explore mais ferramentas para construir com APIs de IA:

Ferramentas Relacionadas

Linter de Definição de Ferramentas/Funções

Valide e analise suas definições de function calling de IA para os formatos OpenAI, Anthropic, Google e Cohere

Gerador de JSON Schema para IA

Gere JSON schemas a partir de dados de exemplo, otimizados para function calling de IA e saídas estruturadas

Conversor de Formato de Prompt

Converta prompts entre os formatos OpenAI, Anthropic Claude, Google Gemini e outros provedores de IA