Optimizare: Metadate, Competențe și Evenimente
Pe această pagină
Lecție rescrisă la 3 noiembrie 2026 pe baza documentației oficiale OpenAI pentru plugin-uri: Optimize Metadata, Build Skills, MCP Events și Plugin Extensions. Versiunea anterioară a acestei lecții se baza pe modulele
analyticsșiexperimentdintr-un SDK inexistent. Surse: Optimize Metadata · Build Skills · MCP Events · Plugin Extensions.
Metadatele sunt text de prezentare a produsului
ChatGPT și Codex decid când să invoce instrumentele dumneavoastră pe baza metadatelor furnizate. Numele, descrierile și parametrii bine redactate asigură invocarea instrumentului atunci când este necesar și previn declanșările nedorite. OpenAI recomandă tratarea acestor metadate ca pe un text de marketing (product copy): iterați asupra lor, testați-le și măsurați-le performanța.
Un set de referință de prompturi
Înainte de a modifica metadatele, construiți un set etichetat de prompturi de test:
- Prompturi directe care numesc explicit produsul sau sursa de date.
- Prompturi indirecte care descriu rezultatul dorit fără a numi instrumentul dumneavoastră.
- Prompturi negative care ar trebui gestionate de instrumentele integrate sau de alte plugin-uri.
Pentru fiecare prompt, documentați comportamentul așteptat: apelarea instrumentului dumneavoastră, nicio acțiune sau delegarea către o altă soluție. Folosiți acest set pentru fiecare test de non-regresie.
Metadate care ghidează modelul
- Numele ar trebui să combine domeniul și acțiunea, de exemplu
calendar.create_event. - Descrierea ar trebui să înceapă cu „Folosiți când…“ și să listeze explicit cazurile excluse, cum ar fi „Nu folosiți pentru mementouri.“
- Fiecare parametru trebuie documentat cu exemple și o listă de valori permise dacă intrarea este constrânsă.
- Anotările trebuie să reflecte comportamentul real (consultați Lecțiile 3 și 11).
Măsurați, apoi iterați
Conectați serverul, instalați plugin-ul, rulați setul de prompturi și înregistrați ce instrument a fost selectat, ce argumente au fost transmise și dacă a fost afișată vreo componentă de interfață. Urmăriți doi indicatori: precizia (a fost apelat instrumentul corect?) și recall-ul (a fost apelat instrumentul de fiecare dată când ar fi trebuit?). Vizați mai întâi o precizie ridicată pentru prompturile negative înainte de a urmări câștiguri marginale la recall.
Modificați câte un singur câmp pe rând pentru a izola factorul care generează îmbunătățirea. Păstrați un jurnal de revizuiri datat cu rezultate și solicitați cuiva să revizuiască modificările înainte de implementare. În producție, analizați utilizarea instrumentelor săptămânal. O creștere bruscă a confirmărilor de tip „instrument greșit“ semnalează de obicei o derivă a metadatelor. Colectați feedback-ul utilizatorilor și re-rulați testele de prompturi în mod regulat, în special după adăugarea unui nou instrument sau modificarea unui câmp structurat.
Competențe pentru fluxuri de lucru recurente
Serverul dumneavoastră furnizează date, autentificare și acțiuni controlate. O competență (skill) oferă secvența de apeluri ale instrumentelor, punctele de decizie, formatarea ieșirii, exemplele și șabloanele. Cea mai rapidă metodă de a începe este utilizarea utilitarului integrat @skill-creator, unde descrieți obiectivul utilizatorului și instrumentele MCP care îl susțin.
Un fișier SKILL.md robust specifică pașii de urmat, rezultatul pe care trebuie să îl primească utilizatorul, faptele pe care modelul nu trebuie să le inventeze, momentul în care trebuie să pună întrebări, să se oprească sau să refuze, și fișierele de consultat. Preferați o competență focalizată pe un flux de lucru specific în detrimentul unui set mare de instrucțiuni disparate. Separați fluxurile de lucru care diferă prin declanșator, intrări sau criterii de succes. Mențineți fișierul SKILL.md concis și stocați detaliile în altă parte: folosiți references/ pentru politici, scheme și exemple; assets/ pentru șabloane de copiat sau transformat; și scripts/ pentru calcule deterministe – dar numai dacă instrucțiunile și instrumentele existente sunt insuficiente.
Dacă o competență depinde de un server MCP, declarați această dependență în agents/openai.yaml. Acest lucru pune instrumentul la dispoziție, dar nu înlocuiește nevoia unor instrucțiuni clare privind instrumentele de utilizat, ordinea lor și modul de gestionare a rezultatelor lipsă sau ambigue. Pentru GPT-6 Astra, OpenAI recomandă revizuirea ghidului său privind respectarea instrucțiunilor: eliminați directivele vagi sau contradictorii și specificați explicit că instrucțiunile utilizatorului au prioritate față de instrucțiunile competenței.
Testați activarea competenței și calitatea ieșirii folosind prompturi directe, indirecte, incomplete (care ar trebui să declanșeze o întrebare de clarificare), fuera subiect și cazuri limită în care competența trebuie să evite halucinațiile sau acțiunile în afara domeniului său de aplicare. Dacă o competență se activează la momentul nepotrivit, corectați-i descrierea. Dacă selectează fluxul de lucru corect, dar produce rezultate inconsistente, corectați-i instrucțiunile.
Evenimente MCP: Reacția la modificări
Evenimentele MCP permit ChatGPT să se aboneze la actualizări de la serverul dumneavoastră, cum ar fi mesaje noi, conținut modificat sau schimbări de status. Utilizatorul alege ce să monitorizeze și cum să reacționeze ChatGPT la sosirea unei actualizări – de exemplu: „Monitorizează acest document și aplică corecțiile solicitate în comentarii.“
- Serverul dumneavoastră listează evenimentele pe care le suportă.
- Utilizatorul îi spune ChatGPT ce să monitorizeze și cum să reacționeze.
- ChatGPT se abonează prin serverul dumneavoastră MCP, furnizând un URL de callback și un secret de semnare.
- Serverul dumneavoastră trimite evenimentele relevante către acel URL.
- ChatGPT primește evenimentul în conversația abonată și urmează instrucțiunile utilizatorului.
Această funcționalitate este disponibilă în conversațiile ChatGPT Work pe web și în aplicația desktop cu opțiunea Cloud selectată. ChatGPT se bazează pe livrarea webhook-urilor conform proiectului de specificație MCP Events. Serverul dumneavoastră trebuie să persiste abonamentele și să poată accesa URL-urile de callback prin HTTPS.
Extensii ale interfeței ChatGPT
OpenAI MCP Extensions permit unui plugin să se integreze în zone cheie ale interfeței ChatGPT: bara laterală, zona de introducere a textului și vizualizatoarele de fișiere. Mențiunile în zona de introducere sunt disponibile doar în aplicația desktop. OpenAI publică un plugin exemplu, Bits & Bolts, care demonstrează aceste extensii și urmărește implementarea lor. Acesta este cel mai bun punct de plecare pentru explorarea acestei capacități.
Puncte cheie
- Tratați metadatele ca pe un text de prezentare a produsului: folosiți un set de referință de prompturi, urmăriți precizia și recall-ul și modificați câte un câmp pe rând.
- Scrieți descrieri care încep cu „Folosiți când…“, listați explicit cazurile excluse și documentați toți parametrii.
- Creați o singură competență focalizată per flux de lucru, mențineți
SKILL.mdconcis, stocați resursele separat și declarați dependențele MCP. - Evenimentele MCP abonează ChatGPT la actualizările serverului dumneavoastră, livrate prin webhook.
- Extensiile integrează plugin-ul dumneavoastră în bara laterală, zona de introducere și vizualizatoarele de fișiere.
Testați-vă cunoștințele
De la instrumentele MCP până la publicare: verificați dacă ați stăpânit fundamentele.
1. Am nevoie de un pachet `@openai/apps-sdk` pentru a crea o aplicație în ChatGPT?
Răspuns: Nu, acel pachet nu există. Construiți un server MCP folosind SDK-urile oficiale ale protocolului (@modelcontextprotocol/sdk pentru TypeScript, mcp pentru Python), adăugați opțional o interfață conformă cu standardul MCP Apps și distribuiți întregul ansamblu ca plugin.
2. Poate exista un instrument fără o interfață grafică (UI)?
Răspuns: Da, și chiar ar trebui: un instrument returnează structuredContent și un scurt rezumat text, ceea ce este suficient pentru model. Interfața grafică, atașată prin _meta.ui.resourceUri, se adaugă doar atunci când ajută utilizatorii să inspecteze, compare, editeze, confirme sau navigheze prin informații.
3. Cine decide dacă un utilizator are permisiunea de a accesa date?
Răspuns: Serverul MCP decide la fiecare cerere, pe baza token-ului OAuth verificat (semnătură, emitent, audiență, expirare, scopuri). Anotările ajută ChatGPT să aleagă nivelul adecvat de confirmare, dar nu înlocuiesc niciodată autorizarea lato-sensu de pe server.
4. Poate un plugin să vândă un abonament la serviciul său?
Răspuns: Nu. Regulile restricționează comerțul la bunuri fizice. Un abonat existent se poate autentifica și poate utiliza funcțiile incluse în planul său. Plugin-ul poate explica faptul că o funcție nu este inclusă și poate face link către o pagină informativă, dar nu trebuie niciodată să facă link către o pagină de plată.
5. Cum se actualizează instrumentele pentru un plugin publicat?
Răspuns: Fără un nou fișier ZIP: OpenAI re-scaneează serverul, iar orice instrument nou sau modificat devine disponibil după trecerea verificărilor automate. Un instrument șters dispare imediat. Totuși, metadatele și competențele necesită un nou fișier ZIP și o nouă revizuire.
Instrumente bine descrise, interfețe grafice opționale, autorizare lato-sensu pe server și respectarea regulilor: acesta este cadrul care transformă un plugin într-un serviciu fiabil în ChatGPT și Codex.