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.