Często zadawane pytania

Czym jest API Assistants?

API Assistants umożliwia deweloperom łatwe tworzenie zaawansowanych asystentów AI w ich aplikacjach. To API eliminuje konieczność zarządzania historią rozmów i zapewnia dostęp do narzędzi hostowanych przez OpenAI, takich jak Interpreter kodu i wyszukiwanie plików. API obsługuje również ulepszone wywołania funkcji dla narzędzi innych firm.

Czy nadal mogę korzystać z wersji beta v1 Assistants API?

Nie. Od 18 grudnia 2024 r. użytkownicy nie mają już dostępu do wersji v1 beta interfejsu Assistants API. Obecnie obsługujemy tylko wersję v2. Zapoznaj się z tym przewodnikiem po migracji, aby przenieść wywołania API z wersji v1 do v2.

Jak uzyskać do niego dostęp?

Assistants API jest dostępne dla każdego, kto ma konto OpenAI API, ale jest przestarzałe i zostanie usunięte w sierpniu 2026 r. W nowych projektach używaj zamiast niego Responses API. Jeśli już używasz Assistants API, zaplanuj migrację do Responses API. Nadal możesz uzyskiwać dostęp do istniejących asystentów w środowisku Assistants Playground, dopóki API pozostaje dostępne.

Czym jest asystent?

Asystent to AI stworzona do określonego celu, która korzysta z modeli OpenAI i może uzyskiwać dostęp do plików, utrzymywać trwałe wątki oraz wywoływać narzędzia.

Czym jest wątek?

Wątek to sesja rozmowy między asystentem a użytkownikiem. Wątki upraszczają tworzenie aplikacji, ponieważ przechowują historię wiadomości i skracają ją, gdy rozmowa przekracza długość okna kontekstowego modelu.

Czym jest narzędzie wyszukiwania plików?

Narzędzie file_search domyślnie stosuje kilka sprawdzonych metod wyszukiwania, które pomagają wydobywać z plików odpowiednie dane i wzbogacać nimi odpowiedzi modelu.

Domyślnie narzędzie file_search korzysta z następujących ustawień:

• Rozmiar fragmentu: 800 tokenów

• Nakładanie się fragmentów: 400 tokenów

• Model reprezentacji wektorowych: text-embedding-3-large z 256 wymiarami

• Maksymalna liczba fragmentów dodawanych do kontekstu: 20

Jakie ograniczenia dotyczą przesyłania plików?

Przy przesyłaniu plików obowiązują następujące limity:

• 512 MB na plik

• 5 mln tokenów na plik

• 10 tys. plików na magazyn wektorowy

• 1 magazyn wektorowy na asystenta

• 1 magazyn wektorowy na wątek

Łączny limit przestrzeni dyskowej dla każdego projektu w organizacji wynosi 100 GB.

Jakie ograniczenia ma narzędzie wyszukiwania plików?

Znamy kilka ograniczeń, nad których usunięciem pracujemy w najbliższych miesiącach:

1. Obecnie nie można zmieniać ustawień podziału na fragmenty, tworzenia reprezentacji wektorowych ani wyszukiwania.

2. Nie obsługujemy analizy obrazów w dokumentach.

3. Nie obsługujemy wyszukiwania w plikach o ustrukturyzowanych formatach (takich jak .csv lub .jsonl). Zobacz obsługiwane typy plików.

Jakie limity częstotliwości żądań obowiązują w API Assistants?

Limity częstotliwości żądań w API Assistants nie zależą od poziomu użytkowania ani modelu. Zamiast tego obowiązują domyślne limity zależne od typu żądania, z kilkoma wyjątkami:

• GET: 1000 żądań na minutę

• POST: 300 żądań na minutę

• DELETE: 300 żądań na minutę

Ile kosztuje korzystanie z Interpretera kodu w API?

Korzystanie z Interpretera kodu kosztuje 0,03 USD za sesję. Jeśli asystent wywoła Interpreter kodu jednocześnie w dwóch różnych wątkach, powstaną dwie sesje Interpretera kodu (2 × 0,03 USD). Każda sesja jest domyślnie aktywna przez godzinę. Oznacza to, że jeśli użytkownik przekazuje instrukcje Interpreterowi kodu w tym samym wątku przez maksymalnie godzinę, opłata zostanie naliczona tylko raz.

