Salt la conținutul principal
Română— Alege o limbă
Meniu

Conectați-vă GPT la API-uri externe

Lecția 9 din 17 Actualizată 5 noiembrie 2026 Intermediar
Pe această pagină
  1. Dincolo de GPT-ul izolat
  2. Ce este o Acțiune?
  3. Schema OpenAPI
  4. Configurarea unei Acțiuni în Editorul GPT
  5. Exercițiu Practic: Un API Public
  6. Puncte cheie

Stare la 5 noiembrie 2026: GPT-urile sunt în ultimele săptămâni. OpenAI retrage GPT-urile personalizate pe 11 decembrie 2026 (11 februarie 2027 pentru anumite spații de lucru Enterprise cu o excepție). Conturile Personal, Free, Go, Plus și Pro nu mai pot crea sau publica noi GPT-uri; în spațiile de lucru Business, Enterprise și Edu, crearea depinde de setări și a încetat pe 26 octombrie 2026 în spațiile Enterprise afectate. GPT-urile existente rămân utilizabile și editabile dacă planul dumneavoastră permite acest lucru până la retragere; conversațiile cu ele vor rămâne accesibile și după aceea. Migrarea (Migrate to plugin, în My GPTs) transformă instrucțiunile într-o abilitate (skill), baza de cunoștințe în fișiere de referință, iar aplicațiile conectate în aplicații; acțiunile personalizate nu sunt transferate. Această lecție explică funcționarea GPT-urilor pentru a vă ajuta să le mențineți, să le migrați și să adaptați principiile lor la un plugin (Lecțiile 15–17).

Dincolo de GPT-ul izolat

Până acum, GPT-ul dumneavoastră a operat într-un siloz: instrucțiunile sale îi definesc comportamentul, iar secțiunea Knowledge (Cunoștințe) îi furnizează documentele. Deși este puternic, acesta rămâne deconectat de lumea în timp real. Nu poate verifica CRM-ul în timp real, nu poate crea un eveniment în calendar și nu poate interoga baza de date; știe doar ceea ce ați încărcat, înghețat la momentul încărcării. Acțiunile elimină această limită: ele permit GPT-ului să apeleze API-uri externe pentru a citi și scrie date în instrumentele dumneavoastră în timpul unei conversații.

Ce este o Acțiune?

O Acțiune reprezintă o conexiune între GPT-ul dumneavoastră și un serviciu extern prin intermediul API-ului său. Fluxul este întotdeauna același: utilizatorul pune o întrebare sau dă o instrucțiune, GPT-ul identifică faptul că are nevoie de date externe pentru a răspunde, apelează API-ul serviciului, primește răspunsul și îl integrează în replica sa finală. Să luăm exemplul unui GPT de vânzări conectat la un CRM: când un utilizator întreabă „Care este statusul dosarului Dupont?“, GPT-ul interoghează API-ul CRM-ului, preia înregistrarea clientului și răspunde cu datele de astăzi – nu cu amintirea unui fișier încărcat acum trei luni. Totul se întâmplă transparent pentru utilizator, care are simpla senzație că discută cu un asistent bine informat.

Schema OpenAPI

Pentru ca GPT-ul să poată apela un API, trebuie să îl descrieți. Acesta este rolul schemei OpenAPI (fostul Swagger), un fișier JSON sau YAML care servește drept manual de instrucțiuni al API-ului. Aceasta descrie endpoint-urile – URL-urile pe care GPT-ul le poate apela –, metodele asociate (GET pentru citire, POST pentru creare, PUT pentru actualizare, DELETE pentru ștergere), parametrii așteptați de fiecare endpoint și formatul răspunsurilor returnate. Pe baza acestui document, GPT-ul decide singur, în timpul conversației, ce endpoint să apeleze și cu ce parametri.

Iată cum arată o schemă minimă pentru un API fictiv de vreme:

openapi: 3.1.0
info:
  title: Weather API
  version: 1.0.0
servers:
  - url: https://example.com
paths:
  /forecast:
    get:
      operationId: getForecast
      summary: Get weather forecast for a city
      parameters:
        - name: city
          in: query
          required: true
          schema:
            type: string
      responses:
        "200":
          description: Weather forecast

Veste bună: aproape niciodată nu va trebui să scrieți acest fișier de la zero. Multe servicii publică schema lor OpenAPI direct în documentația API. Dacă nu este cazul, instrumente precum Swagger Editor – sau chiar ChatGPT, dacă îi descrieți API-ul – o pot genera. Iar dacă echipa dumneavoastră tehnică lucrează cu Postman, colecțiile sale se pot exporta în format OpenAPI.

