OpenAI
Această pagină a fost tradusă automat. Vezi articolul original în limba engleză.

Trecerea de la Completions la Chat Completions în API-ul OpenAI

Cum să migrezi de la vechiul API OpenAI Completions la Chat Completions

Actualizat: 5 days ago

Chat Completions este API-ul standard de utilizat cu cele mai recente modele OpenAI. Poți afla cum să începi să-l folosești consultând ghidul nostru pentru dezvoltatori despre generarea de text.

Începând cu 11 martie 2025, am lansat componentele de bază ale noii noastre platforme Agents. Pentru detalii, consultă documentația noastră API pentru API-ul Responses, instrumente precum Căutare pe web, Căutare de fișiere și Utilizarea computerului, precum și Agents SDK cu Urmărire.

De la solicitări la mesaje

Pentru a avea o conversație mai interactivă și mai dinamică cu modelele noastre, poți folosi mesaje în format de chat în locul stilului vechi bazat pe solicitări, folosit cu completions.

Iată cum funcționează:

  • În loc să trimiți un singur șir de solicitare, trimiți ca intrare o listă de obiecte de tip mesaj.

  • Fiecare mesaj are un role și, de obicei, content.

  • Rolurile comune includ system, user, assistant, developer și tool. Mesajele de instrument sunt folosite pentru rezultatele instrumentelor/funcțiilor și trebuie să corespundă apelurilor de instrumente ale asistentului. Pentru compatibilitate inversă, mesajele de funcție pot fi încă acceptate și convertite în mesaje de instrument la procesarea pe server. Mesajele de dezvoltator pot fi remapate în funcție de suportul oferit de model.

  • content conține textul mesajului de la rolul respectiv.

  • Instrucțiunea de sistem poate oferi instrucțiuni de nivel înalt pentru conversație

  • Mesajele sunt procesate în ordinea în care apar în listă, iar asistentul răspunde corespunzător.

Chiar și cererile Completions de bază pot fi finalizate prin Chat Completions, după cum se vede mai jos:

| Înainte | Acum | | 'prompt' : 'tell me a joke' | 'messages': <br>[{'role':'user', 'content':'tell me a joke'}] |

Acum este mai ușor ca niciodată să ai dialoguri cu modelul, extinzând lista de mesaje din conversație.

'messages': [{'role':'user', 'content':'spune-mi o glumă'}, 
{'role':'assistant', 'content':'de ce a traversat găina drumul'},
{'role':'user', 'content':'Nu știu, de ce a traversat găina drumul'}]

Instrucțiuni de sistem

Poți folosi și o instrucțiune la nivel de sistem pentru a ghida comportamentul modelului pe parcursul conversației. De exemplu, folosind o instrucțiune de sistem și un mesaj ca acesta

'messages': [{'role':'system', 'content':'Ești un asistent care vorbește ca Shakespeare.'}, 
{'role':'user', 'content':'spune-mi o glumă'},

va avea ca rezultat ceva de genul

{...
'message': {'role':'assistant',
'content':'De ce a traversat găina drumul? Ca să ajungă de cealaltă parte, dar, în adevăr, cealaltă parte era plină de primejdii și pericole, așa că s-a întors repede de unde a venit, zău!'}
...}

Dacă vrei să explorezi opțiuni care nu implică gestionarea de către tine a istoricului conversației cu mesaje, consultă API-ul Assistants.

A fost util acest articol?