Omówienie
Ten artykuł wyjaśnia, jak konfigurować akcje w GPT, w tym jak łączyć się z zewnętrznymi interfejsami API, określać, co GPT może robić, oraz zarządzać uwierzytelnianiem, schematami i ograniczeniami przestrzeni roboczej.
Aby skonfigurować akcję, potrzebujesz szczegółów API usługi, z którą chcesz się połączyć, w tym informacji uwierzytelniających oraz schematu OpenAPI. GPT może używać aplikacji albo akcji, ale nie obu jednocześnie.
Każda akcja jest definiowana przez dwa główne składniki: sposób uwierzytelniania GPT w API oraz schemat określający, co API może robić.
Ograniczenia
Jeśli Twoja przestrzeń robocza nie zezwala na żadne domeny akcji, niestandardowe akcje GPT nie mogą być wykonywane, ponieważ żadna domena akcji nie przejdzie kontroli listy dozwolonych. Nie musi to oznaczać, że cała widoczność lub dostęp do GPT są zablokowane.
Akcje nie są dostępne w trybie Pro. Gdy tworzysz lub edytujesz GPT z niestandardowymi akcjami, selektor modelu pokazuje tylko modele inne niż Pro, które obsługują akcje.
Utwórz akcję
W edytorze GPT przejdź do sekcji Akcje i wybierz Utwórz nową akcję.
Następnie skonfigurujesz sposób, w jaki Twój GPT łączy się z zewnętrznym API i z niego korzysta.
Po skonfigurowaniu akcji przetestuj ją w Podglądzie, aby potwierdzić, że działa zgodnie z oczekiwaniami.
Uwierzytelnianie
Uwierzytelnianie kontroluje, jak Twój GPT łączy się z zewnętrznym API.
Dostępne opcje:
Brak: Uwierzytelnianie nie jest wymagane
Klucz API: Używa tajnego klucza do autoryzacji żądań
OAuth: Używa logowania użytkownika do dostępu opartego na koncie
Klucz API
Użyj uwierzytelniania kluczem API do dostępu między serwerami. Można je skonfigurować jako:
Basic
Bearer
Niestandardowy nagłówek
OAuth
Użyj OAuth, gdy akcje wymagają kont użytkowników. OAuth wymaga:
Identyfikator klienta i sekret klienta
Adres URL autoryzacji i adres URL tokenu
Zakres i metoda wymiany tokenu
Edytor udostępnia adres URL wywołania zwrotnego do ukończenia przepływu OAuth.
Schemat
Schemat określa, co Twoje API może robić. Informuje ChatGPT:
Który serwer wywołać
Jakie punkty końcowe są dostępne
Jakie parametry akceptują
Jak identyfikowana jest każda akcja (identyfikatory operacji)
Schemat musi być podany jako specyfikacja OpenAPI w formacie JSON lub YAML.
Dodaj schemat
Możesz dodać schemat na trzy sposoby:
Wklej go bezpośrednio do edytora
Zaimportuj go z adresu URL
Zacznij od wbudowanego przykładu:
Pogoda (JSON)
Pet Store (YAML)
Pusty szablon
Jeśli schemat jest prawidłowy, edytor pokazuje wykryte akcje. Jeśli jest nieprawidłowy, wyświetlane są błędy walidacji.
Ograniczenia przestrzeni roboczej (Enterprise i Edu)
Jeśli zobaczysz komunikat:
„Ustawienia Twojej przestrzeni roboczej nie zezwalają na żadne domeny”.
Oznacza to, że akcje są ograniczone przez ustawienia Twojej przestrzeni roboczej.
Administratorzy mogą zezwolić na wszystkie domeny lub ograniczyć akcje do zatwierdzonych domen.
Jeśli żadne domeny nie są dozwolone, nie możesz używać akcji.
Informacje o kontrolach akcji i ograniczeniach domen na poziomie przestrzeni roboczej znajdziesz tutaj: Zarządzanie dostępem do GPT w przestrzeniach roboczych Enterprise i Edu.
Prywatność i kontrola użytkownika
Każda akcja może zawierać adres URL zasad prywatności.
Publiczne GPT (link lub GPT Store) z akcjami muszą zawierać prawidłowy adres URL zasad prywatności.
Użytkownicy mogą zostać poproszeni o zatwierdzenie akcji przed ich uruchomieniem.
W przypadku akcji OAuth użytkownicy mogą przeglądać połączone konta i nimi zarządzać.
Dodatkowa pomoc
Aby uzyskać pomoc w pisaniu lub debugowaniu akcji, użyj oficjalnego ActionsGPT.