Omówienie

Agents API jest dostępne w wersji beta. Pozwala programistom tworzyć aplikacje z zarządzanym przez OpenAI agentem Codex, który może wykonywać wieloetapowe zadania i kontynuować pracę w tej samej sesji.

Twoja aplikacja dostarcza zadanie, narzędzia i konfigurację. OpenAI zarządza sesją agenta i koordynuje współpracę jego modelu z narzędziami.

Co potrafi agent?

W zależności od dostępnych narzędzi i środowiska wykonawczego agent może uruchamiać kod, edytować pliki, korzystać z połączeń MCP i tworzyć pliki dla Twojej aplikacji. Możesz wysyłać dodatkowe instrukcje lub przejść do kolejnego zadania w tej samej sesji.

Obsługiwane funkcje i przykłady znajdziesz w omówieniu Agents API.

Jak zacząć?

1. Utwórz klucz API dla aplikacji w swoim projekcie na platformie OpenAI. Nadaj uprawnienia api.agents.read i api.agents.write do obsługi sesji oraz api.responses.write do wysyłania żądań do modelu.

2. Skorzystaj z przewodnika szybkiego startu, aby skonfigurować agenta, utworzyć sesję i przesłać zadanie.

3. Śledź zdarzenia sesji, aby sprawdzać postępy i wyniki. Zapisz identyfikator sesji, jeśli chcesz kontynuować pracę.

Przechowuj klucz API poza piaskownicą agenta. Żądania wymagają nagłówka OpenAI-Beta: agents=v1. Biblioteki SDK OpenAI dodają ten nagłówek automatycznie.

Czy mój agent potrzebuje piaskownicy?

Wybierz środowisko odpowiednie do zadania:

• Bez środowiska: Agent odpowiada na pytania lub korzysta z narzędzi zewnętrznych i nie potrzebuje wbudowanych poleceń powłoki ani plików przestrzeni roboczej.

• Piaskownica hostowana przez OpenAI: Agent musi uruchamiać skrypty lub pracować z plikami, a Ty chcesz, by OpenAI zarządzało jego piaskownicą.

• Piaskownica hostowana we własnej infrastrukturze: Potrzebujesz własnej infrastruktury, oprogramowania lub sieci prywatnej. Twoja aplikacja zarządza cyklem życia środowiska.

Szczegóły konfiguracji znajdziesz w opisie architektury Agents API.

Gdzie mogę przejrzeć sesję?

Otwórz Dzienniki w panelu platformy, wybierz Agenci i wyszukaj identyfikator sesji. Możesz przeglądać tury, wywołania narzędzi i aktywność podagentów.

Przewodnik po obserwowalności wyjaśnia też, jak sprawdzać zarejestrowane użycie tokenów.

Co zrobić, jeśli połączenie ze strumieniem zdarzeń zostanie przerwane?

Przed ponowną próbą pobierz istniejącą sesję i jej zapisane elementy. Pozwoli Ci to sprawdzić, co się wydarzyło, zanim zlecisz dalszą pracę.

Zakończona tura nie oznacza, że każde narzędzie zadziałało pomyślnie. Sprawdź zwrócony wynik. Sam fakt, że sesja jest bezczynna, nie potwierdza pomyślnego zakończenia zadania.

Jak naliczane są opłaty za użycie?

Żądania do modelu są rozliczane według stawek API wybranego modelu. Narzędzia OpenAI i piaskownice hostowane przez OpenAI są rozliczane według odpowiednich stawek za narzędzia i kontenery.

Aktualne stawki znajdziesz w cenniku API.

Co dzieje się z danymi sesji i plikami?

Agents API zachowuje stan sesji, aby można było kontynuować pracę w kolejnych turach. Możesz usuwać sesje i opublikowane artefakty, gdy nie są już potrzebne. Przed usunięciem sesji zapisz wszystkie potrzebne pliki.

Agents API obsługuje obecnie rezydencję danych wyłącznie w Stanach Zjednoczonych. Nie obsługuje opcji nieprzechowywania danych, nawet jeśli korzystasz z piaskownicy hostowanej we własnej infrastrukturze. Szczegóły dotyczące kontroli danych znajdziesz w dokumentacji Agents API.