Hoppa till huvudinnehåll
Svenska— Välj ett språk
Meny

Programmatisk verktygsanrop: Modellorchestrerade verktyg

Lektion 5 av 12 Uppdaterad 5 november 2026 Medelnivå
På denna sida
  1. Vad som ändras
  2. Aktivera det i Responses API
  3. Vad din applikation tar emot
  4. Identifiera uppgifter som gynnas
  5. Testa själv
  6. Viktiga punkter

Status per den 5 november 2026. GPT-6-familjen ärver API-funktionerna från GPT-5.6, inklusive programmatisk verktygsanrop. Agents API aktiverar detta som standard (Lektion 10). OpenAI rekommenderar att du kontrollerar modellkortet innan du aktiverar det.

För att förstå vad programmatisk verktygsanrop tillför behöver du först titta på kostnaden för klassisk funktionsanrop. Modellen begär ett verktygsutförande, din kod kör det och resultatet skickas tillbaka till modellen, som läser det och beslutar om nästa steg. En tur och retur-resa är ingen stor sak. Tio tur och retur-resor för en enda uppgift är en annan historia: varje steg lägger till latens, och varje mellanresultat – även om det är skrymmande eller irrelevant för det slutgiltiga svaret – passerar tillbaka genom modellens kontext och debiteras i token. På verktygstunga uppgifter dominerar dessa tur och retur-resor både latens och kostnad.

Vad som ändras

Programmatisk verktygsanrop lanserades med GPT-5.6 den 9 juli 2026 i Responses API. Istället för att begära verktyg ett i taget skriver modellen ett litet JavaScript-program för att samordna dem. Den kan starta anrop parallellt, använda loopar och villkor, samt behålla mellanresultat inom körningsmiljön. Endast det reducerade resultatet – det som är viktigt för nästa steg – returneras till kontexten.

Tänk dig ett paginerat API. Vid klassisk funktionsanrop traverserar varje sida med resultat kontexten så att modellen kan avgöra om nästa ska begäras. Med programmatisk verktygsanrop skriver modellen en loop som itererar genom sidorna, summerar det som behöver summeras och rapporterar tillbaka endast totalsummorna: färre token, lägre latens och mindre orchestreringskod för dig att underhålla.

OpenAI kör varje program i en färsk, isolerad V8-miljö. Det finns ingen Node.js, ingen paketinstallation, ingen direkt nätverksåtkomst, inget generellt filsystem och inget tillstånd som bevaras mellan program. Programmet interagerar med omvärlden endast genom de verktyg du exponerar för det. För Responses API är detta beteende kompatibelt med Zero Data Retention (ZDR), förutsatt att ZDR är aktiverat för organisationen eller projektet.

Aktivera det i Responses API

Två inställningar räcker. Du lägger till det hostade verktyget programmatic_tool_calling i begäran och specificerar sedan vem som får anropa varje berättigat verktyg med allowed_callers: ["direct"] (standardbeteendet, där modellen anropar verktyget själv), ["programmatic"] (endast ett program kan anropa det) eller båda. Dokumentationen rekommenderar också att du beskriver utdata för varje funktion med output_schema så att den genererade koden kan förlita sig på dess fält.

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,
)

Verktygstyper som kan anropas från ett program inkluderar funktioner och anpassade verktyg, MCP-verktyg, apply_patch, lokal eller hostad shell samt kodtolken. För ett MCP-verktyg som kräver godkännande pausas programmet tills du beviljar samtycke.

Vad din applikation tar emot

Svaret förblir ett standard Responses-objekt med tre typer av element att känna igen. Ett program-element innehåller det genererade JavaScript-koden. function_call-element motsvarar dina funktionsanrop som görs av det programmet; deras caller-fält identifierar det anropande programmet. Slutligen levererar ett program_output-element programmets slutgiltiga resultat, med statusen completed eller incomplete.

Din applikation kör aldrig JavaScript-koden; det gör OpenAI. Du kör endast dina egna funktioner och returnerar sedan varje resultat i en function_call_output genom att kopiera caller-fältet oförändrat så att rätt program kan återupptas. Du loopar på detta sätt tills svaret inte innehåller fler anrop att utföra.

Vem kör vad Tre steg: modellen skriver ett JavaScript-program som OpenAI kör i en isolerad miljö; din applikation kör funktionsanropen från det programmet och returnerar resultaten med caller-fältet intakt; programmet levererar ett reducerat resultat i program_output. PROGRAMMATISK VERKTYGSANROP Vem kör vad 1 Program Skrivet av modellen 2 Dina funktioner Körs av dig 3 Resultat Reducerat program_output JavaScript körs hos OpenAI, aldrig på din sida. Känsliga skrivoperationer förblir direkta anrop.
Baserat på guiden för programmatisk verktygsanrop i OpenAI API-dokumentationen (november 2026).

Identifiera uppgifter som gynnas

Inte varje verktygsintegration gynnas av en migrering. OpenAIs guide erbjuder en tydlig regel: programmatisk verktygsanrop passar steg där flödet är förutsägbart och koden kan returnera ett mindre, strukturerat resultat. Det är designat för att filtrera, sammanfoga, sortera, deduplicera, aggregera eller validera flera resultat, eller för att kedja beroende anrop där dataflödet är förutsägbart. Direkt anrop förblir att föredra för en enda sökning eller åtgärd, för adaptiva sökningar där varje resultat måste styra nästa beslut, och för slutgiltig citeringsvalidering. Det förblir också standardvalet för skrivoperationer och åtgärder som kräver godkännande för att upprätthålla en tydlig auktoriseringsgräns.

Beslutskriteriet kokar ner till en fråga: var spenderar din agent sin tid? Om svaret är “väntar på verktygs tur och retur-resor”, är programmatisk verktygsanrop det första området att utvärdera. Om dina verktygsanrop är sällsynta och deras resultat korta, behåll din nuvarande arkitektur och fokusera dina ansträngningar någon annanstans.

Testa själv

Identifiera en kandidat. Ta ett flöde i din agent som anropar flera verktyg. För varje steg, notera antalet anrop, storleken på mellanresultaten och om det är en läs- eller skrivoperation. Klassificera varje steg med hjälp av regeln ovan. För det mest lovande steget, skriv en prompt som specificerar de tillåtna verktygen, det förväntade resultatformatet, stoppvillkoret, maximalt antal försök och vad som förblir ett direkt anrop.

Officiella källor: Programmatisk verktygsanrop · Använda GPT-6 (OpenAI API-dokumentation) · GPT-5.6-annonsering (OpenAI, 9 juli 2026)

Viktiga punkter

  • Modellen skriver och kör JavaScript för att samordna sina verktyg i en isolerad miljö som hanteras av OpenAI
  • Aktivera det med verktyget programmatic_tool_calling och fältet allowed_callers på varje verktyg
  • Din applikation kör endast sina funktioner och returnerar caller-fältet intakt
  • Föredra det för filtrering, aggregering eller kedjning av förutsägbara anrop; direkt anrop förblir regeln för skrivoperationer och godkännanden