Prezentare generală

Acest articol explică cum să configurezi acțiuni într-un GPT, inclusiv cum să te conectezi la API-uri externe, să definești ce poate face GPT-ul și să gestionezi autentificarea, schemele și restricțiile spațiului de lucru.

Pentru a configura o acțiune, vei avea nevoie de detaliile API-ului pentru serviciul pe care vrei să îl conectezi, inclusiv informații de autentificare și o schemă OpenAPI. Un GPT poate folosi fie aplicații, fie acțiuni, dar nu pe ambele în același timp.

Fiecare acțiune este definită de două componente principale: modul în care GPT-ul se autentifică la API și o schemă care definește ce poate face API-ul.

Limitări

Dacă spațiul tău de lucru permite zero domenii de acțiune, acțiunile personalizate GPT nu pot fi executate deoarece niciun domeniu de acțiune nu poate trece verificările listei de permisiuni. Asta nu înseamnă neapărat că toată vizibilitatea sau tot accesul la GPT este blocat.

Acțiunile nu sunt disponibile pentru modul Pro; crearea unui GPT cu acțiuni personalizate va face ca în acesta să fie disponibile pentru selecție doar modelele Instant și Thinking.

Creează o acțiune

În editorul GPT, mergi la secțiunea Actions și selectează Create new action.

Apoi vei configura modul în care GPT-ul tău se conectează la un API extern și îl folosește.

După configurarea unei acțiuni, testeaz-o în Preview pentru a confirma că se comportă conform așteptărilor.

Autentificare

Autentificarea controlează modul în care GPT-ul tău se conectează la un API extern.

Opțiuni disponibile:

• None: Nu este necesară autentificarea

• API key: Folosește o cheie secretă pentru a autoriza cererile

• OAuth: Folosește autentificarea utilizatorului pentru acces bazat pe cont

API key

Folosește autentificarea cu cheie API pentru acces server-la-server. Poate fi configurată astfel:

• Basic

• Bearer

• Custom header

OAuth

Folosește OAuth când acțiunile necesită conturi de utilizator. OAuth necesită:

• Client ID și Client Secret

• Authorization URL și Token URL

• Scope și metoda de schimb al tokenului

Editorul oferă un URL de callback pentru finalizarea fluxului OAuth.

Schemă

Schema definește ce poate face API-ul tău. Îi spune lui ChatGPT:

• Ce server să apeleze

• Ce puncte finale sunt disponibile

• Ce parametri acceptă

• Cum este identificată fiecare acțiune (ID-uri de operație)

Schema trebuie furnizată ca specificație OpenAPI în JSON sau YAML.

Adaugă o schemă

Poți adăuga o schemă în trei moduri:

• Lipește-o direct în editor

• Import-o dintr-un URL

• Pornește de la un exemplu încorporat:

  • Vreme (JSON)

  • Pet Store (YAML)

  • Șablon gol

Dacă schema este validă, editorul afișează acțiunile detectate. Dacă este invalidă, sunt afișate erorile de validare.

Restricții ale spațiului de lucru (Enterprise și Edu)

Dacă vezi mesajul:

„Niciun domeniu nu este permis de setările spațiului tău de lucru.”

Asta înseamnă că acțiunile sunt restricționate de setările spațiului tău de lucru.

• Administratorii pot permite toate domeniile sau pot restricționa acțiunile la domenii aprobate.

• Dacă nu sunt permise domenii, nu poți folosi acțiuni.

Pentru controale la nivel de spațiu de lucru privind acțiunile și restricțiile de domeniu, vezi: Gestionarea accesului la GPT în spațiile de lucru Enterprise și Edu.

Confidențialitate și controale pentru utilizatori

• Fiecare acțiune poate include un URL al politicii de confidențialitate.

• GPT-urile publice (link sau GPT Store) cu acțiuni trebuie să includă un URL valid al politicii de confidențialitate.

• Utilizatorilor li se poate cere să aprobe acțiunile înainte ca acestea să ruleze.

• Pentru acțiunile OAuth, utilizatorii pot examina și gestiona conturile conectate.

Ajutor suplimentar

Pentru ajutor la scrierea sau depanarea acțiunilor, folosește oficialul ActionsGPT.