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 stylu opartego na poleceniach, używanego w completions.
Oto jak to działa:
Zamiast wysyłać pojedynczy ciąg znaków jako polecenie, wysyłasz listę wiadomości jako dane wejściowe.
Każda wiadomość ma
roleicontent.Typowe role obejmują
system,user,assistant,developeritool. Wiadomości narzędzi służą do przekazywania wyników narzędzi/funkcji i muszą odpowiadać wywołaniom narzędzi przez asystenta. Ze względu na zgodność wsteczną wiadomości funkcji mogą nadal być akceptowane i konwertowane na wiadomości narzędzi podczas obsługi na serwerze. Wiadomości dewelopera mogą być mapowane ponownie w zależności od obsługi przez model.Pole
contentzawiera tekst wiadomości pochodzącej z danej roli.Instrukcja systemowa może przekazywać ogólne wskazówki dotyczące rozmowy
Wiadomości są przetwarzane w kolejności, w jakiej pojawiają się na liście, a asystent odpowiada odpowiednio do nich.
Nawet podstawowe żądania Completions można obsłużyć przez Chat Completions, jak widać poniżej:
| Wtedy | Teraz | | 'prompt' : 'tell me a joke' | 'messages': <br>[{'role':'user', 'content':'tell me a joke'}] |
Teraz prowadzenie rozmowy z modelem tam i z powrotem jest łatwiejsze niż kiedykolwiek — wystarczy rozszerzać listę wiadomości w konwersacji.
'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.