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

Apelarea programatică a instrumentelor: instrumente orchestrate de model

Lecția 5 din 12 Actualizată 5 noiembrie 2026 Intermediar
Pe această pagină
  1. Ce se schimbă
  2. Activarea în API-ul Responses
  3. Ce primește aplicația dumneavoastră
  4. Identificarea sarcinilor care beneficiază de această funcție
  5. Încercați chiar dumneavoastră
  6. Puncte cheie

Stare la data de 5 noiembrie 2026. Familia GPT-6 moștenește capacitățile API ale GPT-5.6, inclusiv Apelarea programatică a instrumentelor. API-ul Agents activează această funcție în mod implicit (Lecția 10). OpenAI recomandă verificarea fișei modelului înainte de a o activa.

Pentru a înțelege ce aduce nou Apelarea programatică a instrumentelor, trebuie mai întâi să analizați costul apelării clasice de funcții. Modelul solicită executarea unui instrument, codul dumneavoastră îl rulează, iar rezultatul se întoarce la model, care îl citește și decide pasul următor. O singură dus-întors nu este o problemă majoră. Zece dus-întorsuri pentru o singură sarcină reprezintă însă o altă situație: fiecare pas adaugă latență, iar fiecare rezultat intermediar — chiar dacă este voluminos sau irelevant pentru răspunsul final — trece din nou prin contextul modelului și este facturat în tokeni. În sarcinile care depind intens de instrumente, aceste dus-întorsuri domină atât latența, cât și costul.

Ce se schimbă

Apelarea programatică a instrumentelor a fost lansată odată cu GPT-5.6, la 9 iulie 2026, în API-ul Responses. În loc să solicite instrumentele unul câte unul, modelul scrie un mic program JavaScript pentru a le coordona. Acesta poate lansa apeluri în paralel, poate utiliza bucle și condiții și poate menține rezultatele intermediare în interiorul mediului de execuție. Doar rezultatul redus — cel care contează pentru pasul următor — se întoarce în context.

Luați în considerare un API paginat. În apelarea clasică de funcții, fiecare pagină de rezultate traversează contextul pentru ca modelul să poată decide dacă să solicite pagina următoare. Cu Apelarea programatică a instrumentelor, modelul scrie o buclă care iterază prin pagini, însumează ceea ce trebuie însumat și raportează doar totalurile: mai puțini tokeni, mai puțină latență și mai puțin cod de orchestrare pe care trebuie să îl întrețineți.

OpenAI execută fiecare program într-un mediu V8 proaspăt și izolat. Nu există Node.js, nu se instalează pachete, nu există acces direct la rețea, nu există un sistem de fișiere general și nu se păstrează nicio stare între programe. Programul interacționează cu lumea exterioară doar prin instrumentele pe care le expuneți. Pentru API-ul Responses, acest comportament este compatibil cu Zero Data Retention (ZDR), cu condiția ca ZDR să fie activat pentru organizație sau proiect.

Activarea în API-ul Responses

Sunt suficiente două setări. Adăugați instrumentul găzduit programmatic_tool_calling la cerere, apoi specificați cine poate apela fiecare instrument eligibil folosind allowed_callers: ["direct"] (comportamentul implicit, în care modelul apelează singur instrumentul), ["programmatic"] (doar un program îl poate apela) sau ambele. Documentația recomandă, de asemenea, descrierea ieșirii fiecărei funcții cu output_schema, astfel încât codul generat să se poată baza pe câmpurile sale.

from openai import OpenAI

client = OpenAI()

tools = [
    {
        "type": "function",
        "name": "read_stock",
        "description": "Returns an object with sku (text) and units (number).",
        "parameters": {
            "type": "object",
            "properties": {"sku": {"type": "string"}},
            "required": ["sku"],
            "additionalProperties": False,
        },
        "output_schema": {
            "type": "object",
            "properties": {"sku": {"type": "string"}, "units": {"type": "number"}},
            "required": ["sku", "units"],
            "additionalProperties": False,
        },
        "allowed_callers": ["programmatic"],
    },
    {"type": "programmatic_tool_calling"},
]

response = client.responses.create(
    model="gpt-5.6-terra",
    input="Check stock for SKUs A12, B07, and C33 and flag those under 10 units.",
    tools=tools,
)

