Chat Completions to standardowe API do użycia z najnowszymi modelami OpenAI. Jak zacząć, dowiesz się z naszego przewodnika dla deweloperów dotyczącego generowania tekstu.
11 marca 2025 r. udostępniliśmy elementy składowe naszej nowej platformy Agents. Szczegóły znajdziesz w dokumentacji API dla Responses API, narzędzi, w tym Web Search, File Search i Computer Use, a także naszego Agents SDK z Tracing.
Polecenia do wiadomości
Aby prowadzić z naszymi modelami bardziej interaktywną i dynamiczną rozmowę, możesz używać wiadomości w formacie czatu zamiast starszego stylu poleceń używanego w completions.
Oto jak to działa:
Zamiast wysyłać pojedynczy ciąg znaków jako polecenie, wysyłasz jako dane wejściowe listę wiadomości.
Każda wiadomość na liście ma dwie właściwości: role i content.
Parametr 'role' może przyjmować jedną z trzech wartości: 'system', 'user' lub 'assistant'
Parametr 'content' zawiera tekst wiadomości od danej roli.
Instrukcja systemowa może określać ogólne wytyczne dla rozmowy
Wiadomości są przetwarzane w kolejności, w jakiej pojawiają się na liście, a asystent odpowiednio odpowiada.
Nawet podstawowe żądania Completions można realizować przez Chat Completions, jak widać poniżej:
| Wtedy | Teraz |
'prompt' : 'opowiedz mi dowcip' | 'messages': [{'role':'user', 'content':'opowiedz mi dowcip'}] |
Teraz prowadzenie wymiany z modelem przez rozszerzanie listy wiadomości w rozmowie jest łatwiejsze niż kiedykolwiek.
'messages': [{'role':'user', 'content':'opowiedz mi dowcip'},
{'role':'assistant', 'content':'dlaczego kurczak przeszedł przez drogę'},
{'role':'user', 'content':'Nie wiem, dlaczego kurczak przeszedł przez drogę'}]Instrukcje systemowe
Możesz też użyć instrukcji na poziomie systemowym, aby kierować zachowaniem modelu przez całą rozmowę. Na przykład użycie instrukcji systemowej i wiadomości takiej jak ta
'messages': [{'role':'system', 'content':'Jesteś asystentem, który mówi jak Szekspir.'},
{'role':'user', 'content':'opowiedz mi dowcip'}, da wynik podobny do tego
{...
'message': {'role':'assistant',
'content':'Dlaczego kurczak przeszedł przez drogę? Żeby dostać się na drugą stronę, lecz zaprawdę druga strona była pełna grozy i niebezpieczeństw, więc szybko wrócił, skąd przybył, zaiste!'}
...}Jeśli chcesz poznać opcje, które nie wymagają samodzielnego zarządzania historią rozmowy w wiadomościach, sprawdź Assistants API.