Configurarea unei Acțiuni în Editorul GPT

Configurarea se face în editorul GPT pe web: mergeți la secțiunea Actions, faceți clic pe Create new action, lipiți schema OpenAPI în câmpul furnizat, configurați autentificarea (abordată în lecția următoare), apoi testați acțiunea din panoul de previzualizare.

Calitatea schemei determină calitatea apelurilor. Păstrați în minte trei obiceiuri. În primul rând, atribuiți nume explicite valorilor operationId: GPT-ul se bazează pe acestea pentru a decide ce acțiune să apeleze, iar getForecast îl ghidează mult mai bine decât op_42. În al doilea rând, scrieți descrieri clare pentru fiecare endpoint și parametru – în limbaj natural, ca și cum ați explica API-ul unui coleg. În final, expuneți doar endpoint-urile de care aveți nevoie: dacă GPT-ul are nevoie doar de două sau trei rute, nu expuneți toate cele patruzeci de rute ale API-ului complet. Fiecare endpoint expus ocupă spațiu în contextul GPT-ului și crește riscul ca acesta să îl aleagă pe cel greșit.

O acțiune în patru pași Patru pași: descrieți API-ul cu o schemă OpenAPI în JSON sau YAML; alegeți autentificarea, niciuna, cheie sau OAuth; testați în previzualizare; apoi GPT-ul apelează API-ul când este util. CONECTAȚI UN API O acțiune în patru pași 1 Schemă OpenAPI, JSON sau YAML 2 Acces Niciuna, cheie sau OAuth 3 Test În previzualizare 4 Utilizare GPT-ul apelează API-ul Fără acțiuni în modul Pro, iar acțiunile nu se transferă la un plugin.
Bazat pe articolul „Configuring actions in GPTs“ din Centrul de Ajutor OpenAI (noiembrie 2026).

Exercițiu Practic: Un API Public

Prima dumneavoastră acțiune, sau planul acesteia. Cel mai bun teren de antrenament este un API public și gratuit – vreme, cursuri de schimb, știri – care nu necesită o autentificare complexă. Alegeți unul, recuperați sau creați schema sa OpenAPI și adăugați-l ca Acțiune în GPT-ul dumneavoastră. Nu uitați să legați Acțiunea de instrucțiuni specificând când să fie utilizată: „Când utilizatorul cere vremea, folosește acțiunea getForecast.“ Apoi testați cu mai multe formulări diferite pentru a verifica dacă GPT-ul declanșează apelul la momentul potrivit.

Câteva capcane vă așteaptă la primele încercări. O schemă malformată – o singură virgulă lipsă în JSON – blochează totul: validați întotdeauna schema în Swagger Editor înainte de a o lipi. Descrierile lipsă orbesc GPT-ul: fără ele, acesta nu știe când o acțiune este relevantă. Planificați, de asemenea, erorile de API, care vor apărea mai devreme sau mai târziu: specificați comportamentul în instrucțiuni, de exemplu: „Dacă API-ul nu răspunde, spuneți utilizatorului să încerce din nou mai târziu“ – altfel GPT-ul va improviza, uneori inventând date. Și nu vă bazați doar pe panoul de previzualizare: testați în condiții reale, cu date reale și formulări reale ale utilizatorilor.

Cunoașteți două limite înainte de a începe: un GPT utilizează aplicații conectate sau acțiuni, nu ambele, iar acțiunile nu funcționează în modul Pro. Cel mai important, acțiunile personalizate nu se transferă la un plugin în timpul migrării: verificați mai întâi dacă directorul de plugin-uri oferă deja o aplicație pentru serviciul țintă; dacă nu, va trebui să reconstruiți integrarea, de exemplu cu un server MCP.

Surse oficiale: Configuring actions in GPTs (Centrul de Ajutor OpenAI: autentificare, schemă OpenAPI, testare, limite) · Custom GPT retirement and migration FAQ (acțiunile nu sunt transferate) · OpenAPI Specification (formatul schemei)

Puncte cheie

  • Acțiunile conectează GPT-ul la servicii externe prin intermediul API-urilor lor
  • Trebuie să furnizați o schemă OpenAPI care descrie endpoint-urile disponibile
  • Descrierile din schemă sunt esențiale – GPT-ul le folosește pentru a decide ce acțiune să apeleze
  • Începeți cu un API public gratuit pentru a vă familiariza cu procesul
  • Limitați endpoint-urile expuse la strictul necesar pentru cazul dumneavoastră de utilizare