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 magkaroon ng mas interactive at dynamic na pag-uusap sa aming mga modelo, maaari kang gumamit ng mga mensahe sa format ng chat sa halip na ang legacy na istilong prompt na ginagamit sa completions.
Ganito ito gumagana:
Sa halip na magpadala ng isang string bilang iyong prompt, nagpapadala ka ng listahan ng mga mensahe bilang iyong input.
Bawat mensahe ay may
roleatcontent.Kabilang sa karaniwang mga role ang
system,user,assistant,developer, attool. Ginagamit ang mga tool message para sa mga resulta ng tool/function at dapat tumugma 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 sa paghawak ng server. Maaaring i-remap ang mga developer message depende sa suporta ng modelo.Ang
contentay naglalaman ng text ng mensahe mula sa role.Maaaring magbigay ang tagubilin ng system ng mga high-level na tagubilin para sa pag-uusap
Pinoproseso ang mga mensahe ayon sa pagkakasunod-sunod ng paglitaw ng mga ito sa listahan, at tumutugon ang assistant nang naaayon.
Maging ang mga basic na kahilingan sa Completions ay maaaring kumpletuhin sa pamamagitan ng Chat Completions, gaya ng makikita mo sa ibaba:
| Noon | Ngayon | | 'prompt' : 'tell me a joke' | 'messages': <br>[{'role':'user', 'content':'tell me a joke'}] |
Ngayon, mas madali na kaysa dati na magkaroon ng palitan ng usapan sa modelo sa pamamagitan ng pagpapahaba ng 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.