Chat Completions é a API padrão a utilizar com os modelos mais recentes da OpenAI. Pode saber como começar a usá-la no nosso guia do programador para geração de texto.
Desde 11 de março de 2025, lançámos os blocos fundamentais da nossa nova plataforma de agentes. Para mais detalhes, consulte a documentação da API para a nossa API Responses, ferramentas incluindo Pesquisa na Web, Pesquisa de ficheiros e Utilização do computador, e o nosso SDK de agentes com Tracing.
De prompts para mensagens
Para ter uma conversa mais interativa e dinâmica com os nossos modelos, pode usar mensagens em formato de chat em vez do estilo de prompt antigo usado com completions.
Eis como funciona:
Em vez de enviar uma única cadeia de texto como prompt, envia uma lista de mensagens como entrada.
Cada mensagem na lista tem duas propriedades: role e content.
'role' pode assumir um de três valores: 'system', 'user' ou 'assistant'
'content' contém o texto da mensagem dessa role.
A instrução de sistema pode dar instruções de alto nível para a conversa
As mensagens são processadas pela ordem em que aparecem na lista, e o assistente responde em conformidade.
Mesmo pedidos básicos de Completions podem ser concluídos através de Chat Completions, como pode ver abaixo:
| Antes | Agora |
'prompt' : 'conta-me uma piada' | 'messages': [{'role':'user', 'content':'conta-me uma piada'}] |
Agora, é mais fácil do que nunca manter um diálogo com o modelo, expandindo a lista de mensagens na 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 de 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, usar 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'}, dará como resultado 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 gerir você mesmo o histórico da conversa de mensagens, consulte a API Assistants.