Tipurile de instrumente care pot fi apelate dintr-un program includ funcții și instrumente personalizate, instrumente MCP, apply_patch, shell local sau găzduit și interpretul de cod. Pentru un instrument MCP care necesită aprobare, programul se pune în pauză până când acordați consimțământul.

Ce primește aplicația dumneavoastră

Răspunsul rămâne un obiect Responses standard cu trei tipuri de elemente de recunoscut. Un element program conține codul JavaScript generat. Elementele function_call corespund apelurilor de funcții efectuate de acel program; câmpul lor caller identifică programul apelant. În final, un element program_output livrează rezultatul final al programului, având starea completed sau incomplete.

Aplicația dumneavoastră nu execută niciodată codul JavaScript; OpenAI se ocupă de aceasta. Dumneavoastră executați doar propriile funcții, apoi returnați fiecare rezultat într-un function_call_output copiind câmpul caller nemodificat, astfel încât programul corect să poată relua execuția. Repetați acest ciclu până când răspunsul nu mai conține apeluri de executat.

Cine execută ce Trei pași: modelul scrie un program JavaScript pe care OpenAI îl execută într-un mediu izolat; aplicația dumneavoastră execută apelurile de funcții din acel program și returnează rezultatele cu câmpul caller intact; programul livrează un rezultat redus în program_output. APELARE PROGRAMATICĂ A INSTRUMENTELOR Cine execută ce 1 Program Scris de model 2 Funcțiile dumneavoastră Executate de dumneavoastră 3 Rezultat program_output redus JavaScript rulează la OpenAI, niciodată la dumneavoastră. Scrierile sensibile rămân apeluri directe.
Bazat pe ghidul de Apelare programatică a instrumentelor din documentația API OpenAI (noiembrie 2026).

Identificarea sarcinilor care beneficiază de această funcție

Nu fiecare integrare de instrumente beneficiază de migrare. Ghidul OpenAI oferă o regulă clară: Apelarea programatică a instrumentelor este potrivită pentru pașii în care fluxul este predictibil și codul poate returna un rezultat mai mic și structurat. Este concepută pentru a filtra, a uni, a sorta, a deduplica, a agrega sau a valida multiple rezultate, sau pentru a înlănțui apeluri dependente unde fluxul de date este predictibil. Apelarea directă rămâne preferabilă pentru o singură căutare sau acțiune, pentru căutări adaptive în care fiecare rezultat trebuie să ghideze decizia următoare și pentru validarea finală a citărilor. De asemenea, rămâne alegerea implicită pentru scrieri și acțiuni care necesită aprobare, pentru a menține o frontieră clară de autorizare.

Criteriul de decizie se reduce la o singură întrebare: unde își petrece agentul dumneavoastră timpul? Dacă răspunsul este „așteptând dus-întorsurile instrumentelor“, Apelarea programatică a instrumentelor este prima zonă de evaluat. Dacă apelurile de instrumente sunt rare, iar rezultatele lor scurte, păstrați arhitectura actuală și concentrați-vă eforturile în altă parte.

Încercați chiar dumneavoastră

Identificați un candidat. Luați un flux din agentul dumneavoastră care apelează multiple instrumente. Pentru fiecare pas, notați numărul de apeluri, dimensiunea rezultatelor intermediare și dacă este o citire sau o scriere. Clasificați fiecare pas folosind regula de mai sus. Pentru cel mai promițător pas, scrieți un prompt care specifică instrumentele permise, formatul rezultatului așteptat, condiția de oprire, numărul maxim de reîncercări și ce rămâne un apel direct.

Surse oficiale: Apelarea programatică a instrumentelor · Utilizarea GPT-6 (documentația API OpenAI) · Anunțul GPT-5.6 (OpenAI, 9 iulie 2026)

Puncte cheie

  • Modelul scrie și execută JavaScript pentru a-și coordona instrumentele într-un mediu izolat gestionat de OpenAI
  • Activați-l cu instrumentul programmatic_tool_calling și câmpul allowed_callers pentru fiecare instrument
  • Aplicația dumneavoastră execută doar funcțiile proprii și returnează câmpul caller intact
  • Preferați-l pentru filtrarea, agregarea sau înlănțuirea apelurilor predictibile; apelarea directă rămâne regula pentru scrieri și aprobări