Ħarsa ġenerali

L-Agents API hija disponibbli f’verżjoni beta. Tippermetti lill-iżviluppaturi jibnu applikazzjonijiet b’aġent Codex ġestit minn OpenAI li jista’ jaħdem fuq diversi passi u jkompli fl-istess sessjoni.

L-applikazzjoni tiegħek tipprovdi l-kompitu, l-għodod u l-konfigurazzjoni. OpenAI timmaniġġja s-sessjoni tal-aġent u l-koordinazzjoni bejn il-mudell u l-għodod tiegħu.

X’jista’ jagħmel aġent?

Skont l-għodod u l-ambjent ta’ eżekuzzjoni tiegħu, aġent jista’ jħaddem kodiċi, jeditja fajls, juża konnessjonijiet MCP u joħloq fajls għall-applikazzjoni tiegħek. Tista’ tibgħat struzzjonijiet addizzjonali jew tkompli b’kompitu ieħor fl-istess sessjoni.

Ara l-ħarsa ġenerali lejn l-Agents API għall-kapaċitajiet appoġġjati u eżempji.

Kif nibda?

1. Oħloq ċavetta API għall-applikazzjoni fil-proġett tiegħek fuq il-Pjattaforma OpenAI. Agħti l-permessi api.agents.read u api.agents.write għas-sessjonijiet, kif ukoll api.responses.write għat-talbiet lill-mudell.

2. Segwi l-gwida tal-bidu rapidu biex tikkonfigura aġent, toħloq sessjoni u tissottometti kompitu.

3. Segwi l-avvenimenti tas-sessjoni biex tirrevedi l-progress u r-riżultati. Issejvja l-ID tas-sessjoni jekk trid tkompli x-xogħol.

Żomm iċ-ċavetta API tiegħek barra mis-sandbox tal-aġent. It-talbiet jeħtieġu l-header OpenAI-Beta: agents=v1. L-SDKs ta’ OpenAI jżidu dan il-header awtomatikament.

L-aġent tiegħi għandu bżonn sandbox?

Agħżel l-ambjent li jaqbel mal-kompitu:

• Mingħajr ambjent: L-aġent iwieġeb mistoqsijiet jew juża għodod esterni mingħajr ma jkollu bżonn kmandi integrati tas-shell jew fajls tal-ispazju tax-xogħol.

• Sandbox ospitata minn OpenAI: L-aġent għandu bżonn iħaddem scripts jew jaħdem bil-fajls, u trid li OpenAI timmaniġġja s-sandbox tiegħu.

• Sandbox ospitata minnek stess: Għandek bżonn l-infrastruttura, is-software jew in-network privat tiegħek stess. L-applikazzjoni tiegħek timmaniġġja ċ-ċiklu tal-ħajja tal-ambjent.

Ara l-arkitettura tal-Agents API għad-dettalji tal-konfigurazzjoni.

Fejn nista’ nirrevedi sessjoni?

Iftaħ ir-Reġistri fid-dashboard tal-Pjattaforma, agħżel Aġenti, u fittex l-ID tas-sessjoni. Tista’ tispezzjona d-dawriet, is-sejħiet lill-għodod u l-attività tas-sottoaġenti.

Il-gwida dwar l-osservabbiltà tispjega wkoll kif tirrevedi l-użu rreġistrat tat-tokens.

X’jiġri jekk il-fluss tal-avvenimenti jinqata’?

Irkupra s-sessjoni eżistenti u l-elementi ssejvjati tagħha qabel terġa’ tipprova. Dan jgħinek tiċċekkja x’ġara qabel tissottometti aktar xogħol.

Dawra kompluta ma tfissirx li kull għodda ħadmet b’suċċess. Irrevedi r-riżultat irrappurtat. Il-fatt li sessjoni tkun inattiva ma jfissirx, waħdu, li l-kompitu tlesta b’suċċess.

Kif jiġi fatturat l-użu?

Għat-talbiet lill-mudell japplikaw ir-rati tal-API tal-mudell magħżul. Għall-għodod ta’ OpenAI u s-sandboxes ospitati minn OpenAI japplikaw ir-rati rispettivi tal-għodod u tal-containers.

Ara il-prezzijiet tal-API għar-rati attwali.

Kif jiġu ttrattati d-dejta u l-fajls tas-sessjoni?

L-Agents API żżomm l-istat tas-sessjoni biex ix-xogħol ikun jista’ jkompli minn dawra għall-oħra. Tista’ tħassar is-sessjonijiet u l-artefatti ppubblikati meta ma jibqgħux meħtieġa. Issejvja kwalunkwe fajl li għandek bżonn qabel tħassar sessjoni.

L-Agents API bħalissa tappoġġja r-residenza tad-dejta fl-Istati Uniti biss. Ma tappoġġjax l-għażla ta’ l-ebda żamma tad-dejta, lanqas meta tuża sandbox ospitata minnek stess. Ara d-dokumentazzjoni tal-Agents API għad-dettalji dwar il-kontrolli tad-dejta.