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: yesterday

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 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 ca solicitare, trimiți o listă de mesaje ca intrare.

  • Fiecare mesaj are un role și un 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 instrument ale asistentului. Pentru compatibilitate inversă, mesajele de funcție pot fi încă acceptate și convertite în mesaje de instrument la procesarea pe server. Mesajele dezvoltatorului pot fi remapate în funcție de suportul modelului.

  • content conține textul mesajului provenit de la rol.

  • Instrucțiunea de sistem poate oferi instrucțiuni generale pentru conversație

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

Chiar și solicitările Completions de bază pot fi realizate prin Chat Completions, după cum poți vedea mai jos:

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

Acum este mai ușor ca niciodată să ai schimburi de replici cu modelul prin extinderea listei 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?