Siirry pääsisältöön
OpenAI

10. syyskuuta 2026

TuoteAPI

Agents API:n esittely

Rakenna ja suorita pilviagentteja OpenAI:n täysin hallinnoimalla Codex-arviointikehyksellä.

Ladataan...

Kun olemme tuoneet Codexin ja ChatGPT for Workin miljoonien ihmisten käyttöön ympäri maailmaa, olemme oppineet, mitä pitkäkestoisten agenttien toimivuus käytännössä edellyttää. Hyödylliset agentit tarvitsevat tehokkaan arviointikehyksen, joka hallitsee kontekstia, käyttää työkaluja tehokkaasti ja koordinoi aliagentteja. Ne tarvitsevat myös infrastruktuurin, joka pitää ne luotettavasti toiminnassa päiväkausia, sekä ympäristöjä, joissa ne voivat käsitellä tiedostoja, suorittaa koodia ja tallentaa välituloksia.

Esittelemme tänään julkisena beetaversiona Agents API:n⁠(avautuu uudessa ikkunassa). Se tuo Codexin taustalla toimivan arviointikehyksen ja infrastruktuurin kehittäjien käyttöön yksinkertaisen ja joustavan API-rajapinnan kautta.

Mitä asiakkaamme sanovat Agents API:sta

1 / 8
”Agents API:n avulla arviointituloksemme nousi 0,71:stä 0,85:een. API:n aliagenttituki on erinomainen ja nopeutti työnkulkuamme huomattavasti. Aiemmassa toteutuksessamme aliagenttien seuranta ja orkestrointi oli melko työlästä, mutta uudet API-rajapinnat lyhensivät viivettä nelinkertaisesti. Käytimme pitkään aikaa tämän optimointiin, ja valmiit aliagenttien työnkulut paransivat toimintaamme valtavasti.”
Jack Weissenberger, teknologiajohtaja, Ciridae

Rakenna pilviagentteja yhdellä API-kutsulla

Agents API:lla voit luoda tuotantovalmiin agentin yhdellä API-kutsulla määrittämällä tehtävän, mallin, työkalut ja ympäristön:

JavaScript

1
import OpenAI from "openai";
2

3
const client = new OpenAI();
4

5
const session = await client.beta.agents.sessions.create({
6
agent: {
7
model: "gpt-6-astra",
8
tools: [
9
{
10
type: "mcp",
11
server_label: "observability",
12
transport: {
13
type: "http",
14
server_url: "https://observability.example.com/mcp",
15
},
16
},
17
],
18
multi_agent: { enabled: true, max_concurrent_subagents: 3 },
19
},
20
vault_ids: ["vault_YOUR_VAULT_ID"],
21
environment: {
22
type: "openai_hosted",
23
capability_directories: ["/workspace/capabilities/skills"],
24
},
25
input:
26
"Investigate service-api’s elevated 5xx rate over the last 30 minutes. " +
27
"Delegate deployment, error, and dependency analysis to subagents. " +
28
"Save findings, evidence, and recommended mitigation in /workspace/outputs.",
29
});

OpenAI isännöi ja ylläpitää arviointikehystä. Valitset agentin laskentaympäristön: OpenAI:n hallinnoiman eristysympäristön, oman infrastruktuurisi tai jonkin eristysympäristökumppanimme palvelun. Agents API tarjoaa vahvan perustan agenttien rakentamiseen optimoidun arviointikehyksemme ja infrastruktuurimme päälle, jotta voit keskittyä työkaluihin, tietoon ja työnkulkuihin, jotka tekevät agentistasi ainutlaatuisen.

Sovellus lähettää tehtäviä Agents API:lle ja vastaanottaa tapahtumia ja tulosteita. Agents API suorittaa hallinnoitua Codex-arviointikehystä, lähettää työkalukutsuja eristysympäristöön ja vastaanottaa työkalujen tuloksia. Sovellus hallitsee itse isännöityä laskentaympäristöä.

Agents API tarjoaa agenteillesi saman arviointikehyksen ja infrastruktuurin, joihin Codex perustuu.

Valitse agenttisi ympäristö

Eri työkuormat edellyttävät erilaisia laskenta-, tallennus- ja käyttöönottovaihtoehtoja. Agents API:ssa voit valita sovellukseesi sopivan eristysympäristön.

Teemme yhteistyötä ekosysteemin palveluntarjoajien⁠(avautuu uudessa ikkunassa), kuten Blaxelin, Cloudflaren, Daytonan, DigitalOceanin, E2B:n, Modalin, Oraclen, Runloopin ja Vercelin, kanssa tarjotaksemme ensiluokkaisia integraatioita erilaisiin tarpeisiin:

  • Täysin hallinnoidut ympäristöt tai käyttöönotot omassa VPC:ssäsi

  • Erityiset mekanismit tiedostojen ja salaisuuksien tallentamiseen

  • Erilaiset suoritin-, grafiikkasuoritin- ja muistikokoonpanot, joiden suorituskyky-, kylmäkäynnistys- ja kustannusprofiilit sopivat yrityksesi työnkulkuun.

Eristysympäristökumppanit: Modal, Cloudflare, Daytona, Blaxel, Runloop, Vercel, Oracle, E2B ja DigitalOcean.

Agents API tarjoaa ensiluokkaisia integraatioita suosittujen ekosysteemipalveluntarjoajien kanssa.

OpenAI:n isännöimät eristysympäristöt

