Ang Chat Completions ang karaniwang API na gagamitin kasama ng mga pinakabagong modelo ng OpenAI. Maaari mong matutuhan kung paano magsimula rito gamit ang aming gabay para sa developer sa pagbuo ng text.
Noong Marso 11, 2025, inilabas namin ang mga building block ng aming bagong platform ng Agents. Para sa mga detalye, tingnan ang aming API docs para sa aming Responses API, mga Tool kabilang ang Web Search, File Search, at Computer Use, at ang aming Agents SDK na may Tracing.
Mula sa Mga Prompt tungo sa Mga Mensahe
Para maging mas interaktibo at dinamiko ang pakikipag-usap sa aming mga modelo, maaari kang gumamit ng mga mensahe sa chat format sa halip na lumang prompt-style na ginagamit sa completions.
Ganito ito gumagana:
Sa halip na magpadala ng iisang string ng prompt, magpapadala ka ng listahan ng mga message object bilang input.
May role at karaniwang may content ang bawat mensahe.
Kabilang sa mga karaniwang role ang system, user, assistant, developer, at tool. Ginagamit ang mga tool message para sa mga resulta ng tool/function at dapat tumugma ang mga ito sa mga tool call ng assistant. Para sa backward compatibility, maaari pa ring tanggapin ang mga function message at i-convert sa mga tool message kapag pinoproseso ng server. Maaaring i-remap ang mga developer message depende sa suporta ng modelo.
Nasa content ang teksto ng mensahe mula sa role.
Maaaring magbigay ang system instruction ng mga pangkalahatang tagubilin para sa pag-uusap
Pinoproseso ang mga mensahe ayon sa pagkakasunod-sunod ng mga ito sa listahan, at tumutugon ang assistant batay rito.
Kahit ang mga basic na Completions request ay maaaring kumpletuhin sa pamamagitan ng Chat Completions, gaya ng makikita sa ibaba:
| Dati | Ngayon |
|---|---|
'prompt' : 'tell me a joke' | 'messages': [{'role':'user', 'content':'tell me a joke'}] |
Ngayon, mas madali nang makipagpalitan ng mensahe sa modelo sa pamamagitan ng pagdaragdag sa listahan ng mga mensahe sa pag-uusap.
'messages': [{'role':'user', 'content':'magkwento ka sa akin ng biro'},
{'role':'assistant', 'content':'bakit tumawid ang manok sa kalsada'},
{'role':'user', 'content':'Hindi ko alam, bakit tumawid ang manok sa kalsada'}]Mga Tagubilin ng System
Maaari ka ring gumamit ng tagubilin sa antas ng system upang gabayan ang asal ng modelo sa buong pag-uusap. Halimbawa, gamit ang isang tagubilin ng system at mensaheng tulad nito
'messages': [{'role':'system', 'content':'Ikaw ay isang assistant na nagsasalita na parang si Shakespeare.'},
{'role':'user', 'content':'magkwento ka sa akin ng biro'}, magbubunga ng ganito
{...
'message': {'role':'assistant',
'content':'Bakit tumawid ang manok sa kalsada? Para makarating sa kabila, ngunit tunay nga, ang kabila ay puno ng panganib at kapahamakan, kaya dali-dali itong bumalik sa pinanggalingan nito, anupa’t gayon!'}
...}Kung gusto mong tuklasin ang mga opsyong hindi nangangailangan na ikaw mismo ang mamahala sa history ng pag-uusap sa mensahe, tingnan ang Assistants API.