Chat Completions é a API padrão a usar com os modelos mais recentes da OpenAI. Pode saber como começar a usá-la no nosso guia de programação para geração de texto.
Em 11 de março de 2025, lançámos os blocos de construção da nossa nova plataforma de Agentes. Para mais detalhes, consulte a nossa documentação da API para a API Responses, Ferramentas incluindo Pesquisa na Web, Pesquisa de ficheiros e Utilização do computador, e o nosso SDK de Agentes com Rastreamento.
De prompts a mensagens
Para ter uma conversa mais interativa e dinâmica com os nossos modelos, pode utilizar mensagens em formato de chat em vez do antigo estilo baseado em prompts utilizado com Completions.
Veja como funciona:
Em vez de enviar uma única cadeia de texto como prompt, envia uma lista de objetos de mensagem como entrada.
Cada mensagem tem uma role e, geralmente, content.
As funções mais comuns incluem system, user, assistant, developer e tool. As mensagens com a função tool são utilizadas para resultados de ferramentas/funções e têm de corresponder a chamadas de ferramentas do assistente. Para garantir a retrocompatibilidade, as mensagens com a função function podem continuar a ser aceites e convertidas em mensagens com a função tool durante o processamento no servidor. As mensagens com a função developer podem ser remapeadas consoante a compatibilidade do modelo.
O campo content contém o texto da mensagem associada à função.
A instrução de sistema pode fornecer instruções gerais para a conversa.
As mensagens são processadas pela ordem em que aparecem na lista, e o assistente responde em conformidade.
Até os pedidos básicos de Completions podem ser processados através de Chat Completions, como se vê abaixo:
| Antes | Agora |
|---|---|
'prompt' : 'tell me a joke' | 'messages': [{'role':'user', 'content':'tell me a joke'}] |
Agora, é mais fácil do que nunca manter uma conversa com o modelo, bastando aumentar a lista de mensagens da conversa.
'messages': [{'role':'user', 'content':'conta-me uma piada'},
{'role':'assistant', 'content':'porque é que a galinha atravessou a estrada'},
{'role':'user', 'content':'Não sei, porque é que a galinha atravessou a estrada'}]Instruções do sistema
Também pode usar uma instrução ao nível do sistema para orientar o comportamento do modelo ao longo da conversa. Por exemplo, usando uma instrução de sistema e uma mensagem como esta
'messages': [{'role':'system', 'content':'És um assistente que fala como Shakespeare.'},
{'role':'user', 'content':'conta-me uma piada'}, resultará em algo como
{...
'message': {'role':'assistant',
'content':'Porque é que a galinha atravessou a estrada? Para chegar ao outro lado, mas em verdade, o outro lado estava cheio de perigo e risco, por isso voltou rapidamente de onde veio, pois sim!'}
...}Se quiser explorar opções que não impliquem ter de gerir o histórico da conversa de mensagens por si, consulte a API Assistants.