A Chat Completions az OpenAI legújabb modelljeivel használható szabványos API. A használat megkezdéséről a szöveggenerálási fejlesztői útmutatónkban tudhatsz meg többet.
2025. március 11-én kiadtuk az új Agents platformunk építőelemeit. A részletekért lásd az API-dokumentációinkat a Responses API-ról, az eszközökről, köztük a Web Search, a File Search és a Computer Use eszközről, valamint az Agents SDK-ról a Tracing funkcióval.
Utasítások helyett üzenetek
Ha interaktívabb és dinamikusabb beszélgetést szeretne folytatni modelljeinkkel, a Completions régi, utasításalapú formátuma helyett Chat-formátumú üzeneteket használhat.
Így működik:
Egyetlen utasításkarakterlánc helyett üzenetobjektumok listáját küldi be bemenetként.
Minden üzenetnek van role mezője, és általában content mezője is.
A gyakori szerepkörök közé tartozik a system, a user, az assistant, a developer és a tool. A tool üzenetek az eszközök vagy függvények eredményeit tartalmazzák, és meg kell felelniük az assistant eszközhívásainak. A visszafelé kompatibilitás érdekében a function üzenetek továbbra is elfogadhatók, és a szerver tool üzenetekké alakíthatja őket. A developer üzenetek a modell támogatásától függően más szerepkörhöz rendelhetők.
A content az adott szerepkör üzenetének szövegét tartalmazza.
A rendszerutasítás átfogó iránymutatást adhat a beszélgetéshez.
Az üzenetek feldolgozása a listában szereplő sorrendben történik, az assistant pedig ennek megfelelően válaszol.
Még az egyszerű Completions-kérések is teljesíthetők a Chat Completions használatával, ahogy az alábbi példa mutatja:
| Korábban | Most |
|---|---|
'prompt' : 'tell me a joke' | 'messages': [{'role':'user', 'content':'tell me a joke'}] |
Az üzenetlista bővítésével most minden eddiginél könnyebben folytathat oda-vissza párbeszédet a modellel.
'messages': [{'role':'user', 'content':'mondj egy viccet'},
{'role':'assistant', 'content':'miért ment át a csirke az úton'},
{'role':'user', 'content':'Nem tudom, miért ment át a csirke az úton'}]Rendszerutasítások
Rendszerszintű utasítással is irányíthatod a modell viselkedését a teljes beszélgetés során. Például egy rendszerutasítás és egy ilyen üzenet használatával
'messages': [{'role':'system', 'content':'Ön egy asszisztens, aki Shakespeare stílusában beszél.'},
{'role':'user', 'content':'mondj egy viccet'}, valami ilyesmit eredményez
{...
'message': {'role':'assistant',
'content':'Miért ment át a csirke az úton? Hogy átjusson a túloldalra, de bizony a túloldal tele volt veszéllyel és bajjal, ezért gyorsan visszatért, ahonnan jött, bizony!'}
...}Ha olyan lehetőségeket szeretnél megismerni, amelyeknél nem kell saját magadnak kezelned az üzenetváltási előzményeket, nézd meg az Assistants API-t.