Chat Completions é a API padrão para usar com os modelos mais recentes da OpenAI. Você pode aprender como começar com ela usando nosso guia do desenvolvedor de geração de texto.
A partir de 11 de março de 2025, lançamos os blocos de construção da nossa nova plataforma de Agents. Para detalhes, consulte nossa documentação de API para a Responses API, as Ferramentas, incluindo Web Search, File Search e Computer Use, e nosso Agents SDK com Tracing.
De Prompts para Mensagens
Para ter uma conversa mais interativa e dinâmica com nossos modelos, você pode usar mensagens em formato de chat em vez do estilo legado de prompt usado com completions.
Funciona assim:
Em vez de enviar uma única string como prompt, você envia uma lista de mensagens como entrada.
Cada mensagem na lista tem duas propriedades: role e content.
O 'role' pode assumir um de três valores: 'system', 'user' ou 'assistant'
O 'content' contém o texto da mensagem daquele role.
A instrução do sistema pode fornecer orientações de alto nível para a conversa
As mensagens são processadas na ordem em que aparecem na lista, e o assistente responde de acordo.
Até mesmo solicitações básicas de Completions podem ser feitas via Chat Completions, como você pode ver abaixo:
| Antes | Agora |
'prompt' : 'conte-me uma piada' | 'messages': [{'role':'user', 'content':'conte-me uma piada'}] |
Agora, é mais fácil do que nunca ter idas e vindas com o modelo, estendendo a lista de mensagens na conversa.
'messages': [{'role':'user', 'content':'conte-me uma piada'},
{'role':'assistant', 'content':'por que a galinha atravessou a rua'},
{'role':'user', 'content':'Não sei, por que a galinha atravessou a rua'}]Instruções do sistema
Você também pode usar uma instrução em nível de sistema para orientar o comportamento do modelo ao longo da conversa. Por exemplo, usando uma instrução do sistema e uma mensagem como esta
'messages': [{'role':'system', 'content':'Você é um assistente que fala como Shakespeare.'},
{'role':'user', 'content':'conte-me uma piada'}, resultará em algo como
{...
'message': {'role':'assistant',
'content':'Por que a galinha atravessou a rua? Para chegar ao outro lado, mas, em verdade, o outro lado estava repleto de perigo e risco, então ela retornou depressa de onde viera, por certo!'}
...}Se você quiser explorar opções que não envolvam precisar gerenciar o histórico da conversa de mensagens por conta própria, confira a Assistants API.