Chat Completions to standardowy interfejs API do użycia z najnowszymi modelami OpenAI. Więcej o rozpoczynaniu pracy z nim znajdziesz w naszym przewodniku dla deweloperów po generowaniu tekstu.
11 marca 2025 r. udostępniliśmy elementy składowe naszej nowej platformy agentów. Szczegóły znajdziesz w naszej dokumentacji API dotyczącej Responses API, narzędzi, w tym wyszukiwania w internecie, wyszukiwania plików i korzystania z komputera, oraz naszego SDK agentów z funkcją śledzenia.
Od poleceń do wiadomości
Aby prowadzić bardziej interaktywną i dynamiczną rozmowę z naszymi modelami, możesz używać wiadomości w formacie czatu zamiast starszego formatu poleceń stosowanego w interfejsie Completions.
Działa to tak:
Zamiast wysyłać pojedynczy ciąg znaków z poleceniem, przekazujesz jako dane wejściowe listę obiektów wiadomości.
Każda wiadomość ma pole role i zazwyczaj pole content.
Typowe role to system, user, assistant, developer i tool. Wiadomości narzędzia służą do przekazywania wyników działania narzędzi lub funkcji i muszą odpowiadać wywołaniom narzędzi przez asystenta. Ze względu na zgodność wsteczną wiadomości funkcji mogą być nadal akceptowane i podczas obsługi przez serwer konwertowane na wiadomości narzędzia. Wiadomości dewelopera mogą być przypisywane do innej roli zależnie od obsługi przez model.
Pole content zawiera tekst wiadomości pochodzącej od danej roli.
Instrukcja systemowa może określać ogólne zasady prowadzenia rozmowy
Wiadomości są przetwarzane w kolejności, w jakiej występują na liście, a asystent odpowiednio na nie odpowiada.
Nawet podstawowe żądania interfejsu Completions można realizować za pomocą Chat Completions, jak pokazano poniżej:
| Wcześniej | Teraz |
|---|---|
'prompt' : 'tell me a joke' | 'messages': [{'role':'user', 'content':'tell me a joke'}] |
Teraz prowadzenie dialogu z modelem jest łatwiejsze niż kiedykolwiek — wystarczy rozszerzać listę wiadomości w rozmowie.
'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 systemu, 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'}, spowoduje uzyskanie czegoś takiego
{...
'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ą konwersacji w wiadomościach, sprawdź Assistants API.