Esittelemme nopeasti alkuun haluaville ja tehokasta skaalausta tarvitseville kehittäjille myös OpenAI:n isännöimän eristysympäristön⁠(avautuu uudessa ikkunassa). Se hyödyntää samaa eristysinfrastruktuuria, johon Codex ja ChatGPT perustuvat.

OpenAI ottaa eristysympäristön käyttöön ja hallinnoi sitä, joten agenttisi voi suorittaa koodia, käsitellä tiedostoja ja tuottaa aineistoja turvallisessa ja tehokkaassa ympäristössä. Eristysympäristöihin voi määrittää joustavasti tiedostosi, pakettisi, taitosi ja laajennuksesi, jotta agentilla on kaikki tehtävän suorittamiseen tarvittava.

Rakenna kehittyvän Codex-arviointikehyksen varaan

Mallien uusien ominaisuuksien hyödyntäminen edellyttää usein arviointikehyksen uudistamista, mikä vie arvokasta aikaa sovelluksesi kehittämiseltä. Agents API tarjoaa versioidun pääsyn näihin ominaisuuksiin jokaisen mallijulkaisun yhteydessä. Ylläpidämme ja parannamme arviointikehystä jatkuvasti malliemme rinnalla, jotta agenttisi hyötyvät jokaisesta päivityksestä entistä paremmin. Arviointikehykseen on hiljattain tehty esimerkiksi seuraavia parannuksia:

Pidä agentit toiminnassa pitkien istuntojen ajan

Jotta mallit voivat työskennellä tuntikausia, olemme rakentaneet kontekstinhallinnan, joka auttaa agentteja säilyttämään olennaiset tiedot pitkissä istunnoissa. Kun istunto lähestyy kontekstirajaansa, Agents API tiivistää aiemman kontekstin automaattisesti⁠(avautuu uudessa ikkunassa) ja säilyttää agentin jatkamiseen tarvitsemat tiedot. Kehittäjät voivat rakentaa useita konteksti-ikkunoita kattavia työnkulkuja toteuttamatta omaa kontekstin tiivistämisen logiikkaa.

Auta agentteja käyttämään useampia työkaluja tehokkaasti

Agents API auttaa agentteja löytämään oikeat työkalut ja käyttämään niitä tehokkaasti. Työkaluhaku⁠(avautuu uudessa ikkunassa) lataa tarvittavat työkalumääritykset tarpeen mukaan. Tämä vähentää tokenien käyttöä ja kustannuksia sekä säilyttää mallin välimuistin. Kun työkalut ovat käytettävissä, ohjelmalliset työkalukutsut⁠(avautuu uudessa ikkunassa) antavat agenttien suorittaa kutsuja rinnakkain, ketjuttaa toisiinsa liittyviä toimintoja sekä suodattaa tai yhdistää tuloksia koodissa. Näin ne voivat käsitellä suuria tietomääriä ja palauttaa kontekstiin vain olennaiset tulokset. Agents API tukee MCP:tä, mukautettuja funktioita ja sisäänrakennettuja työkaluja, kuten verkkohakua.

JSON

1
"agent": {
2
"tools": [
3
{
4
"type": "mcp",
5
"server_label": "openai_docs",
6
"transport": {
7
"type": "http",
8
"server_url": "https://developers.openai.com/mcp"
9
}
10
},
11
]
12
}

Anna agenttien rinnakkaistaa työ aliagenttien avulla

Usean agentin tuen⁠(avautuu uudessa ikkunassa) avulla Agents API voi jakaa monimutkaiset tehtävät itsenäisiin osiin ja siirtää ne rinnakkain toimiville aliagenteille. Jokainen aliagentti ylläpitää omaa kontekstiaan ja voi siten keskittyä tehtäväänsä, kun taas pääagentti koordinoi niiden työtä ja kokoaa tulokset yhteen. Tämä voi nopeuttaa rinnakkaisesta työstä hyötyviä tutkimus-, analyysi- ja ohjelmointitehtäviä ilman, että sinun tarvitsee rakentaa omaa orkestrointia.

JSON

1
"agent": {
2
"model": "gpt-6-astra",
3
"multi_agent": {
4
"enabled": true,
5
"max_concurrent_subagents": 3,
6
}
7
}

Avoimen lähdekoodin perusta

Agents API perustuu avoimen lähdekoodin Codex-arviointikehykseen, joten kehittäjät näkevät mallikutsuja, työkaluja ja kontekstia koordinoivan ydinlogiikan. Agents API:ssa OpenAI käyttää ja ylläpitää tätä arviointikehystä, ja kehittäjät voivat tutkia sen julkista koodikantaa⁠(avautuu uudessa ikkunassa) ja oppia siitä.

Aloita rakentaminen

Agents API on tänään julkisessa beetaversiossa kaikkien kehittäjien käytettävissä. Agents API:n käytöstä ei peritä lisämaksuja – maksat vain agenttiesi käyttämistä tokeneista ja työkaluista, kuten hinnoittelusivullamme⁠(avautuu uudessa ikkunassa) on esitetty.

Lue lisää Agents API:n yleiskatsauksesta⁠(avautuu uudessa ikkunassa) tai seuraa pika-aloitusopasta⁠(avautuu uudessa ikkunassa) päästäksesi alkuun ja tuo Codexin taustalla oleva arviointikehys omiin agentteihisi.

Julkisen beetaversion aikana kehitämme palvelua nopeasti palautteesi perusteella, kun etenemme kohti yleistä saatavuutta. Kerro meille, mikä toimii, missä kohtaat haasteita ja mitä tarvitset agenttien kehittämiseen ja käyttämiseen tuotantoympäristössä.

Tekijät

OpenAI