Ile kosztuje korzystanie z wyszukiwania plików w API?

Korzystanie z wyszukiwania plików kosztuje 0,10 USD za GB przestrzeni w magazynie wektorowym dziennie (pierwszy GB jest bezpłatny). Rozmiar magazynu wektorowego jest określany po przeanalizowaniu pliku, podzieleniu go na fragmenty i utworzeniu reprezentacji wektorowych.

Wszystkie magazyny wektorowe utworzone przed 17 kwietnia 2024 r. będą bezpłatne do końca 2024 r., a następnie zostaną:

• Objęte opłatami według aktualnych stawek (obecnie 0,10 USD/GB dziennie), jeśli zostały użyte co najmniej raz w obiekcie Run utworzonym po 17 kwietnia 2024 r.

• Usunięte, jeśli nie zostały użyte w żadnym obiekcie Run między 17 kwietnia a 31 grudnia 2024 r. Dzięki temu nie poniesiesz opłat za magazyny wektorowe utworzone przed ogłoszeniem tej zmiany cen, ale nigdy nieużywane.

Czy istnieje limit liczby asystentów, których mogę utworzyć?

Nie ma limitu liczby asystentów, których może utworzyć organizacja.

Czy API obsługuje przesyłanie strumieniowe?

Tak, API Assistants obsługuje przesyłanie strumieniowe.

Czy tryb JSON jest dostępny w API Assistants?

Tak, tryb JSON jest dostępny w API Assistants za pośrednictwem parametru response_format w obiektach Assistants lub Run.

Czy API Assistants zarządza również żądaniami wywołania funkcji innych firm?

Nie. Choć mechanizm wywołania funkcji umożliwia modelowi wybór narzędzi i formatowanie kierowanych do nich żądań, OpenAI nie zarządza wykonywaniem wywołań narzędzi innych firm.

Co dzieje się z danymi, które wysyłam do OpenAI?

Podobnie jak w pozostałych częściach naszej platformy, dane i pliki przekazywane do API OpenAI nigdy nie są wykorzystywane do trenowania naszych modeli, a swoje dane możesz usunąć w dowolnym momencie. Dane przesłane do API Assistants są przechowywane bezterminowo, dopóki użytkownik nie usunie ich ręcznie.

Czy DALL-E jest dostępny w API Assistants?

Obecnie DALL-E nie jest dostępny.

Czy istnieje interfejs użytkownika dla Assistants API?

Możesz sprawdzić środowisko Playground dla Assistants API. Upewnij się, że jesteś w widoku Assistants na lewym pasku bocznym i używasz modelu zgodnego z narzędziami, które chcesz włączyć.

Jaki jest limit znaków w instrukcjach asystenta w API Assistants?

Pole instrukcji asystenta może zawierać maksymalnie 256 000 znaków.

Pojawia się u mnie komunikat o błędzie, taki jak „Na serwerze wystąpił błąd podczas przetwarzania żądania. Przepraszamy! Możesz ponowić żądanie lub, jeśli błąd będzie się powtarzał, skontaktować się z nami za pośrednictwem naszego centrum pomocy pod adresem help.openai.com. ” Co mam zrobić?

Ten błąd może oznaczać, że Twoje polecenie nie jest poprawnie skonstruowane. Jeśli kolejne próby ponowienia żądania kończą się niepowodzeniem, wypróbuj następujące rozwiązania:

1. zmień strukturę polecenia tak, aby wszystkie komendy przypominające funkcje były traktowane jako funkcje

2. dodaj wszystkie komendy z polecenia jako funkcje do tools

Dlaczego narzędzie wyszukiwania plików nie działa dobrze?

Podczas korzystania z narzędzia wyszukiwania plików zalecamy ustawienie parametru max_prompt_tokens na co najmniej 20 000. W przypadku dłuższych rozmów lub wielokrotnego korzystania z wyszukiwania plików rozważ zwiększenie tego limitu do 50 000. Aby uzyskać wyniki najwyższej jakości, najlepiej całkowicie usunąć limit max_prompt_tokens.

Jak mogę przekazać opinię?

Chętnie poznamy Twoją opinię na naszym forum dla deweloperów, za pośrednictwem Centrum pomocy pod adresem help.openai.com lub na Twitterze @OpenAIDevs.