[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"portal-settings:stajic:it":3,"public-menus:all":38,"post:openai-agents-api-vs-agents-sdk-vs-responses-api-what-should-you-build-on-in-2026:it":205,"related:post:openai-agents-api-vs-agents-sdk-vs-responses-api-what-should-you-build-on-in-2026:it:1":1585},{"statusCode":4,"data":5,"message":37},200,{"tenantId":6,"lang":7,"defaultLang":8,"siteUrl":9,"contactEmail":10,"brandName":11,"logoUrl":12,"siteName":11,"siteDescription":13,"ogImage":10,"robotsIndex":14,"socialLinks":10,"reservedSlugs":10,"seoPolicy":15},"stajic","it","de","https:\u002F\u002Fstajic.de",null,"Stajic Platform","\u002FLogo_Planet.svg","Stajic Portal",true,{"branding":16,"relatedContent":17,"crossDomainLinks":18},{"logoUrl":12},{"enabled":14},[19,22,25,28,31,34],{"url":20,"label":21,"isActive":14,"showInFooter":14,"includeInSameAs":14},"https:\u002F\u002Ffigure.rocks","figure.rocks",{"url":23,"label":24,"isActive":14,"showInFooter":14,"includeInSameAs":14},"https:\u002F\u002Floving.rocks","loving.rocks",{"url":26,"label":27,"isActive":14,"showInFooter":14,"includeInSameAs":14},"https:\u002F\u002Fbazify.com","bazify.com",{"url":29,"label":30,"isActive":14,"showInFooter":14,"includeInSameAs":14},"https:\u002F\u002Fbazify.de","bazify.de",{"url":32,"label":33,"isActive":14,"showInFooter":14,"includeInSameAs":14},"https:\u002F\u002Fbazify.at","bazify.at",{"url":35,"label":36,"isActive":14,"showInFooter":14,"includeInSameAs":14},"https:\u002F\u002Fbazify.ba","bazify.ba","Portal settings resolved",[39,45],{"id":40,"name":41,"location":42,"isActive":14,"isDefault":43,"items":44},1,"main-navigation","header",false,[],{"id":46,"name":47,"location":48,"isActive":14,"isDefault":14,"items":49},4,"main-menu","sidebar",[50,66,79,93,103,118,133],{"id":51,"title":52,"url":60,"target":61,"icon":62,"isActive":14,"type":63,"productId":10,"categoryId":10,"shopCategoryId":10,"articleId":10,"pageId":64,"portfolioId":10,"children":65},"item-18",{"de":53,"en":54,"es":55,"fr":56,"it":54,"ru":57,"sr":58,"zh":59},"Startseite","Home","Inicio","Accueil","Главная","Почетна","首页","\u002Ffull-stack-web-developer-munich-performance-seo-and-maintainable-builds","_self","i-lucide-home","page",111,[],{"id":67,"title":68,"url":75,"target":61,"icon":76,"isActive":14,"type":63,"productId":10,"categoryId":10,"shopCategoryId":10,"articleId":10,"pageId":77,"portfolioId":10,"children":78},"item-22",{"de":69,"en":69,"es":70,"fr":69,"it":71,"ru":72,"sr":73,"zh":74},"Vision","Visión","Visione","Видение","Визија","想象","\u002Fueber-uns-webdesign-muenchen-webaplikation","i-lucide-eye",113,[],{"id":80,"title":81,"url":89,"target":61,"icon":90,"isActive":14,"type":63,"productId":10,"categoryId":10,"shopCategoryId":10,"articleId":10,"pageId":91,"portfolioId":10,"children":92},"item-19",{"de":82,"en":83,"es":84,"fr":83,"it":85,"ru":86,"sr":87,"zh":88},"Leistungen","Services","Servicios","Servizi","Услуги","Услуге","服务","\u002Fservices-dienstleistungen-muenchen","i-lucide-wrench",116,[],{"id":94,"title":95,"url":99,"target":61,"icon":100,"isActive":14,"type":63,"productId":10,"categoryId":10,"shopCategoryId":10,"articleId":10,"pageId":101,"portfolioId":10,"children":102},"item-23",{"de":96,"en":96,"es":96,"fr":96,"it":96,"ru":97,"sr":97,"zh":98},"Blog","Блог","博客","\u002Fblog","i-lucide-book-open",112,[],{"id":104,"title":105,"url":114,"target":61,"icon":115,"isActive":14,"type":63,"productId":10,"categoryId":10,"shopCategoryId":10,"articleId":10,"pageId":116,"portfolioId":10,"children":117},"item-32",{"de":106,"en":107,"es":108,"fr":109,"it":110,"ru":111,"sr":112,"zh":113},"Neue Technologien","New Technologies","Nuevas tecnologías","Nouvelles technologies","Nuove tecnologie","Новые технологии","Нове технологије","新技术！","\u002Fneue-webtechnologien","i-lucide-sparkles",122,[],{"id":119,"title":120,"url":129,"target":61,"icon":130,"isActive":14,"type":63,"productId":10,"categoryId":10,"shopCategoryId":10,"articleId":10,"pageId":131,"portfolioId":10,"children":132},"item-20",{"de":121,"en":122,"es":123,"fr":124,"it":125,"ru":126,"sr":127,"zh":128},"Kontakt","Contact us!","Contacto","Contact","Contatto","Контакт","Контактирајте нас","联系我们！","\u002Fcontact","i-lucide-mail",115,[],{"id":134,"title":135,"url":144,"target":61,"icon":145,"isActive":14,"type":63,"productId":10,"categoryId":10,"shopCategoryId":10,"articleId":10,"pageId":146,"portfolioId":10,"children":147},"item-21",{"de":136,"en":137,"es":138,"fr":139,"it":140,"ru":141,"sr":142,"zh":143},"Unsere Arbeit","Our Work","Nuestro trabajo","Nos réalisations","I nostri lavori","Наши работы","Наши радови","文件夹","\u002Fportfolio","i-lucide-briefcase",114,[148,161,175,181,193],{"id":149,"title":150,"url":144,"target":61,"icon":159,"isActive":14,"type":63,"productId":10,"categoryId":10,"shopCategoryId":10,"articleId":10,"pageId":146,"portfolioId":10,"children":160},"item-24",{"de":151,"en":152,"es":153,"fr":154,"it":155,"ru":156,"sr":157,"zh":158},"Alle Projekte","All Projects","Todos los proyectos","Tous les projets","Tutti i progetti","Все проекты","Сви пројекти","所有项目","i-lucide-grid-3x3",[],{"id":162,"title":163,"url":171,"target":61,"icon":172,"isActive":14,"type":173,"productId":10,"categoryId":10,"shopCategoryId":10,"articleId":10,"pageId":10,"portfolioId":10,"children":174},"item-29",{"de":164,"en":165,"es":166,"fr":167,"it":168,"ru":169,"sr":170,"zh":143},"Local Roots, Global Reach","Local Roots - Global Reach","Empresa local ","Entreprise locale","Azienda locale","Местная компания","Локално предузеће глобално тржиште","\u002Fportfolio\u002Flocal-roots-global-reach-communication-media-systems-for-modern-business","i-lucide-folder","custom",[],{"id":176,"title":177,"url":179,"target":61,"icon":172,"isActive":14,"type":173,"productId":10,"categoryId":10,"shopCategoryId":10,"articleId":10,"pageId":10,"portfolioId":10,"children":180},"item-28",{"de":178,"en":178,"es":178,"fr":178,"it":178,"ru":178,"sr":178,"zh":178},"Solr Suggester","\u002Fportfolio\u002Fsolr-fuzzy-suggester-und-solr-infix-suggester-abfrage-ueber-ajax-und-filterung",[],{"id":182,"title":183,"url":191,"target":61,"icon":172,"isActive":14,"type":173,"productId":10,"categoryId":10,"shopCategoryId":10,"articleId":10,"pageId":10,"portfolioId":10,"children":192},"item-27",{"de":184,"en":185,"es":186,"fr":187,"it":188,"ru":189,"sr":190,"zh":185},"Firmenwebseite SEO","Company Website SEO","Sitio web corporativo SEO","Site web d’entreprise SEO","Sito web aziendale SEO","Корпоративный сайт SEO","Пословна веб-страница SEO","\u002Fportfolio\u002Fseo-sem-branding-mobile-webseite-muenchen",[],{"id":194,"title":195,"url":203,"target":61,"icon":172,"isActive":14,"type":173,"productId":10,"categoryId":10,"shopCategoryId":10,"articleId":10,"pageId":10,"portfolioId":10,"children":204},"item-31",{"de":196,"en":197,"es":198,"fr":199,"it":200,"ru":201,"sr":202,"zh":197},"Digitalisierungsportal","Digitalization Portal","Portal de digitalización","Portail de numérisation","Portale di digitalizzazione","Портал цифровизации","Портал за дигитализацију","\u002Fportfolio\u002Fdigitalisierungsportal-archiv-museum-bibliothek-ead-lido-mets-mods",[],{"statusCode":4,"data":206,"message":1584},{"id":207,"title":208,"slug":209,"content":210,"contentJson":211,"excerpt":796,"featuredImage":797,"featuredImageAlt":798,"featuredImageCaption":10,"featuredImageTitle":10,"featuredImageCopyright":10,"featuredImageAuthor":10,"featuredImageSourceUrl":10,"featuredImageLicense":10,"featuredImageIsAiGenerated":43,"status":799,"publishedAt":800,"createdAt":801,"updatedAt":802,"seoLocalePaths":803,"categories":812,"author":824,"translations":829},"473","OpenAI Agents API vs Agents SDK vs Responses API: Su cosa dovresti sviluppare nel 2026?","openai-agents-api-vs-agents-sdk-vs-responses-api-what-should-you-build-on-in-2026","\u003Cnav class=\"editorjs-toc\" data-editorjs-toc=\"true\" aria-label=\"Indice\">\u003Cstrong class=\"editorjs-toc__title\">Indice\u003C\u002Fstrong>\u003Col class=\"editorjs-toc__list editorjs-toc__list--depth-0\">\u003Cli class=\"editorjs-toc__item\">\u003Ca href=\"#section-6\" class=\"editorjs-toc__link\">L'architettura è cambiata: scegli un perimetro di runtime, non una libreria\u003C\u002Fa>\u003C\u002Fli>\u003Cli class=\"editorjs-toc__item\">\u003Ca href=\"#section-9\" class=\"editorjs-toc__link\">Il confronto in sintesi\u003C\u002Fa>\u003C\u002Fli>\u003Cli class=\"editorjs-toc__item\">\u003Ca href=\"#section-11\" class=\"editorjs-toc__link\">1. Agents API: harness gestito, agente cloud duraturo\u003C\u002Fa>\u003Col class=\"editorjs-toc__list editorjs-toc__list--depth-1\">\u003Cli class=\"editorjs-toc__item\">\u003Ca href=\"#section-15\" class=\"editorjs-toc__link\">Cosa ottieni con la Agents API\u003C\u002Fa>\u003C\u002Fli>\u003Cli class=\"editorjs-toc__item\">\u003Ca href=\"#section-17\" class=\"editorjs-toc__link\">Cosa rimane sotto la tua gestione\u003C\u002Fa>\u003C\u002Fli>\u003C\u002Fol>\u003C\u002Fli>\u003Cli class=\"editorjs-toc__item\">\u003Ca href=\"#section-19\" class=\"editorjs-toc__link\">2. Responses API: gestisci il ciclo, usa le primitive della piattaforma\u003C\u002Fa>\u003C\u002Fli>\u003Cli class=\"editorjs-toc__item\">\u003Ca href=\"#section-23\" class=\"editorjs-toc__link\">3. Agents SDK: supportato, ma non più il percorso predefinito per il futuro\u003C\u002Fa>\u003C\u002Fli>\u003Cli class=\"editorjs-toc__item\">\u003Ca href=\"#section-28\" class=\"editorjs-toc__link\">Dove si colloca il Codex SDK\u003C\u002Fa>\u003C\u002Fli>\u003Cli class=\"editorjs-toc__item\">\u003Ca href=\"#section-31\" class=\"editorjs-toc__link\">Il test sul controllo del runtime\u003C\u002Fa>\u003C\u002Fli>\u003Cli class=\"editorjs-toc__item\">\u003Ca href=\"#section-34\" class=\"editorjs-toc__link\">Un albero decisionale per i nuovi sistemi\u003C\u002Fa>\u003C\u002Fli>\u003Cli class=\"editorjs-toc__item\">\u003Ca href=\"#section-36\" class=\"editorjs-toc__link\">Cosa non dovrebbe guidare la decisione\u003C\u002Fa>\u003C\u002Fli>\u003Cli class=\"editorjs-toc__item\">\u003Ca href=\"#section-38\" class=\"editorjs-toc__link\">La migrazione è un cambiamento architetturale, non la ridenominazione di una import\u003C\u002Fa>\u003Col class=\"editorjs-toc__list editorjs-toc__list--depth-1\">\u003Cli class=\"editorjs-toc__item\">\u003Ca href=\"#section-41\" class=\"editorjs-toc__link\">L'inventario per la migrazione\u003C\u002Fa>\u003C\u002Fli>\u003C\u002Fol>\u003C\u002Fli>\u003Cli class=\"editorjs-toc__item\">\u003Ca href=\"#section-43\" class=\"editorjs-toc__link\">La beta pubblica cambia il modello di rischio\u003C\u002Fa>\u003C\u002Fli>\u003Cli class=\"editorjs-toc__item\">\u003Ca href=\"#section-46\" class=\"editorjs-toc__link\">Un'architettura predefinita pratica\u003C\u002Fa>\u003C\u002Fli>\u003Cli class=\"editorjs-toc__item\">\u003Ca href=\"#section-50\" class=\"editorjs-toc__link\">Cosa potrebbe cambiare questa risposta?\u003C\u002Fa>\u003C\u002Fli>\u003Cli class=\"editorjs-toc__item\">\u003Ca href=\"#section-53\" class=\"editorjs-toc__link\">Limitazioni\u003C\u002Fa>\u003C\u002Fli>\u003Cli class=\"editorjs-toc__item\">\u003Ca href=\"#section-56\" class=\"editorjs-toc__link\">Conclusione\u003C\u002Fa>\u003C\u002Fli>\u003Cli class=\"editorjs-toc__item\">\u003Ca href=\"#section-59\" class=\"editorjs-toc__link\">FAQ\u003C\u002Fa>\u003C\u002Fli>\u003Cli class=\"editorjs-toc__item\">\u003Ca href=\"#section-61\" class=\"editorjs-toc__link\">Glossario\u003C\u002Fa>\u003C\u002Fli>\u003Cli class=\"editorjs-toc__item\">\u003Ca href=\"#section-63\" class=\"editorjs-toc__link\">Fonti primarie e approfondimenti\u003C\u002Fa>\u003C\u002Fli>\u003C\u002Fol>\u003C\u002Fnav>\n\u003Cp>Lo stack per agenti di OpenAI è cambiato radicalmente a settembre 2026. La nuova Agents API ha introdotto un harness Codex gestito per agenti cloud duraturi, mentre il precedente Agents SDK è passato a una fase di manutenzione feature-complete. La Responses API rimane la superficie di livello inferiore per le applicazioni che necessitano di chiamate dirette al modello o che desiderano gestire autonomamente l'agent loop. Non si tratta di tre wrapper intercambiabili per la stessa cosa: definiscono il perimetro di runtime in punti diversi.\u003C\u002Fp>\n\u003Caside class=\"editorjs-callout editorjs-callout--info my-6 rounded-xl border p-5 border-blue-300 bg-blue-50 dark:border-blue-900 dark:bg-blue-950\u002F20\" role=\"note\">\u003Cstrong class=\"block mb-2 text-gray-900 dark:text-gray-100\">Risposta diretta\u003C\u002Fstrong>\u003Cdiv class=\"text-gray-700 dark:text-gray-200\"><strong>Per una nuova applicazione di agenti nativa di OpenAI a settembre 2026, inizia con la Agents API, a meno che non ci sia una ragione concreta per gestire direttamente una porzione maggiore del runtime.<\u002Fstrong> Usa la Responses API quando la tua applicazione deve controllare il loop, la strategia dello stato e l'orchestrazione. Mantieni l'Agents SDK per le applicazioni esistenti o per sopperire a carenze temporanee laddove la Agents API non supporti ancora una funzionalità necessaria. Se desideri l'harness Codex in sé ma devi eseguirlo in un'infrastruttura gestita da te, valuta il Codex SDK invece di forzare l'Agents SDK in quel ruolo.\u003C\u002Fdiv>\u003C\u002Faside>\n\u003Caside class=\"editorjs-callout editorjs-callout--warning my-6 rounded-xl border p-5 border-amber-300 bg-amber-50 dark:border-amber-900 dark:bg-amber-950\u002F20\" role=\"note\">\u003Cstrong class=\"block mb-2 text-gray-900 dark:text-gray-100\">Decisione architetturale vincolata alla data\u003C\u002Fstrong>\u003Cdiv class=\"text-gray-700 dark:text-gray-200\">Questo articolo riflette lo stato della piattaforma di OpenAI al <strong>25 settembre 2026<\u002Fstrong>. La Agents API è stata lanciata in beta pubblica il 10 settembre 2026. Le interfacce in beta, la copertura delle funzionalità, i prezzi e le guide alla migrazione possono variare; verifica la documentazione aggiornata prima di confermare un'architettura di produzione.\u003C\u002Fdiv>\u003C\u002Faside>\n\u003Caside class=\"editorjs-callout editorjs-callout--note my-6 rounded-xl border p-5 border-gray-300 bg-gray-50 dark:border-gray-700 dark:bg-gray-900\u002F40\" role=\"note\">\u003Cstrong class=\"block mb-2 text-gray-900 dark:text-gray-100\">Il modello decisionale utilizzato qui\u003C\u002Fstrong>\u003Cdiv class=\"text-gray-700 dark:text-gray-200\">Il Runtime Ownership Test riportato di seguito è un modello architetturale pratico, non una tassonomia ufficiale dei prodotti OpenAI. Chiede quali parti del runtime dell'agente il tuo team deve controllare rispetto a quali parti desideri siano gestite da OpenAI.\u003C\u002Fdiv>\u003C\u002Faside>\n\u003Ch2 id=\"section-6\">L'architettura è cambiata: scegli un perimetro di runtime, non una libreria\u003C\u002Fh2>\n\u003Cp>La decisione cruciale non è più semplicemente «Quale SDK dovrei installare?» Riguarda chi gestisce l'harness, l'agent loop, lo stato duraturo della sessione, la compattazione del contesto, il ripristino, l'ambiente di esecuzione e il ciclo di vita dell'applicazione.\u003C\u002Fp>\n\u003Cp>L'attuale panoramica di OpenAI sugli agenti rende esplicito questo confine. La Agents API esegue un harness Codex ospitato e gestisce l'orchestrazione insieme allo stato duraturo della sessione. La Responses API fornisce risposte del modello e funzionalità ospitate mentre la tua applicazione gestisce l'agent loop circostante. L'Agents SDK esegue il loop nella tua applicazione ed è ora completo dal punto di vista delle funzionalità, non rappresentando più la strada principale per lo sviluppo di nuove funzionalità per gli agenti.\u003C\u002Fp>\n\u003Ch2 id=\"section-9\">Il confronto in sintesi\u003C\u002Fh2>\n\u003Cdiv class=\"overflow-x-auto\">\u003Ctable class=\"w-full border-collapse\">\u003Cthead>\u003Ctr>\u003Cth class=\"border border-gray-300 px-4 py-2 text-left font-semibold\">Opzione\u003C\u002Fth>\u003Cth class=\"border border-gray-300 px-4 py-2 text-left font-semibold\">Ideale nel 2026\u003C\u002Fth>\u003Cth class=\"border border-gray-300 px-4 py-2 text-left font-semibold\">Chi gestisce l'agent loop?\u003C\u002Fth>\u003Cth class=\"border border-gray-300 px-4 py-2 text-left font-semibold\">Responsabilità di sessione \u002F contesto\u003C\u002Fth>\u003Cth class=\"border border-gray-300 px-4 py-2 text-left font-semibold\">Stato strategico\u003C\u002Fth>\u003C\u002Ftr>\u003C\u002Fthead>\u003Ctbody>\u003Ctr>\u003Ctd class=\"border border-gray-300 px-4 py-2\">Agents API\u003C\u002Ftd>\u003Ctd class=\"border border-gray-300 px-4 py-2\">Nuovi agenti duraturi nativi di OpenAI\u003C\u002Ftd>\u003Ctd class=\"border border-gray-300 px-4 py-2\">Harness Codex gestito da OpenAI\u003C\u002Ftd>\u003Ctd class=\"border border-gray-300 px-4 py-2\">OpenAI gestisce sessioni, orchestrazione, compattazione e ripristino\u003C\u002Ftd>\u003Ctd class=\"border border-gray-300 px-4 py-2\">Punto di partenza consigliato per nuove app di agenti; beta pubblica\u003C\u002Ftd>\u003C\u002Ftr>\u003Ctr>\u003Ctd class=\"border border-gray-300 px-4 py-2\">Responses API\u003C\u002Ftd>\u003Ctd class=\"border border-gray-300 px-4 py-2\">Integrazioni dirette dei modelli e runtime di agenti personalizzati\u003C\u002Ftd>\u003Ctd class=\"border border-gray-300 px-4 py-2\">La tua applicazione\u003C\u002Ftd>\u003Ctd class=\"border border-gray-300 px-4 py-2\">Scegli tu il concatenamento delle risposte, le Conversations, lo storage e la logica del loop\u003C\u002Ftd>\u003Ctd class=\"border border-gray-300 px-4 py-2\">Primitiva API principale; consigliata rispetto a Chat Completions per i nuovi progetti\u003C\u002Ftd>\u003C\u002Ftr>\u003Ctr>\u003Ctd class=\"border border-gray-300 px-4 py-2\">Agents SDK\u003C\u002Ftd>\u003Ctd class=\"border border-gray-300 px-4 py-2\">Applicazioni SDK esistenti o lacune temporanee di funzionalità\u003C\u002Ftd>\u003Ctd class=\"border border-gray-300 px-4 py-2\">La tua applicazione tramite il runner dell'SDK\u003C\u002Ftd>\u003Ctd class=\"border border-gray-300 px-4 py-2\">La tua applicazione gestisce deployment, storage e comportamento a runtime\u003C\u002Ftd>\u003Ctd class=\"border border-gray-300 px-4 py-2\">Feature complete; manutenzione e compatibilità continuano, non sono previste nuove funzionalità principali\u003C\u002Ftd>\u003C\u002Ftr>\u003Ctr>\u003Ctd class=\"border border-gray-300 px-4 py-2\">Codex SDK\u003C\u002Ftd>\u003Ctd class=\"border border-gray-300 px-4 py-2\">Harness Codex su un'infrastruttura gestita da te\u003C\u002Ftd>\u003Ctd class=\"border border-gray-300 px-4 py-2\">Harness Codex nel tuo ambiente\u003C\u002Ftd>\u003Ctd class=\"border border-gray-300 px-4 py-2\">Gestisci l'hosting dell'harness e il ciclo di vita\u003C\u002Ftd>\u003Ctd class=\"border border-gray-300 px-4 py-2\">Opzione separata quando desideri l'harness senza il runtime gestito della Agents API\u003C\u002Ftd>\u003C\u002Ftr>\u003C\u002Ftbody>\u003C\u002Ftable>\u003C\u002Fdiv>\n\u003Ch2 id=\"section-11\">1. Agents API: harness gestito, agente cloud duraturo\u003C\u002Fh2>\n\u003Cp>La Agents API espone l'harness Codex attraverso un servizio gestito da OpenAI. OpenAI gestisce le sessioni, l'orchestrazione, la compattazione del contesto e il ripristino. La tua applicazione continua a fornire gli strumenti e a selezionare l'ambiente di esecuzione.\u003C\u002Fp>\n\u003Cp>Quest'ultima distinzione è importante. «Agente gestito» non significa necessariamente «tutta l'elaborazione viene eseguita all'interno di OpenAI». L'architettura della Agents API supporta l'assenza di ambiente, un ambiente ospitato da OpenAI oppure un ambiente self-hosted collegato all'harness gestito. Con un ambiente self-hosted, la tua applicazione gestisce provisioning, riconnessione, arresto e file persistenti, mentre l'harness rimane gestito.\u003C\u002Fp>\n\u003Cp>La Agents API è quindi un servizio di runtime, non un semplice formato di richiesta. Le sessioni possono persistere, inviare lo stato di avanzamento in streaming, ricevere task aggiuntivi, usare strumenti, manipolare file e ripristinarsi nel corso di attività prolungate.\u003C\u002Fp>\n\u003Ch3 id=\"section-15\">Cosa ottieni con la Agents API\u003C\u002Fh3>\n\u003Cul>\u003Cli>Un harness Codex gestito invece di dover costruire e gestire autonomamente l'agent loop principale.\u003C\u002Fli>\u003Cli>Sessioni durature per attività che si estendono su più turni e operazioni di lunga durata.\u003C\u002Fli>\u003Cli>Orchestrazione, compattazione del contesto e ripristino gestiti.\u003C\u002Fli>\u003Cli>Ambienti di esecuzione ospitati da OpenAI o self-hosted, a seconda dei requisiti del carico di lavoro.\u003C\u002Fli>\u003Cli>Streaming e webhook per gli avanzamenti e gli eventi del ciclo di vita.\u003C\u002Fli>\u003Cli>Una direzione di piattaforma che OpenAI raccomanda esplicitamente per le nuove applicazioni basate su agenti.\u003C\u002Fli>\u003C\u002Ful>\n\u003Ch3 id=\"section-17\">Cosa rimane sotto la tua gestione\u003C\u002Fh3>\n\u003Cul>\u003Cli>Il tuo prodotto e il server dell'applicazione.\u003C\u002Fli>\u003Cli>Le implementazioni dei function tool e la logica di business.\u003C\u002Fli>\u003Cli>Le decisioni relative ad autorizzazioni e policy per i tuoi sistemi.\u003C\u002Fli>\u003Cli>Il ciclo di vita dell'ambiente di esecuzione quando scegli un'infrastruttura di calcolo self-hosted.\u003C\u002Fli>\u003Cli>La valutazione, i criteri di accettazione, i guardrail specifici di dominio e la decisione su cosa l'agente è autorizzato a fare.\u003C\u002Fli>\u003C\u002Ful>\n\u003Ch2 id=\"section-19\">2. Responses API: gestisci il ciclo, usa le primitive della piattaforma\u003C\u002Fh2>\n\u003Cp>L'API Responses è la scelta di livello inferiore quando desideri le funzionalità dei modelli e degli strumenti di OpenAI senza delegare l'intero runtime dell'agente. OpenAI descrive Responses come la primitiva API consigliata per i nuovi progetti e come un'evoluzione di Chat Completions dotata di strumenti integrati, opzioni di stato multi-turn, input multimodale e uso agentico degli strumenti.\u003C\u002Fp>\n\u003Cp>Una richiesta Responses può a sua volta invocare strumenti, ma la tua applicazione rimane responsabile del flusso di lavoro complessivo quando costruisci un agente attorno ad essa. Ciò significa che il tuo codice decide come mantenere lo stato dell'applicazione, quando proseguire, come gestire il ripristino, come coordinare gli specialisti, come compattare le cronologie estese e come rappresentare il lavoro ripristinabile.\u003C\u002Fp>\n\u003Cp>Questo approccio non è intrinsecamente inferiore. È il confine ideale quando il comportamento dell'agente deve essere profondamente integrato nella logica applicativa esistente, quando è necessario un modello di stato personalizzato o quando un harness gestito nasconderebbe un livello di controllo di cui hai effettivamente bisogno.\u003C\u002Fp>\n\u003Ch2 id=\"section-23\">3. Agents SDK: supportato, ma non più il percorso predefinito per il futuro\u003C\u002Fh2>\n\u003Cp>L'Agents SDK rimane un framework open source per l'esecuzione di flussi di lavoro di agenti all'interno della tua applicazione. Fornisce definizioni di agenti, strumenti, passaggi di consegne (handoff), guardrail, tracciamento, sessioni e il ciclo di esecuzione (runner loop) in TypeScript e Python.\u003C\u002Fp>\n\u003Cp>Tuttavia, il suo ruolo strategico è cambiato. OpenAI ora etichetta l'Agents SDK come completo nelle funzionalità (feature complete): la manutenzione, le correzioni di sicurezza, le risoluzioni di bug critici e gli aggiornamenti di compatibilità continuano, ma non sono previste nuove funzionalità principali. OpenAI consiglia l'Agents API per le nuove applicazioni.\u003C\u002Fp>\n\u003Cp>Ciò non significa che un'applicazione SDK esistente debba essere riscritta immediatamente. Significa piuttosto che l'architettura non dovrebbe più dare per scontato che l'SDK sia la sede in cui approderanno le prossime importanti funzionalità del runtime degli agenti.\u003C\u002Fp>\n\u003Caside class=\"editorjs-callout editorjs-callout--warning my-6 rounded-xl border p-5 border-amber-300 bg-amber-50 dark:border-amber-900 dark:bg-amber-950\u002F20\" role=\"note\">\u003Cstrong class=\"block mb-2 text-gray-900 dark:text-gray-100\">Non interpretare “feature complete” come “deprecato”\u003C\u002Fstrong>\u003Cdiv class=\"text-gray-700 dark:text-gray-200\">OpenAI non ha dichiarato l'Agents SDK come non supportato. Le applicazioni esistenti possono continuare a utilizzarlo, e le attività di manutenzione, sicurezza, correzione di bug critici e compatibilità proseguono regolarmente. Il cambiamento rilevante è che non sono previste nuove funzionalità importanti e le nuove applicazioni vengono indirizzate verso l'Agents API.\u003C\u002Fdiv>\u003C\u002Faside>\n\u003Ch2 id=\"section-28\">Dove si colloca il Codex SDK\u003C\u002Fh2>\n\u003Cp>La scelta attuale non è una semplice suddivisione a tre vie. La panoramica del runtime di OpenAI include il Codex SDK come opzione per eseguire l'harness di Codex nell'infrastruttura che gestisci direttamente. Questa impostazione è architettonicamente diversa sia dall'Agents API ospitata sia dall'Agents SDK.\u003C\u002Fp>\n\u003Cp>Se la tua effettiva esigenza è “Desidero l'harness di Codex, ma devo gestirlo autonomamente”, il Codex SDK è la superficie da valutare. Se la tua esigenza è “Voglio avere il pieno controllo del ciclo attorno alle chiamate del modello”, valuta Responses. Se la tua esigenza è “Ho già un'applicazione funzionante basata sull'Agents SDK”, l'SDK esistente può rimanere valido mentre pianifichi le prossime mosse in base al suo stato di manutenzione.\u003C\u002Fp>\n\u003Ch2 id=\"section-31\">Il test sul controllo del runtime\u003C\u002Fh2>\n\u003Cp>Una decisione architetturale efficace inizia stabilendo quali aspetti il tuo team deve controllare direttamente. Assegna a ciascun requisito una classificazione tra controllo obbligatorio, preferenza per il controllo o preferenza per la gestione delegata.\u003C\u002Fp>\n\u003Csection class=\"editorjs-comparison my-6\">\u003Ch3 class=\"mb-3 text-lg font-semibold\">Test sul controllo del runtime\u003C\u002Fh3>\u003Cdiv class=\"overflow-x-auto\">\u003Ctable class=\"w-full border-collapse\">\u003Cthead>\u003Ctr>\u003Cth class=\"border border-gray-300 bg-gray-50 px-4 py-3 text-left dark:border-gray-700 dark:bg-gray-900\">\u003C\u002Fth>\u003Cth class=\"border border-gray-300 bg-gray-50 px-4 py-3 text-left font-semibold dark:border-gray-700 dark:bg-gray-900\">Decisione\u003C\u002Fth>\u003Cth class=\"border border-gray-300 bg-gray-50 px-4 py-3 text-left font-semibold dark:border-gray-700 dark:bg-gray-900\">Se preferisci la gestione delegata\u003C\u002Fth>\u003Cth class=\"border border-gray-300 bg-gray-50 px-4 py-3 text-left font-semibold dark:border-gray-700 dark:bg-gray-900\">Se richiedi il controllo diretto\u003C\u002Fth>\u003C\u002Ftr>\u003C\u002Fthead>\u003Ctbody>\u003Ctr>\u003Cth class=\"border border-gray-300 px-4 py-3 text-left font-semibold dark:border-gray-700\">Ciclo dell'agente\u003C\u002Fth>\u003Ctd class=\"border border-gray-300 px-4 py-3 dark:border-gray-700\">\u003C\u002Ftd>\u003Ctd class=\"border border-gray-300 px-4 py-3 dark:border-gray-700\">\u003C\u002Ftd>\u003Ctd class=\"border border-gray-300 px-4 py-3 dark:border-gray-700\">\u003C\u002Ftd>\u003C\u002Ftr>\u003Ctr>\u003Cth class=\"border border-gray-300 px-4 py-3 text-left font-semibold dark:border-gray-700\">Sessioni persistenti\u003C\u002Fth>\u003Ctd class=\"border border-gray-300 px-4 py-3 dark:border-gray-700\">\u003C\u002Ftd>\u003Ctd class=\"border border-gray-300 px-4 py-3 dark:border-gray-700\">\u003C\u002Ftd>\u003Ctd class=\"border border-gray-300 px-4 py-3 dark:border-gray-700\">\u003C\u002Ftd>\u003C\u002Ftr>\u003Ctr>\u003Cth class=\"border border-gray-300 px-4 py-3 text-left font-semibold dark:border-gray-700\">Runtime dell'harness\u003C\u002Fth>\u003Ctd class=\"border border-gray-300 px-4 py-3 dark:border-gray-700\">\u003C\u002Ftd>\u003Ctd class=\"border border-gray-300 px-4 py-3 dark:border-gray-700\">\u003C\u002Ftd>\u003Ctd class=\"border border-gray-300 px-4 py-3 dark:border-gray-700\">\u003C\u002Ftd>\u003C\u002Ftr>\u003Ctr>\u003Cth class=\"border border-gray-300 px-4 py-3 text-left font-semibold dark:border-gray-700\">Ambiente di esecuzione\u003C\u002Fth>\u003Ctd class=\"border border-gray-300 px-4 py-3 dark:border-gray-700\">\u003C\u002Ftd>\u003Ctd class=\"border border-gray-300 px-4 py-3 dark:border-gray-700\">\u003C\u002Ftd>\u003Ctd class=\"border border-gray-300 px-4 py-3 dark:border-gray-700\">\u003C\u002Ftd>\u003C\u002Ftr>\u003Ctr>\u003Cth class=\"border border-gray-300 px-4 py-3 text-left font-semibold dark:border-gray-700\">Semantica di orchestrazione\u003C\u002Fth>\u003Ctd class=\"border border-gray-300 px-4 py-3 dark:border-gray-700\">\u003C\u002Ftd>\u003Ctd class=\"border border-gray-300 px-4 py-3 dark:border-gray-700\">\u003C\u002Ftd>\u003Ctd class=\"border border-gray-300 px-4 py-3 dark:border-gray-700\">\u003C\u002Ftd>\u003C\u002Ftr>\u003Ctr>\u003Cth class=\"border border-gray-300 px-4 py-3 text-left font-semibold dark:border-gray-700\">Flessibilità di provider \u002F trasporto\u003C\u002Fth>\u003Ctd class=\"border border-gray-300 px-4 py-3 dark:border-gray-700\">\u003C\u002Ftd>\u003Ctd class=\"border border-gray-300 px-4 py-3 dark:border-gray-700\">\u003C\u002Ftd>\u003Ctd class=\"border border-gray-300 px-4 py-3 dark:border-gray-700\">\u003C\u002Ftd>\u003C\u002Ftr>\u003Ctr>\u003Cth class=\"border border-gray-300 px-4 py-3 text-left font-semibold dark:border-gray-700\">Carico operativo\u003C\u002Fth>\u003Ctd class=\"border border-gray-300 px-4 py-3 dark:border-gray-700\">\u003C\u002Ftd>\u003Ctd class=\"border border-gray-300 px-4 py-3 dark:border-gray-700\">\u003C\u002Ftd>\u003Ctd class=\"border border-gray-300 px-4 py-3 dark:border-gray-700\">\u003C\u002Ftd>\u003C\u002Ftr>\u003C\u002Ftbody>\u003C\u002Ftable>\u003C\u002Fdiv>\u003C\u002Fsection>\n\u003Ch2 id=\"section-34\">Un albero decisionale per i nuovi sistemi\u003C\u002Fh2>\n\u003Csection class=\"editorjs-process my-6\">\u003Ch3 class=\"mb-3 text-lg font-semibold\">Scegli il runtime in base al perimetro di controllo\u003C\u002Fh3>\u003Cdiv class=\"grid grid-cols-1 md:grid-cols-2 xl:grid-cols-3 gap-4\">\u003Cdiv class=\"editorjs-process__step min-w-0  rounded-xl border border-gray-200 dark:border-gray-700 p-4\">\u003Cdiv class=\"text-xs font-semibold text-gray-500 dark:text-gray-400\">1\u003C\u002Fdiv>\u003Cdiv class=\"mt-1 font-semibold text-gray-900 dark:text-gray-100\">1. Si tratta di una nuova applicazione con agenti?\u003C\u002Fdiv>\u003Cdiv class=\"mt-1 text-sm text-gray-600 dark:text-gray-300\">In caso negativo, non eseguire la migrazione solo perché esiste una superficie più recente. Valuta prima gli effettivi vincoli dell'applicazione corrente.\u003C\u002Fdiv>\u003C\u002Fdiv>\u003Cdiv class=\"editorjs-process__step min-w-0  rounded-xl border border-gray-200 dark:border-gray-700 p-4\">\u003Cdiv class=\"text-xs font-semibold text-gray-500 dark:text-gray-400\">2\u003C\u002Fdiv>\u003Cdiv class=\"mt-1 font-semibold text-gray-900 dark:text-gray-100\">2. Desideri un harness gestito per agenti a lunga esecuzione?\u003C\u002Fdiv>\u003Cdiv class=\"mt-1 text-sm text-gray-600 dark:text-gray-300\">In caso affermativo, parti con l'Agents API, in quanto percorso raccomandato da OpenAI per le nuove applicazioni con agenti.\u003C\u002Fdiv>\u003C\u002Fdiv>\u003Cdiv class=\"editorjs-process__step min-w-0  rounded-xl border border-gray-200 dark:border-gray-700 p-4\">\u003Cdiv class=\"text-xs font-semibold text-gray-500 dark:text-gray-400\">3\u003C\u002Fdiv>\u003Cdiv class=\"mt-1 font-semibold text-gray-900 dark:text-gray-100\">3. Hai bisogno dell'harness di Codex ma devi gestirlo direttamente?\u003C\u002Fdiv>\u003Cdiv class=\"mt-1 text-sm text-gray-600 dark:text-gray-300\">Valuta il Codex SDK invece di ricostruire le logiche dell'harness sopra l'Agents SDK.\u003C\u002Fdiv>\u003C\u002Fdiv>\u003Cdiv class=\"editorjs-process__step min-w-0  rounded-xl border border-gray-200 dark:border-gray-700 p-4\">\u003Cdiv class=\"text-xs font-semibold text-gray-500 dark:text-gray-400\">4\u003C\u002Fdiv>\u003Cdiv class=\"mt-1 font-semibold text-gray-900 dark:text-gray-100\">4. Devi controllare il ciclo dell'agente e il modello di stato?\u003C\u002Fdiv>\u003Cdiv class=\"mt-1 text-sm text-gray-600 dark:text-gray-300\">Usa l'API Responses come primitiva di piattaforma di livello inferiore e sviluppa il ciclo attorno ad essa.\u003C\u002Fdiv>\u003C\u002Fdiv>\u003Cdiv class=\"editorjs-process__step min-w-0  rounded-xl border border-gray-200 dark:border-gray-700 p-4\">\u003Cdiv class=\"text-xs font-semibold text-gray-500 dark:text-gray-400\">5\u003C\u002Fdiv>\u003Cdiv class=\"mt-1 font-semibold text-gray-900 dark:text-gray-100\">5. Stai già utilizzando l'Agents SDK?\u003C\u002Fdiv>\u003Cdiv class=\"mt-1 text-sm text-gray-600 dark:text-gray-300\">Continua a usarlo se risponde ai tuoi requisiti; non sono previste nuove funzionalità rilevanti, quindi considera la transizione a piattaforme future come una scelta strategica esplicita nella roadmap.\u003C\u002Fdiv>\u003C\u002Fdiv>\u003Cdiv class=\"editorjs-process__step min-w-0  rounded-xl border border-gray-200 dark:border-gray-700 p-4\">\u003Cdiv class=\"text-xs font-semibold text-gray-500 dark:text-gray-400\">6\u003C\u002Fdiv>\u003Cdiv class=\"mt-1 font-semibold text-gray-900 dark:text-gray-100\">6. Manca una funzionalità indispensabile nell'Agents API?\u003C\u002Fdiv>\u003Cdiv class=\"mt-1 text-sm text-gray-600 dark:text-gray-300\">OpenAI ammette esplicitamente l'Agents SDK come opzione a breve termine per le nuove applicazioni che necessitano di funzionalità non ancora supportate.\u003C\u002Fdiv>\u003C\u002Fdiv>\u003Cdiv class=\"editorjs-process__step min-w-0  rounded-xl border border-gray-200 dark:border-gray-700 p-4\">\u003Cdiv class=\"text-xs font-semibold text-gray-500 dark:text-gray-400\">7\u003C\u002Fdiv>\u003Cdiv class=\"mt-1 font-semibold text-gray-900 dark:text-gray-100\">7. Esegui la convalida con uno spike rappresentativo della produzione\u003C\u002Fdiv>\u003Cdiv class=\"mt-1 text-sm text-gray-600 dark:text-gray-300\">Verifica strumenti, ambiente, processi di approvazione, latenza, osservabilità, recupero dagli errori e ciclo di vita prima di definire definitivamente l'architettura.\u003C\u002Fdiv>\u003C\u002Fdiv>\u003C\u002Fdiv>\u003C\u002Fsection>\n\u003Ch2 id=\"section-36\">Cosa non dovrebbe guidare la decisione\u003C\u002Fh2>\n\u003Cdiv class=\"overflow-x-auto\">\u003Ctable class=\"w-full border-collapse\">\u003Cthead>\u003Ctr>\u003Cth class=\"border border-gray-300 px-4 py-2 text-left font-semibold\">Regola decisionale debole\u003C\u002Fth>\u003Cth class=\"border border-gray-300 px-4 py-2 text-left font-semibold\">Perché fallisce\u003C\u002Fth>\u003Cth class=\"border border-gray-300 px-4 py-2 text-left font-semibold\">Domanda migliore\u003C\u002Fth>\u003C\u002Ftr>\u003C\u002Fthead>\u003Ctbody>\u003Ctr>\u003Ctd class=\"border border-gray-300 px-4 py-2\">“L'API più recente deve essere la migliore.”\u003C\u002Ftd>\u003Ctd class=\"border border-gray-300 px-4 py-2\">Una soluzione più recente può essere strategicamente preferibile pur mancando ancora di una funzionalità di cui hai bisogno.\u003C\u002Ftd>\u003Ctd class=\"border border-gray-300 px-4 py-2\">Quali responsabilità di runtime dovrebbero essere gestite rispetto a quelle di proprietà dell'applicazione?\u003C\u002Ftd>\u003C\u002Ftr>\u003Ctr>\u003Ctd class=\"border border-gray-300 px-4 py-2\">“Conosciamo già l'SDK.”\u003C\u002Ftd>\u003Ctd class=\"border border-gray-300 px-4 py-2\">La familiarità del team può preservare un'architettura la cui roadmap è cambiata.\u003C\u002Ftd>\u003Ctd class=\"border border-gray-300 px-4 py-2\">Qual è il costo di rimanere rispetto a migrare durante il prossimo ciclo di prodotto?\u003C\u002Ftd>\u003C\u002Ftr>\u003Ctr>\u003Ctd class=\"border border-gray-300 px-4 py-2\">“Gestito significa nessuna infrastruttura.”\u003C\u002Ftd>\u003Ctd class=\"border border-gray-300 px-4 py-2\">L'Agents API può comunque utilizzare ambienti self-hosted e la tua applicazione mantiene comunque la proprietà della logica di prodotto.\u003C\u002Ftd>\u003Ctd class=\"border border-gray-300 px-4 py-2\">Quale livello di infrastruttura viene effettivamente delegato?\u003C\u002Ftd>\u003C\u002Ftr>\u003Ctr>\u003Ctd class=\"border border-gray-300 px-4 py-2\">“Responses serve solo per chiamate semplici.”\u003C\u002Ftd>\u003Ctd class=\"border border-gray-300 px-4 py-2\">Responses fornisce strumenti integrati e primitive stateful; può essere la base di cicli di agenti personalizzati.\u003C\u002Ftd>\u003Ctd class=\"border border-gray-300 px-4 py-2\">Abbiamo bisogno che la piattaforma gestisca l'harness, o solo le primitive del modello\u002Fstrumento?\u003C\u002Ftd>\u003C\u002Ftr>\u003Ctr>\u003Ctd class=\"border border-gray-300 px-4 py-2\">“Feature complete significa che dobbiamo migrare subito.”\u003C\u002Ftd>\u003Ctd class=\"border border-gray-300 px-4 py-2\">L'SDK rimane mantenuto per le applicazioni esistenti.\u003C\u002Ftd>\u003Ctd class=\"border border-gray-300 px-4 py-2\">Quale requisito futuro concreto è bloccato rimanendo dove siamo?\u003C\u002Ftd>\u003C\u002Ftr>\u003C\u002Ftbody>\u003C\u002Ftable>\u003C\u002Fdiv>\n\u003Ch2 id=\"section-38\">La migrazione è un cambiamento architetturale, non la ridenominazione di una import\u003C\u002Fh2>\n\u003Cp>Il passaggio dall'Agents SDK all'Agents API cambia la proprietà dei componenti. Nell'SDK, il ciclo viene eseguito all'interno dell'applicazione. Nell'Agents API, OpenAI gestisce l'harness e la sessione, mentre l'applicazione si integra tramite attività, eventi, strumenti e confini dell'ambiente.\u003C\u002Fp>\n\u003Cp>Un piano di migrazione concreto deve quindi mappare lo stato della sessione, l'orchestrazione personalizzata, gli handoff, l'esecuzione dei tool, le approvazioni, lo storage, il tracing, i tentativi di retry, il ripristino dai guasti, il ciclo di vita dell'ambiente e qualsiasi astrazione specifica del provider. Il volume di codice potrebbe ridursi, mentre cambiano i presupposti operativi.\u003C\u002Fp>\n\u003Ch3 id=\"section-41\">L'inventario per la migrazione\u003C\u002Fh3>\n\u003Cul>\u003Cli>Definizioni degli agenti e titolarità delle istruzioni.\u003C\u002Fli>\u003Cli>Definizioni dei tool e dove ciascun tool viene eseguito.\u003C\u002Fli>\u003Cli>Handoff, pattern manager\u002Fspecialist e comportamento dei sotto-agenti.\u003C\u002Fli>\u003Cli>Identificatori di sessione, stato della conversazione, capacità di ripresa e conservazione della cronologia.\u003C\u002Fli>\u003Cli>Approvazioni umane e semantica di interruzione.\u003C\u002Fli>\u003Cli>Logica personalizzata di trimming o compattazione del contesto.\u003C\u002Fli>\u003Cli>Tracing, valutazioni, osservabilità e debugging in produzione.\u003C\u002Fli>\u003Cli>File self-hosted, container, accesso a reti private o altre dipendenze di esecuzione.\u003C\u002Fli>\u003Cli>Astrazione del provider o dipendenze da modelli non-OpenAI.\u003C\u002Fli>\u003Cli>Presupposti su tentativi di retry, timeout, idempotenza, ripristino e ciclo di vita.\u003C\u002Fli>\u003C\u002Ful>\n\u003Ch2 id=\"section-43\">La beta pubblica cambia il modello di rischio\u003C\u002Fh2>\n\u003Cp>L'Agents API è la direzione consigliata per le nuove applicazioni basate su agenti, ma è anche in versione beta pubblica. Questi elementi non sono in contraddizione. La direzione strategica risponde a \"dove sta andando la piattaforma?\". Lo stato di beta risponde a \"quante modifiche a livello di interfaccia e operative devo preventivare?\"\u003C\u002Fp>\n\u003Cp>Per i sistemi di produzione, isola l'integrazione dietro un perimetro applicativo. Mantieni lo stato del dominio, i permessi, i dati di audit e le regole di business all'esterno degli oggetti di sessione specifici del vendor, ove possibile. In questo modo è più facile assorbire l'evoluzione delle API senza trasformare il runtime dell'agente nell'unica fonte di verità per l'intero prodotto.\u003C\u002Fp>\n\u003Ch2 id=\"section-46\">Un'architettura predefinita pratica\u003C\u002Fh2>\n\u003Cp>Per molte nuove applicazioni native per OpenAI, una configurazione predefinita ragionevole per il 2026 è: Agents API per l'harness gestito e la sessione persistente, servizi di dominio e autorizzazione di proprietà dell'applicazione, tool funzionali espliciti per le azioni di business ed esecuzione gestita da OpenAI o self-hosted a seconda dei requisiti di dati e calcolo.\u003C\u002Fp>\n\u003Cp>Ciò mantiene potente il runtime dell'agente senza renderlo il titolare delle verità di business. L'applicazione decide comunque cosa può fare un utente, quali dati sono autorevoli, quali azioni richiedono approvazione e come vengono convalidati i risultati.\u003C\u002Fp>\n\u003Caside class=\"editorjs-referral my-6\">\u003Ca href=\"https:\u002F\u002Fstajic.de\u002Fit\u002Fblog\u002Fai-agent-reliability-why-the-final-answer-is-not-enough\" class=\"flex flex-col sm:flex-row gap-4 rounded-xl border border-gray-200 dark:border-gray-700 p-4 transition hover:border-primary-500\">\u003Cdiv class=\"min-w-0 flex-1\">\u003Cstrong class=\"block text-lg text-gray-900 dark:text-gray-100\">Affidabilità degli agenti IA: perché la risposta finale non è sufficiente\u003C\u002Fstrong>\u003Cp class=\"mt-2 text-sm text-gray-600 dark:text-gray-300\">Un harness gestito riduce il carico operativo, ma l'affidabilità richiede comunque un'esecuzione tracciabile, criteri di accettazione espliciti e valutazioni che vadano oltre la risposta finale.\u003C\u002Fp>\u003Cspan class=\"mt-3 inline-flex text-sm font-medium text-primary-600 dark:text-primary-400\">Leggi l'articolo sull'affidabilità →\u003C\u002Fspan>\u003C\u002Fdiv>\u003C\u002Fa>\u003C\u002Faside>\n\u003Ch2 id=\"section-50\">Cosa potrebbe cambiare questa risposta?\u003C\u002Fh2>\n\u003Cp>La raccomandazione cambia se l'Agents API aggiunge o rimuove funzionalità, esce dalla beta con contratti diversi, modifica i limiti di ambiente o di prezzo, oppure introduce strumenti di migrazione che riducono le differenze di gestione. Cambia anche se la tua applicazione dipende dalla portabilità del provider, da semantiche di orchestrazione personalizzate, da un'esecuzione esclusivamente locale o da una capacità che l'harness hosted non può supportare.\u003C\u002Fp>\n\u003Cp>Per un'applicazione esistente basata su Agents SDK, la risposta cambia anche in funzione del costo di migrazione. Se il sistema è stabile, ben valutato e non limitato dallo stato feature-complete dell'SDK, una migrazione immediata potrebbe comportare più rischi che benefici. Se la roadmap del prodotto dipende da capacità introdotte solo nell'Agents API, ritardare la migrazione può generare un debito tecnico differente.\u003C\u002Fp>\n\u003Ch2 id=\"section-53\">Limitazioni\u003C\u002Fh2>\n\u003Cp>Questo confronto si concentra sulla titolarità del runtime e sulla direzione dichiarata della piattaforma OpenAI. Non fornisce benchmark di latenza, qualità o costo totale per un carico di lavoro specifico. Tali proprietà dipendono dalla scelta del modello, dall'uso dei tool, dall'ambiente, dalla lunghezza dell'attività, dal caching, dall'uso di sandbox e dall'architettura complessiva dell'applicazione.\u003C\u002Fp>\n\u003Cp>L'Agents API è inoltre abbastanza recente da far sì che l'esperienza in produzione si stia ancora consolidando. Un'architettura dovrebbe quindi essere convalidata con carichi di lavoro rappresentativi piuttosto che scelta unicamente in base al posizionamento del prodotto.\u003C\u002Fp>\n\u003Ch2 id=\"section-56\">Conclusione\u003C\u002Fh2>\n\u003Cp>La scelta del runtime degli agenti OpenAI nel 2026 riguarda fondamentalmente la proprietà del runtime. L'Agents API implica che OpenAI gestisca gran parte dell'harness e dei meccanismi per le sessioni persistenti. Responses significa che la tua applicazione gestisce il ciclo attorno alle primitive della piattaforma. L'Agents SDK rimane valido per i sistemi esistenti, ma non è più la destinazione predefinita per le nuove funzionalità principali del runtime degli agenti.\u003C\u002Fp>\n\u003Cp>Per una nuova applicazione, segui la direzione della piattaforma a meno che un requisito concreto non richieda di scendere a un livello inferiore dello stack. Inizia con l'Agents API, passa a Responses quando hai bisogno di gestire direttamente il ciclo, valuta il Codex SDK quando hai bisogno dell'harness nella tua infrastruttura e mantieni l'Agents SDK dove gli investimenti esistenti o temporanee lacune di funzionalità lo giustificano.\u003C\u002Fp>\n\u003Ch2 id=\"section-59\">FAQ\u003C\u002Fh2>\n\u003Csection class=\"editorjs-faq my-6 rounded-xl border border-gray-200 p-5 dark:border-gray-700\">\u003Ch3 class=\"mb-3 text-lg font-semibold\">Scelte di runtime per gli agenti OpenAI nel 2026\u003C\u002Fh3>\u003Cdiv id=\"faq1\" class=\"border-t border-gray-200 py-4 first:border-t-0 dark:border-gray-700\">\u003Ch4 class=\"font-semibold text-gray-900 dark:text-gray-100\">Dovrei usare l'OpenAI Agents API o l'Agents SDK per un nuovo progetto?\u003C\u002Fh4>\u003Cdiv class=\"mt-2 text-gray-600 dark:text-gray-300\">OpenAI raccomanda attualmente l'Agents API per le nuove applicazioni basate su agenti. L'Agents SDK è completo a livello di funzionalità e rimane supportato per le applicazioni esistenti, con attività continuative di manutenzione, sicurezza, correzioni di bug critici e compatibilità.\u003C\u002Fdiv>\u003C\u002Fdiv>\u003Cdiv id=\"faq2\" class=\"border-t border-gray-200 py-4 first:border-t-0 dark:border-gray-700\">\u003Ch4 class=\"font-semibold text-gray-900 dark:text-gray-100\">L'Agents SDK è deprecato?\u003C\u002Fh4>\u003Cdiv class=\"mt-2 text-gray-600 dark:text-gray-300\">OpenAI lo descrive come completo a livello di funzionalità, non come non supportato. Non sono previste nuove funzionalità importanti, ma proseguono la manutenzione, le correzioni di sicurezza, le correzioni di bug critici e il lavoro di compatibilità.\u003C\u002Fdiv>\u003C\u002Fdiv>\u003Cdiv id=\"faq3\" class=\"border-t border-gray-200 py-4 first:border-t-0 dark:border-gray-700\">\u003Ch4 class=\"font-semibold text-gray-900 dark:text-gray-100\">Quando dovrei usare la Responses API invece dell'Agents API?\u003C\u002Fh4>\u003Cdiv class=\"mt-2 text-gray-600 dark:text-gray-300\">Usa Responses quando la tua applicazione deve gestire il ciclo dell'agente, la strategia di stato, l'orchestrazione e la logica di continuazione, continuando comunque a utilizzare i modelli e gli strumenti della piattaforma OpenAI.\u003C\u002Fdiv>\u003C\u002Fdiv>\u003Cdiv id=\"faq4\" class=\"border-t border-gray-200 py-4 first:border-t-0 dark:border-gray-700\">\u003Ch4 class=\"font-semibold text-gray-900 dark:text-gray-100\">L'Agents API richiede risorse di calcolo ospitate da OpenAI?\u003C\u002Fh4>\u003Cdiv class=\"mt-2 text-gray-600 dark:text-gray-300\">No. L'Agents API può operare senza alcun ambiente di esecuzione, con un ambiente ospitato da OpenAI o con un ambiente self-hosted collegato all'harness gestito.\u003C\u002Fdiv>\u003C\u002Fdiv>\u003Cdiv id=\"faq5\" class=\"border-t border-gray-200 py-4 first:border-t-0 dark:border-gray-700\">\u003Ch4 class=\"font-semibold text-gray-900 dark:text-gray-100\">Come si colloca il Codex SDK?\u003C\u002Fh4>\u003Cdiv class=\"mt-2 text-gray-600 dark:text-gray-300\">OpenAI posiziona il Codex SDK per l'esecuzione dell'harness di Codex nell'infrastruttura da te gestita. È l'opzione ideale quando si desidera l'harness ma non il runtime hosted dell'Agents API.\u003C\u002Fdiv>\u003C\u002Fdiv>\u003Cdiv id=\"faq6\" class=\"border-t border-gray-200 py-4 first:border-t-0 dark:border-gray-700\">\u003Ch4 class=\"font-semibold text-gray-900 dark:text-gray-100\">Un'applicazione esistente basata sull'Agents SDK dovrebbe migrare immediatamente?\u003C\u002Fh4>\u003Cdiv class=\"mt-2 text-gray-600 dark:text-gray-300\">Non necessariamente. Valuta se il sistema attuale è limitato dallo stato di completezza delle funzionalità dell'SDK, se le capacità richieste sono presenti nell'Agents API e se i benefici della migrazione superano l'impatto operativo e architetturale.\u003C\u002Fdiv>\u003C\u002Fdiv>\u003C\u002Fsection>\n\u003Ch2 id=\"section-61\">Glossario\u003C\u002Fh2>\n\u003Csection class=\"editorjs-glossary my-6 rounded-xl border border-gray-200 dark:border-gray-700 p-5\">\u003Ch3 class=\"mb-3 text-lg font-semibold\">Termini chiave del runtime\u003C\u002Fh3>\u003Cdl>\u003Cdiv id=\"harness\" class=\"border-t border-gray-200 dark:border-gray-700 py-3 first:border-t-0\">\u003Cdt class=\"font-semibold text-gray-900 dark:text-gray-100\">Harness\u003C\u002Fdt>\u003Cdd class=\"mt-1 text-gray-600 dark:text-gray-300\">Il ciclo di runtime e i meccanismi di supporto che coordinano le chiamate al modello, gli strumenti, il contesto, le sessioni e l'esecuzione dell'agente.\u003C\u002Fdd>\u003C\u002Fdiv>\u003Cdiv id=\"agents-api\" class=\"border-t border-gray-200 dark:border-gray-700 py-3 first:border-t-0\">\u003Cdt class=\"font-semibold text-gray-900 dark:text-gray-100\">Agents API\u003C\u002Fdt>\u003Cdd class=\"mt-1 text-gray-600 dark:text-gray-300\">L'API gestita di OpenAI per agenti cloud persistenti che utilizzano un harness Codex ospitato.\u003C\u002Fdd>\u003C\u002Fdiv>\u003Cdiv id=\"responses-api\" class=\"border-t border-gray-200 dark:border-gray-700 py-3 first:border-t-0\">\u003Cdt class=\"font-semibold text-gray-900 dark:text-gray-100\">Responses API\u003C\u002Fdt>\u003Cdd class=\"mt-1 text-gray-600 dark:text-gray-300\">La primitiva API di livello inferiore di OpenAI per risposte del modello, strumenti ospitati e interazioni con stato attorno alla quale le applicazioni possono costruire il proprio ciclo dell'agente.\u003C\u002Fdd>\u003C\u002Fdiv>\u003Cdiv id=\"agents-sdk\" class=\"border-t border-gray-200 dark:border-gray-700 py-3 first:border-t-0\">\u003Cdt class=\"font-semibold text-gray-900 dark:text-gray-100\">Agents SDK\u003C\u002Fdt>\u003Cdd class=\"mt-1 text-gray-600 dark:text-gray-300\">Il framework open source di OpenAI per eseguire workflow di agenti nel codice dell'applicazione; completo a livello di funzionalità a partire da settembre 2026.\u003C\u002Fdd>\u003C\u002Fdiv>\u003Cdiv id=\"codex-sdk\" class=\"border-t border-gray-200 dark:border-gray-700 py-3 first:border-t-0\">\u003Cdt class=\"font-semibold text-gray-900 dark:text-gray-100\">Codex SDK\u003C\u002Fdt>\u003Cdd class=\"mt-1 text-gray-600 dark:text-gray-300\">L'opzione di runtime indicata da OpenAI per eseguire l'harness Codex in un'infrastruttura gestita dall'utente.\u003C\u002Fdd>\u003C\u002Fdiv>\u003Cdiv id=\"runtime-ownership\" class=\"border-t border-gray-200 dark:border-gray-700 py-3 first:border-t-0\">\u003Cdt class=\"font-semibold text-gray-900 dark:text-gray-100\">Proprietà del runtime\u003C\u002Fdt>\u003Cdd class=\"mt-1 text-gray-600 dark:text-gray-300\">Il confine architetturale che descrive quali parti del ciclo dell'agente, dello stato della sessione, dell'ambiente di esecuzione e del ciclo di vita sono gestite dalla piattaforma rispetto all'applicazione.\u003C\u002Fdd>\u003C\u002Fdiv>\u003C\u002Fdl>\u003C\u002Fsection>\n\u003Ch2 id=\"section-63\">Fonti primarie e approfondimenti\u003C\u002Fh2>\n\u003Ca href=\"https:\u002F\u002Fopenai.com\u002Findex\u002Fintroducing-the-agents-api\u002F\" target=\"_blank\" rel=\"noopener noreferrer\" class=\"editorjs-link-tool block border border-gray-200 dark:border-gray-700 rounded-lg p-4 transition text-gray-900 dark:text-gray-100 hover:border-primary-500 hover:bg-primary-50 dark:hover:bg-gray-900 hover:text-gray-900 dark:hover:text-gray-100\">\u003Cstrong class=\"block font-semibold\">OpenAI — Presentazione dell'Agents API\u003C\u002Fstrong>\u003Cp class=\"text-sm text-gray-600 dark:text-gray-400\">Annuncio di lancio dell'Agents API del 10 settembre 2026, con la descrizione dell'harness Codex gestito e della beta pubblica.\u003C\u002Fp>\u003C\u002Fa>\n\u003Ca href=\"https:\u002F\u002Fdevelopers.openai.com\u002Fapi\u002Fdocs\u002Fguides\u002Fagents\" target=\"_blank\" rel=\"noopener noreferrer\" class=\"editorjs-link-tool block border border-gray-200 dark:border-gray-700 rounded-lg p-4 transition text-gray-900 dark:text-gray-100 hover:border-primary-500 hover:bg-primary-50 dark:hover:bg-gray-900 hover:text-gray-900 dark:hover:text-gray-100\">\u003Cstrong class=\"block font-semibold\">OpenAI — Panoramica sul runtime degli agenti\u003C\u002Fstrong>\u003Cp class=\"text-sm text-gray-600 dark:text-gray-400\">Confronto attuale tra Agents API, Codex SDK e Responses API, incluso lo stato di supporto dell'Agents SDK.\u003C\u002Fp>\u003C\u002Fa>\n\u003Ca href=\"https:\u002F\u002Fdevelopers.openai.com\u002Fapi\u002Fdocs\u002Fguides\u002Fagents-api\u002Foverview\" target=\"_blank\" rel=\"noopener noreferrer\" class=\"editorjs-link-tool block border border-gray-200 dark:border-gray-700 rounded-lg p-4 transition text-gray-900 dark:text-gray-100 hover:border-primary-500 hover:bg-primary-50 dark:hover:bg-gray-900 hover:text-gray-900 dark:hover:text-gray-100\">\u003Cstrong class=\"block font-semibold\">OpenAI — Panoramica sull'Agents API\u003C\u002Fstrong>\u003Cp class=\"text-sm text-gray-600 dark:text-gray-400\">Documentazione su agenti cloud persistenti, sessioni, orchestrazione, compattazione del contesto, ripristino e opzioni di ambiente.\u003C\u002Fp>\u003C\u002Fa>\n\u003Ca href=\"https:\u002F\u002Fdevelopers.openai.com\u002Fapi\u002Fdocs\u002Fguides\u002Fagents-api\u002Farchitecture\" target=\"_blank\" rel=\"noopener noreferrer\" class=\"editorjs-link-tool block border border-gray-200 dark:border-gray-700 rounded-lg p-4 transition text-gray-900 dark:text-gray-100 hover:border-primary-500 hover:bg-primary-50 dark:hover:bg-gray-900 hover:text-gray-900 dark:hover:text-gray-100\">\u003Cstrong class=\"block font-semibold\">OpenAI — Architettura dell'Agents API\u003C\u002Fstrong>\u003Cp class=\"text-sm text-gray-600 dark:text-gray-400\">Confine architetturale tra harness ospitato, server applicativo e ambienti di esecuzione assenti\u002Fospitati da OpenAI\u002Fself-hosted.\u003C\u002Fp>\u003C\u002Fa>\n\u003Ca href=\"https:\u002F\u002Fdevelopers.openai.com\u002Fapi\u002Fdocs\u002Fguides\u002Fagents\u002Fsdk\" target=\"_blank\" rel=\"noopener noreferrer\" class=\"editorjs-link-tool block border border-gray-200 dark:border-gray-700 rounded-lg p-4 transition text-gray-900 dark:text-gray-100 hover:border-primary-500 hover:bg-primary-50 dark:hover:bg-gray-900 hover:text-gray-900 dark:hover:text-gray-100\">\u003Cstrong class=\"block font-semibold\">OpenAI — Agents SDK\u003C\u002Fstrong>\u003Cp class=\"text-sm text-gray-600 dark:text-gray-400\">Avviso attuale sul supporto dell'Agents SDK e spiegazione del ciclo dell'agente gestito dall'applicazione.\u003C\u002Fp>\u003C\u002Fa>\n\u003Ca href=\"https:\u002F\u002Fdevelopers.openai.com\u002Fapi\u002Fdocs\u002Fguides\u002Fmigrate-to-responses\" target=\"_blank\" rel=\"noopener noreferrer\" class=\"editorjs-link-tool block border border-gray-200 dark:border-gray-700 rounded-lg p-4 transition text-gray-900 dark:text-gray-100 hover:border-primary-500 hover:bg-primary-50 dark:hover:bg-gray-900 hover:text-gray-900 dark:hover:text-gray-100\">\u003Cstrong class=\"block font-semibold\">OpenAI — Migrazione alla Responses API\u003C\u002Fstrong>\u003Cp class=\"text-sm text-gray-600 dark:text-gray-400\">Posizionamento attuale della Responses API, strumenti integrati, contesto con stato e primitive agentiche.\u003C\u002Fp>\u003C\u002Fa>\n\u003Cnav class=\"editorjs-toc\" data-editorjs-toc=\"true\" aria-label=\"Indice\">\u003Cstrong class=\"editorjs-toc__title\">Indice\u003C\u002Fstrong>\u003Col class=\"editorjs-toc__list editorjs-toc__list--depth-0\">\u003Cli class=\"editorjs-toc__item\">\u003Ca href=\"#section-6\" class=\"editorjs-toc__link\">L'architettura è cambiata: scegli un perimetro di runtime, non una libreria\u003C\u002Fa>\u003C\u002Fli>\u003Cli class=\"editorjs-toc__item\">\u003Ca href=\"#section-9\" class=\"editorjs-toc__link\">Il confronto in sintesi\u003C\u002Fa>\u003C\u002Fli>\u003Cli class=\"editorjs-toc__item\">\u003Ca href=\"#section-11\" class=\"editorjs-toc__link\">1. Agents API: harness gestito, agente cloud duraturo\u003C\u002Fa>\u003Col class=\"editorjs-toc__list editorjs-toc__list--depth-1\">\u003Cli class=\"editorjs-toc__item\">\u003Ca href=\"#section-15\" class=\"editorjs-toc__link\">Cosa ottieni con la Agents API\u003C\u002Fa>\u003C\u002Fli>\u003Cli class=\"editorjs-toc__item\">\u003Ca href=\"#section-17\" class=\"editorjs-toc__link\">Cosa rimane sotto la tua gestione\u003C\u002Fa>\u003C\u002Fli>\u003C\u002Fol>\u003C\u002Fli>\u003Cli class=\"editorjs-toc__item\">\u003Ca href=\"#section-19\" class=\"editorjs-toc__link\">2. Responses API: gestisci il ciclo, usa le primitive della piattaforma\u003C\u002Fa>\u003C\u002Fli>\u003Cli class=\"editorjs-toc__item\">\u003Ca href=\"#section-23\" class=\"editorjs-toc__link\">3. Agents SDK: supportato, ma non più il percorso predefinito per il futuro\u003C\u002Fa>\u003C\u002Fli>\u003Cli class=\"editorjs-toc__item\">\u003Ca href=\"#section-28\" class=\"editorjs-toc__link\">Dove si colloca il Codex SDK\u003C\u002Fa>\u003C\u002Fli>\u003Cli class=\"editorjs-toc__item\">\u003Ca href=\"#section-31\" class=\"editorjs-toc__link\">Il test sul controllo del runtime\u003C\u002Fa>\u003C\u002Fli>\u003Cli class=\"editorjs-toc__item\">\u003Ca href=\"#section-34\" class=\"editorjs-toc__link\">Un albero decisionale per i nuovi sistemi\u003C\u002Fa>\u003C\u002Fli>\u003Cli class=\"editorjs-toc__item\">\u003Ca href=\"#section-36\" class=\"editorjs-toc__link\">Cosa non dovrebbe guidare la decisione\u003C\u002Fa>\u003C\u002Fli>\u003Cli class=\"editorjs-toc__item\">\u003Ca href=\"#section-38\" class=\"editorjs-toc__link\">La migrazione è un cambiamento architetturale, non la ridenominazione di una import\u003C\u002Fa>\u003Col class=\"editorjs-toc__list editorjs-toc__list--depth-1\">\u003Cli class=\"editorjs-toc__item\">\u003Ca href=\"#section-41\" class=\"editorjs-toc__link\">L'inventario per la migrazione\u003C\u002Fa>\u003C\u002Fli>\u003C\u002Fol>\u003C\u002Fli>\u003Cli class=\"editorjs-toc__item\">\u003Ca href=\"#section-43\" class=\"editorjs-toc__link\">La beta pubblica cambia il modello di rischio\u003C\u002Fa>\u003C\u002Fli>\u003Cli class=\"editorjs-toc__item\">\u003Ca href=\"#section-46\" class=\"editorjs-toc__link\">Un'architettura predefinita pratica\u003C\u002Fa>\u003C\u002Fli>\u003Cli class=\"editorjs-toc__item\">\u003Ca href=\"#section-50\" class=\"editorjs-toc__link\">Cosa potrebbe cambiare questa risposta?\u003C\u002Fa>\u003C\u002Fli>\u003Cli class=\"editorjs-toc__item\">\u003Ca href=\"#section-53\" class=\"editorjs-toc__link\">Limitazioni\u003C\u002Fa>\u003C\u002Fli>\u003Cli class=\"editorjs-toc__item\">\u003Ca href=\"#section-56\" class=\"editorjs-toc__link\">Conclusione\u003C\u002Fa>\u003C\u002Fli>\u003Cli class=\"editorjs-toc__item\">\u003Ca href=\"#section-59\" class=\"editorjs-toc__link\">FAQ\u003C\u002Fa>\u003C\u002Fli>\u003Cli class=\"editorjs-toc__item\">\u003Ca href=\"#section-61\" class=\"editorjs-toc__link\">Glossario\u003C\u002Fa>\u003C\u002Fli>\u003Cli class=\"editorjs-toc__item\">\u003Ca href=\"#section-63\" class=\"editorjs-toc__link\">Fonti primarie e approfondimenti\u003C\u002Fa>\u003C\u002Fli>\u003C\u002Fol>\u003C\u002Fnav>",{"time":212,"blocks":213,"version":795},1790366260381,[214,222,228,236,243,250,255,260,265,270,306,311,316,321,326,331,345,350,361,366,371,376,381,386,391,396,401,407,412,417,422,427,432,478,483,512,517,546,551,556,561,566,582,587,592,597,602,607,612,621,626,631,636,641,646,651,656,661,666,671,701,706,731,736,746,755,764,773,782,791],{"id":215,"data":216,"type":220,"tunes":221},"75qcDhG72q",{"title":217,"maxLevel":218,"minLevel":219},"Indice",3,2,"tableOfContents",{},{"id":223,"data":224,"type":226,"tunes":227},"intro",{"text":225},"Lo stack per agenti di OpenAI è cambiato radicalmente a settembre 2026. La nuova Agents API ha introdotto un harness Codex gestito per agenti cloud duraturi, mentre il precedente Agents SDK è passato a una fase di manutenzione feature-complete. La Responses API rimane la superficie di livello inferiore per le applicazioni che necessitano di chiamate dirette al modello o che desiderano gestire autonomamente l'agent loop. Non si tratta di tre wrapper intercambiabili per la stessa cosa: definiscono il perimetro di runtime in punti diversi.","paragraph",{},{"id":229,"data":230,"type":234,"tunes":235},"direct",{"body":231,"title":232,"variant":233},"\u003Cstrong>Per una nuova applicazione di agenti nativa di OpenAI a settembre 2026, inizia con la Agents API, a meno che non ci sia una ragione concreta per gestire direttamente una porzione maggiore del runtime.\u003C\u002Fstrong> Usa la Responses API quando la tua applicazione deve controllare il loop, la strategia dello stato e l'orchestrazione. Mantieni l'Agents SDK per le applicazioni esistenti o per sopperire a carenze temporanee laddove la Agents API non supporti ancora una funzionalità necessaria. Se desideri l'harness Codex in sé ma devi eseguirlo in un'infrastruttura gestita da te, valuta il Codex SDK invece di forzare l'Agents SDK in quel ruolo.","Risposta diretta","info","callout",{},{"id":237,"data":238,"type":234,"tunes":242},"date-warning",{"body":239,"title":240,"variant":241},"Questo articolo riflette lo stato della piattaforma di OpenAI al \u003Cstrong>25 settembre 2026\u003C\u002Fstrong>. La Agents API è stata lanciata in beta pubblica il 10 settembre 2026. Le interfacce in beta, la copertura delle funzionalità, i prezzi e le guide alla migrazione possono variare; verifica la documentazione aggiornata prima di confermare un'architettura di produzione.","Decisione architetturale vincolata alla data","warning",{},{"id":244,"data":245,"type":234,"tunes":249},"model-note",{"body":246,"title":247,"variant":248},"Il Runtime Ownership Test riportato di seguito è un modello architetturale pratico, non una tassonomia ufficiale dei prodotti OpenAI. Chiede quali parti del runtime dell'agente il tuo team deve controllare rispetto a quali parti desideri siano gestite da OpenAI.","Il modello decisionale utilizzato qui","note",{},{"id":251,"data":252,"type":42,"tunes":254},"h-boundary",{"text":253,"level":219},"L'architettura è cambiata: scegli un perimetro di runtime, non una libreria",{},{"id":256,"data":257,"type":226,"tunes":259},"p-boundary-1",{"text":258},"La decisione cruciale non è più semplicemente «Quale SDK dovrei installare?» Riguarda chi gestisce l'harness, l'agent loop, lo stato duraturo della sessione, la compattazione del contesto, il ripristino, l'ambiente di esecuzione e il ciclo di vita dell'applicazione.",{},{"id":261,"data":262,"type":226,"tunes":264},"p-boundary-2",{"text":263},"L'attuale panoramica di OpenAI sugli agenti rende esplicito questo confine. La Agents API esegue un harness Codex ospitato e gestisce l'orchestrazione insieme allo stato duraturo della sessione. La Responses API fornisce risposte del modello e funzionalità ospitate mentre la tua applicazione gestisce l'agent loop circostante. L'Agents SDK esegue il loop nella tua applicazione ed è ora completo dal punto di vista delle funzionalità, non rappresentando più la strada principale per lo sviluppo di nuove funzionalità per gli agenti.",{},{"id":266,"data":267,"type":42,"tunes":269},"h-short",{"text":268,"level":219},"Il confronto in sintesi",{},{"id":271,"data":272,"type":304,"tunes":305},"short-table",{"content":273,"stretched":43,"withHeadings":14},[274,280,286,292,298],[275,276,277,278,279],"Opzione","Ideale nel 2026","Chi gestisce l'agent loop?","Responsabilità di sessione \u002F contesto","Stato strategico",[281,282,283,284,285],"Agents API","Nuovi agenti duraturi nativi di OpenAI","Harness Codex gestito da OpenAI","OpenAI gestisce sessioni, orchestrazione, compattazione e ripristino","Punto di partenza consigliato per nuove app di agenti; beta pubblica",[287,288,289,290,291],"Responses API","Integrazioni dirette dei modelli e runtime di agenti personalizzati","La tua applicazione","Scegli tu il concatenamento delle risposte, le Conversations, lo storage e la logica del loop","Primitiva API principale; consigliata rispetto a Chat Completions per i nuovi progetti",[293,294,295,296,297],"Agents SDK","Applicazioni SDK esistenti o lacune temporanee di funzionalità","La tua applicazione tramite il runner dell'SDK","La tua applicazione gestisce deployment, storage e comportamento a runtime","Feature complete; manutenzione e compatibilità continuano, non sono previste nuove funzionalità principali",[299,300,301,302,303],"Codex SDK","Harness Codex su un'infrastruttura gestita da te","Harness Codex nel tuo ambiente","Gestisci l'hosting dell'harness e il ciclo di vita","Opzione separata quando desideri l'harness senza il runtime gestito della Agents API","table",{},{"id":307,"data":308,"type":42,"tunes":310},"h-agents-api",{"text":309,"level":219},"1. Agents API: harness gestito, agente cloud duraturo",{},{"id":312,"data":313,"type":226,"tunes":315},"p-api-1",{"text":314},"La Agents API espone l'harness Codex attraverso un servizio gestito da OpenAI. OpenAI gestisce le sessioni, l'orchestrazione, la compattazione del contesto e il ripristino. La tua applicazione continua a fornire gli strumenti e a selezionare l'ambiente di esecuzione.",{},{"id":317,"data":318,"type":226,"tunes":320},"p-api-2",{"text":319},"Quest'ultima distinzione è importante. «Agente gestito» non significa necessariamente «tutta l'elaborazione viene eseguita all'interno di OpenAI». L'architettura della Agents API supporta l'assenza di ambiente, un ambiente ospitato da OpenAI oppure un ambiente self-hosted collegato all'harness gestito. Con un ambiente self-hosted, la tua applicazione gestisce provisioning, riconnessione, arresto e file persistenti, mentre l'harness rimane gestito.",{},{"id":322,"data":323,"type":226,"tunes":325},"p-api-3",{"text":324},"La Agents API è quindi un servizio di runtime, non un semplice formato di richiesta. Le sessioni possono persistere, inviare lo stato di avanzamento in streaming, ricevere task aggiuntivi, usare strumenti, manipolare file e ripristinarsi nel corso di attività prolungate.",{},{"id":327,"data":328,"type":42,"tunes":330},"h-api-gain",{"text":329,"level":218},"Cosa ottieni con la Agents API",{},{"id":332,"data":333,"type":343,"tunes":344},"api-gains",{"meta":334,"items":335,"style":342},{},[336,337,338,339,340,341],"Un harness Codex gestito invece di dover costruire e gestire autonomamente l'agent loop principale.","Sessioni durature per attività che si estendono su più turni e operazioni di lunga durata.","Orchestrazione, compattazione del contesto e ripristino gestiti.","Ambienti di esecuzione ospitati da OpenAI o self-hosted, a seconda dei requisiti del carico di lavoro.","Streaming e webhook per gli avanzamenti e gli eventi del ciclo di vita.","Una direzione di piattaforma che OpenAI raccomanda esplicitamente per le nuove applicazioni basate su agenti.","unordered","list",{},{"id":346,"data":347,"type":42,"tunes":349},"h-api-own",{"text":348,"level":218},"Cosa rimane sotto la tua gestione",{},{"id":351,"data":352,"type":343,"tunes":360},"api-own",{"meta":353,"items":354,"style":342},{},[355,356,357,358,359],"Il tuo prodotto e il server dell'applicazione.","Le implementazioni dei function tool e la logica di business.","Le decisioni relative ad autorizzazioni e policy per i tuoi sistemi.","Il ciclo di vita dell'ambiente di esecuzione quando scegli un'infrastruttura di calcolo self-hosted.","La valutazione, i criteri di accettazione, i guardrail specifici di dominio e la decisione su cosa l'agente è autorizzato a fare.",{},{"id":362,"data":363,"type":42,"tunes":365},"h-responses",{"text":364,"level":219},"2. Responses API: gestisci il ciclo, usa le primitive della piattaforma",{},{"id":367,"data":368,"type":226,"tunes":370},"p-resp-1",{"text":369},"L'API Responses è la scelta di livello inferiore quando desideri le funzionalità dei modelli e degli strumenti di OpenAI senza delegare l'intero runtime dell'agente. OpenAI descrive Responses come la primitiva API consigliata per i nuovi progetti e come un'evoluzione di Chat Completions dotata di strumenti integrati, opzioni di stato multi-turn, input multimodale e uso agentico degli strumenti.",{},{"id":372,"data":373,"type":226,"tunes":375},"p-resp-2",{"text":374},"Una richiesta Responses può a sua volta invocare strumenti, ma la tua applicazione rimane responsabile del flusso di lavoro complessivo quando costruisci un agente attorno ad essa. Ciò significa che il tuo codice decide come mantenere lo stato dell'applicazione, quando proseguire, come gestire il ripristino, come coordinare gli specialisti, come compattare le cronologie estese e come rappresentare il lavoro ripristinabile.",{},{"id":377,"data":378,"type":226,"tunes":380},"p-resp-3",{"text":379},"Questo approccio non è intrinsecamente inferiore. È il confine ideale quando il comportamento dell'agente deve essere profondamente integrato nella logica applicativa esistente, quando è necessario un modello di stato personalizzato o quando un harness gestito nasconderebbe un livello di controllo di cui hai effettivamente bisogno.",{},{"id":382,"data":383,"type":42,"tunes":385},"h-sdk",{"text":384,"level":219},"3. Agents SDK: supportato, ma non più il percorso predefinito per il futuro",{},{"id":387,"data":388,"type":226,"tunes":390},"p-sdk-1",{"text":389},"L'Agents SDK rimane un framework open source per l'esecuzione di flussi di lavoro di agenti all'interno della tua applicazione. Fornisce definizioni di agenti, strumenti, passaggi di consegne (handoff), guardrail, tracciamento, sessioni e il ciclo di esecuzione (runner loop) in TypeScript e Python.",{},{"id":392,"data":393,"type":226,"tunes":395},"p-sdk-2",{"text":394},"Tuttavia, il suo ruolo strategico è cambiato. OpenAI ora etichetta l'Agents SDK come completo nelle funzionalità (feature complete): la manutenzione, le correzioni di sicurezza, le risoluzioni di bug critici e gli aggiornamenti di compatibilità continuano, ma non sono previste nuove funzionalità principali. OpenAI consiglia l'Agents API per le nuove applicazioni.",{},{"id":397,"data":398,"type":226,"tunes":400},"p-sdk-3",{"text":399},"Ciò non significa che un'applicazione SDK esistente debba essere riscritta immediatamente. Significa piuttosto che l'architettura non dovrebbe più dare per scontato che l'SDK sia la sede in cui approderanno le prossime importanti funzionalità del runtime degli agenti.",{},{"id":402,"data":403,"type":234,"tunes":406},"sdk-warning",{"body":404,"title":405,"variant":241},"OpenAI non ha dichiarato l'Agents SDK come non supportato. Le applicazioni esistenti possono continuare a utilizzarlo, e le attività di manutenzione, sicurezza, correzione di bug critici e compatibilità proseguono regolarmente. Il cambiamento rilevante è che non sono previste nuove funzionalità importanti e le nuove applicazioni vengono indirizzate verso l'Agents API.","Non interpretare “feature complete” come “deprecato”",{},{"id":408,"data":409,"type":42,"tunes":411},"h-codex-sdk",{"text":410,"level":219},"Dove si colloca il Codex SDK",{},{"id":413,"data":414,"type":226,"tunes":416},"p-codex-1",{"text":415},"La scelta attuale non è una semplice suddivisione a tre vie. La panoramica del runtime di OpenAI include il Codex SDK come opzione per eseguire l'harness di Codex nell'infrastruttura che gestisci direttamente. Questa impostazione è architettonicamente diversa sia dall'Agents API ospitata sia dall'Agents SDK.",{},{"id":418,"data":419,"type":226,"tunes":421},"p-codex-2",{"text":420},"Se la tua effettiva esigenza è “Desidero l'harness di Codex, ma devo gestirlo autonomamente”, il Codex SDK è la superficie da valutare. Se la tua esigenza è “Voglio avere il pieno controllo del ciclo attorno alle chiamate del modello”, valuta Responses. Se la tua esigenza è “Ho già un'applicazione funzionante basata sull'Agents SDK”, l'SDK esistente può rimanere valido mentre pianifichi le prossime mosse in base al suo stato di manutenzione.",{},{"id":423,"data":424,"type":42,"tunes":426},"h-test",{"text":425,"level":219},"Il test sul controllo del runtime",{},{"id":428,"data":429,"type":226,"tunes":431},"p-test-intro",{"text":430},"Una decisione architetturale efficace inizia stabilendo quali aspetti il tuo team deve controllare direttamente. Assegna a ciascun requisito una classificazione tra controllo obbligatorio, preferenza per il controllo o preferenza per la gestione delegata.",{},{"id":433,"data":434,"type":476,"tunes":477},"ownership-test",{"rows":435,"title":465,"layout":304,"columns":466},[436,441,445,449,453,457,461],{"id":437,"label":438,"values":439},"loop","Ciclo dell'agente",[440,440,440],"",{"id":442,"label":443,"values":444},"session","Sessioni persistenti",[440,440,440],{"id":446,"label":447,"values":448},"harness","Runtime dell'harness",[440,440,440],{"id":450,"label":451,"values":452},"environment","Ambiente di esecuzione",[440,440,440],{"id":454,"label":455,"values":456},"orchestration","Semantica di orchestrazione",[440,440,440],{"id":458,"label":459,"values":460},"portability","Flessibilità di provider \u002F trasporto",[440,440,440],{"id":462,"label":463,"values":464},"ops","Carico operativo",[440,440,440],"Test sul controllo del runtime",[467,470,473],{"id":468,"label":469},"decision","Decisione",{"id":471,"label":472},"managed","Se preferisci la gestione delegata",{"id":474,"label":475},"control","Se richiedi il controllo diretto","comparison",{},{"id":479,"data":480,"type":42,"tunes":482},"h-tree",{"text":481,"level":219},"Un albero decisionale per i nuovi sistemi",{},{"id":484,"data":485,"type":510,"tunes":511},"decision-flow",{"steps":486,"title":508,"orientation":509},[487,490,493,496,499,502,505],{"label":488,"description":489},"1. Si tratta di una nuova applicazione con agenti?","In caso negativo, non eseguire la migrazione solo perché esiste una superficie più recente. Valuta prima gli effettivi vincoli dell'applicazione corrente.",{"label":491,"description":492},"2. Desideri un harness gestito per agenti a lunga esecuzione?","In caso affermativo, parti con l'Agents API, in quanto percorso raccomandato da OpenAI per le nuove applicazioni con agenti.",{"label":494,"description":495},"3. Hai bisogno dell'harness di Codex ma devi gestirlo direttamente?","Valuta il Codex SDK invece di ricostruire le logiche dell'harness sopra l'Agents SDK.",{"label":497,"description":498},"4. Devi controllare il ciclo dell'agente e il modello di stato?","Usa l'API Responses come primitiva di piattaforma di livello inferiore e sviluppa il ciclo attorno ad essa.",{"label":500,"description":501},"5. Stai già utilizzando l'Agents SDK?","Continua a usarlo se risponde ai tuoi requisiti; non sono previste nuove funzionalità rilevanti, quindi considera la transizione a piattaforme future come una scelta strategica esplicita nella roadmap.",{"label":503,"description":504},"6. Manca una funzionalità indispensabile nell'Agents API?","OpenAI ammette esplicitamente l'Agents SDK come opzione a breve termine per le nuove applicazioni che necessitano di funzionalità non ancora supportate.",{"label":506,"description":507},"7. Esegui la convalida con uno spike rappresentativo della produzione","Verifica strumenti, ambiente, processi di approvazione, latenza, osservabilità, recupero dagli errori e ciclo di vita prima di definire definitivamente l'architettura.","Scegli il runtime in base al perimetro di controllo","auto","processFlow",{},{"id":513,"data":514,"type":42,"tunes":516},"h-not-drive",{"text":515,"level":219},"Cosa non dovrebbe guidare la decisione",{},{"id":518,"data":519,"type":304,"tunes":545},"weak-rules",{"content":520,"stretched":43,"withHeadings":14},[521,525,529,533,537,541],[522,523,524],"Regola decisionale debole","Perché fallisce","Domanda migliore",[526,527,528],"“L'API più recente deve essere la migliore.”","Una soluzione più recente può essere strategicamente preferibile pur mancando ancora di una funzionalità di cui hai bisogno.","Quali responsabilità di runtime dovrebbero essere gestite rispetto a quelle di proprietà dell'applicazione?",[530,531,532],"“Conosciamo già l'SDK.”","La familiarità del team può preservare un'architettura la cui roadmap è cambiata.","Qual è il costo di rimanere rispetto a migrare durante il prossimo ciclo di prodotto?",[534,535,536],"“Gestito significa nessuna infrastruttura.”","L'Agents API può comunque utilizzare ambienti self-hosted e la tua applicazione mantiene comunque la proprietà della logica di prodotto.","Quale livello di infrastruttura viene effettivamente delegato?",[538,539,540],"“Responses serve solo per chiamate semplici.”","Responses fornisce strumenti integrati e primitive stateful; può essere la base di cicli di agenti personalizzati.","Abbiamo bisogno che la piattaforma gestisca l'harness, o solo le primitive del modello\u002Fstrumento?",[542,543,544],"“Feature complete significa che dobbiamo migrare subito.”","L'SDK rimane mantenuto per le applicazioni esistenti.","Quale requisito futuro concreto è bloccato rimanendo dove siamo?",{},{"id":547,"data":548,"type":42,"tunes":550},"h-migration",{"text":549,"level":219},"La migrazione è un cambiamento architetturale, non la ridenominazione di una import",{},{"id":552,"data":553,"type":226,"tunes":555},"p-migration-1",{"text":554},"Il passaggio dall'Agents SDK all'Agents API cambia la proprietà dei componenti. Nell'SDK, il ciclo viene eseguito all'interno dell'applicazione. Nell'Agents API, OpenAI gestisce l'harness e la sessione, mentre l'applicazione si integra tramite attività, eventi, strumenti e confini dell'ambiente.",{},{"id":557,"data":558,"type":226,"tunes":560},"p-migration-2",{"text":559},"Un piano di migrazione concreto deve quindi mappare lo stato della sessione, l'orchestrazione personalizzata, gli handoff, l'esecuzione dei tool, le approvazioni, lo storage, il tracing, i tentativi di retry, il ripristino dai guasti, il ciclo di vita dell'ambiente e qualsiasi astrazione specifica del provider. Il volume di codice potrebbe ridursi, mentre cambiano i presupposti operativi.",{},{"id":562,"data":563,"type":42,"tunes":565},"h-migration-inventory",{"text":564,"level":218},"L'inventario per la migrazione",{},{"id":567,"data":568,"type":343,"tunes":581},"migration-list",{"meta":569,"items":570,"style":342},{},[571,572,573,574,575,576,577,578,579,580],"Definizioni degli agenti e titolarità delle istruzioni.","Definizioni dei tool e dove ciascun tool viene eseguito.","Handoff, pattern manager\u002Fspecialist e comportamento dei sotto-agenti.","Identificatori di sessione, stato della conversazione, capacità di ripresa e conservazione della cronologia.","Approvazioni umane e semantica di interruzione.","Logica personalizzata di trimming o compattazione del contesto.","Tracing, valutazioni, osservabilità e debugging in produzione.","File self-hosted, container, accesso a reti private o altre dipendenze di esecuzione.","Astrazione del provider o dipendenze da modelli non-OpenAI.","Presupposti su tentativi di retry, timeout, idempotenza, ripristino e ciclo di vita.",{},{"id":583,"data":584,"type":42,"tunes":586},"h-beta",{"text":585,"level":219},"La beta pubblica cambia il modello di rischio",{},{"id":588,"data":589,"type":226,"tunes":591},"p-beta-1",{"text":590},"L'Agents API è la direzione consigliata per le nuove applicazioni basate su agenti, ma è anche in versione beta pubblica. Questi elementi non sono in contraddizione. La direzione strategica risponde a \"dove sta andando la piattaforma?\". Lo stato di beta risponde a \"quante modifiche a livello di interfaccia e operative devo preventivare?\"",{},{"id":593,"data":594,"type":226,"tunes":596},"p-beta-2",{"text":595},"Per i sistemi di produzione, isola l'integrazione dietro un perimetro applicativo. Mantieni lo stato del dominio, i permessi, i dati di audit e le regole di business all'esterno degli oggetti di sessione specifici del vendor, ove possibile. In questo modo è più facile assorbire l'evoluzione delle API senza trasformare il runtime dell'agente nell'unica fonte di verità per l'intero prodotto.",{},{"id":598,"data":599,"type":42,"tunes":601},"h-default",{"text":600,"level":219},"Un'architettura predefinita pratica",{},{"id":603,"data":604,"type":226,"tunes":606},"p-default-1",{"text":605},"Per molte nuove applicazioni native per OpenAI, una configurazione predefinita ragionevole per il 2026 è: Agents API per l'harness gestito e la sessione persistente, servizi di dominio e autorizzazione di proprietà dell'applicazione, tool funzionali espliciti per le azioni di business ed esecuzione gestita da OpenAI o self-hosted a seconda dei requisiti di dati e calcolo.",{},{"id":608,"data":609,"type":226,"tunes":611},"p-default-2",{"text":610},"Ciò mantiene potente il runtime dell'agente senza renderlo il titolare delle verità di business. L'applicazione decide comunque cosa può fare un utente, quali dati sono autorevoli, quali azioni richiedono approvazione e come vengono convalidati i risultati.",{},{"id":613,"data":614,"type":619,"tunes":620},"ref-reliability",{"url":615,"title":616,"excerpt":617,"ctaLabel":618},"https:\u002F\u002Fstajic.de\u002Fit\u002Fblog\u002Fai-agent-reliability-why-the-final-answer-is-not-enough","Affidabilità degli agenti IA: perché la risposta finale non è sufficiente","Un harness gestito riduce il carico operativo, ma l'affidabilità richiede comunque un'esecuzione tracciabile, criteri di accettazione espliciti e valutazioni che vadano oltre la risposta finale.","Leggi l'articolo sull'affidabilità","referralArticle",{},{"id":622,"data":623,"type":42,"tunes":625},"h-change",{"text":624,"level":219},"Cosa potrebbe cambiare questa risposta?",{},{"id":627,"data":628,"type":226,"tunes":630},"p-change-1",{"text":629},"La raccomandazione cambia se l'Agents API aggiunge o rimuove funzionalità, esce dalla beta con contratti diversi, modifica i limiti di ambiente o di prezzo, oppure introduce strumenti di migrazione che riducono le differenze di gestione. Cambia anche se la tua applicazione dipende dalla portabilità del provider, da semantiche di orchestrazione personalizzate, da un'esecuzione esclusivamente locale o da una capacità che l'harness hosted non può supportare.",{},{"id":632,"data":633,"type":226,"tunes":635},"p-change-2",{"text":634},"Per un'applicazione esistente basata su Agents SDK, la risposta cambia anche in funzione del costo di migrazione. Se il sistema è stabile, ben valutato e non limitato dallo stato feature-complete dell'SDK, una migrazione immediata potrebbe comportare più rischi che benefici. Se la roadmap del prodotto dipende da capacità introdotte solo nell'Agents API, ritardare la migrazione può generare un debito tecnico differente.",{},{"id":637,"data":638,"type":42,"tunes":640},"h-limitations",{"text":639,"level":219},"Limitazioni",{},{"id":642,"data":643,"type":226,"tunes":645},"p-limit-1",{"text":644},"Questo confronto si concentra sulla titolarità del runtime e sulla direzione dichiarata della piattaforma OpenAI. Non fornisce benchmark di latenza, qualità o costo totale per un carico di lavoro specifico. Tali proprietà dipendono dalla scelta del modello, dall'uso dei tool, dall'ambiente, dalla lunghezza dell'attività, dal caching, dall'uso di sandbox e dall'architettura complessiva dell'applicazione.",{},{"id":647,"data":648,"type":226,"tunes":650},"p-limit-2",{"text":649},"L'Agents API è inoltre abbastanza recente da far sì che l'esperienza in produzione si stia ancora consolidando. Un'architettura dovrebbe quindi essere convalidata con carichi di lavoro rappresentativi piuttosto che scelta unicamente in base al posizionamento del prodotto.",{},{"id":652,"data":653,"type":42,"tunes":655},"h-conclusion",{"text":654,"level":219},"Conclusione",{},{"id":657,"data":658,"type":226,"tunes":660},"p-conclusion-1",{"text":659},"La scelta del runtime degli agenti OpenAI nel 2026 riguarda fondamentalmente la proprietà del runtime. L'Agents API implica che OpenAI gestisca gran parte dell'harness e dei meccanismi per le sessioni persistenti. Responses significa che la tua applicazione gestisce il ciclo attorno alle primitive della piattaforma. L'Agents SDK rimane valido per i sistemi esistenti, ma non è più la destinazione predefinita per le nuove funzionalità principali del runtime degli agenti.",{},{"id":662,"data":663,"type":226,"tunes":665},"p-conclusion-2",{"text":664},"Per una nuova applicazione, segui la direzione della piattaforma a meno che un requisito concreto non richieda di scendere a un livello inferiore dello stack. Inizia con l'Agents API, passa a Responses quando hai bisogno di gestire direttamente il ciclo, valuta il Codex SDK quando hai bisogno dell'harness nella tua infrastruttura e mantieni l'Agents SDK dove gli investimenti esistenti o temporanee lacune di funzionalità lo giustificano.",{},{"id":667,"data":668,"type":42,"tunes":670},"h-faq",{"text":669,"level":219},"FAQ",{},{"id":672,"data":673,"type":672,"tunes":700},"faq",{"items":674,"title":699},[675,679,683,687,691,695],{"id":676,"answer":677,"question":678},"faq1","OpenAI raccomanda attualmente l'Agents API per le nuove applicazioni basate su agenti. L'Agents SDK è completo a livello di funzionalità e rimane supportato per le applicazioni esistenti, con attività continuative di manutenzione, sicurezza, correzioni di bug critici e compatibilità.","Dovrei usare l'OpenAI Agents API o l'Agents SDK per un nuovo progetto?",{"id":680,"answer":681,"question":682},"faq2","OpenAI lo descrive come completo a livello di funzionalità, non come non supportato. Non sono previste nuove funzionalità importanti, ma proseguono la manutenzione, le correzioni di sicurezza, le correzioni di bug critici e il lavoro di compatibilità.","L'Agents SDK è deprecato?",{"id":684,"answer":685,"question":686},"faq3","Usa Responses quando la tua applicazione deve gestire il ciclo dell'agente, la strategia di stato, l'orchestrazione e la logica di continuazione, continuando comunque a utilizzare i modelli e gli strumenti della piattaforma OpenAI.","Quando dovrei usare la Responses API invece dell'Agents API?",{"id":688,"answer":689,"question":690},"faq4","No. L'Agents API può operare senza alcun ambiente di esecuzione, con un ambiente ospitato da OpenAI o con un ambiente self-hosted collegato all'harness gestito.","L'Agents API richiede risorse di calcolo ospitate da OpenAI?",{"id":692,"answer":693,"question":694},"faq5","OpenAI posiziona il Codex SDK per l'esecuzione dell'harness di Codex nell'infrastruttura da te gestita. È l'opzione ideale quando si desidera l'harness ma non il runtime hosted dell'Agents API.","Come si colloca il Codex SDK?",{"id":696,"answer":697,"question":698},"faq6","Non necessariamente. Valuta se il sistema attuale è limitato dallo stato di completezza delle funzionalità dell'SDK, se le capacità richieste sono presenti nell'Agents API e se i benefici della migrazione superano l'impatto operativo e architetturale.","Un'applicazione esistente basata sull'Agents SDK dovrebbe migrare immediatamente?","Scelte di runtime per gli agenti OpenAI nel 2026",{},{"id":702,"data":703,"type":42,"tunes":705},"h-glossary",{"text":704,"level":219},"Glossario",{},{"id":707,"data":708,"type":707,"tunes":730},"glossary",{"title":709,"entries":710},"Termini chiave del runtime",[711,714,717,720,723,726],{"term":712,"anchor":446,"definition":713},"Harness","Il ciclo di runtime e i meccanismi di supporto che coordinano le chiamate al modello, gli strumenti, il contesto, le sessioni e l'esecuzione dell'agente.",{"term":281,"anchor":715,"definition":716},"agents-api","L'API gestita di OpenAI per agenti cloud persistenti che utilizzano un harness Codex ospitato.",{"term":287,"anchor":718,"definition":719},"responses-api","La primitiva API di livello inferiore di OpenAI per risposte del modello, strumenti ospitati e interazioni con stato attorno alla quale le applicazioni possono costruire il proprio ciclo dell'agente.",{"term":293,"anchor":721,"definition":722},"agents-sdk","Il framework open source di OpenAI per eseguire workflow di agenti nel codice dell'applicazione; completo a livello di funzionalità a partire da settembre 2026.",{"term":299,"anchor":724,"definition":725},"codex-sdk","L'opzione di runtime indicata da OpenAI per eseguire l'harness Codex in un'infrastruttura gestita dall'utente.",{"term":727,"anchor":728,"definition":729},"Proprietà del runtime","runtime-ownership","Il confine architetturale che descrive quali parti del ciclo dell'agente, dello stato della sessione, dell'ambiente di esecuzione e del ciclo di vita sono gestite dalla piattaforma rispetto all'applicazione.",{},{"id":732,"data":733,"type":42,"tunes":735},"h-sources",{"text":734,"level":219},"Fonti primarie e approfondimenti",{},{"id":737,"data":738,"type":744,"tunes":745},"src-launch",{"link":739,"meta":740},"https:\u002F\u002Fopenai.com\u002Findex\u002Fintroducing-the-agents-api\u002F",{"image":741,"title":742,"description":743},{"url":440},"OpenAI — Presentazione dell'Agents API","Annuncio di lancio dell'Agents API del 10 settembre 2026, con la descrizione dell'harness Codex gestito e della beta pubblica.","linkTool",{},{"id":747,"data":748,"type":744,"tunes":754},"src-agents-overview",{"link":749,"meta":750},"https:\u002F\u002Fdevelopers.openai.com\u002Fapi\u002Fdocs\u002Fguides\u002Fagents",{"image":751,"title":752,"description":753},{"url":440},"OpenAI — Panoramica sul runtime degli agenti","Confronto attuale tra Agents API, Codex SDK e Responses API, incluso lo stato di supporto dell'Agents SDK.",{},{"id":756,"data":757,"type":744,"tunes":763},"src-agents-api",{"link":758,"meta":759},"https:\u002F\u002Fdevelopers.openai.com\u002Fapi\u002Fdocs\u002Fguides\u002Fagents-api\u002Foverview",{"image":760,"title":761,"description":762},{"url":440},"OpenAI — Panoramica sull'Agents API","Documentazione su agenti cloud persistenti, sessioni, orchestrazione, compattazione del contesto, ripristino e opzioni di ambiente.",{},{"id":765,"data":766,"type":744,"tunes":772},"src-architecture",{"link":767,"meta":768},"https:\u002F\u002Fdevelopers.openai.com\u002Fapi\u002Fdocs\u002Fguides\u002Fagents-api\u002Farchitecture",{"image":769,"title":770,"description":771},{"url":440},"OpenAI — Architettura dell'Agents API","Confine architetturale tra harness ospitato, server applicativo e ambienti di esecuzione assenti\u002Fospitati da OpenAI\u002Fself-hosted.",{},{"id":774,"data":775,"type":744,"tunes":781},"src-sdk",{"link":776,"meta":777},"https:\u002F\u002Fdevelopers.openai.com\u002Fapi\u002Fdocs\u002Fguides\u002Fagents\u002Fsdk",{"image":778,"title":779,"description":780},{"url":440},"OpenAI — Agents SDK","Avviso attuale sul supporto dell'Agents SDK e spiegazione del ciclo dell'agente gestito dall'applicazione.",{},{"id":783,"data":784,"type":744,"tunes":790},"src-responses",{"link":785,"meta":786},"https:\u002F\u002Fdevelopers.openai.com\u002Fapi\u002Fdocs\u002Fguides\u002Fmigrate-to-responses",{"image":787,"title":788,"description":789},{"url":440},"OpenAI — Migrazione alla Responses API","Posizionamento attuale della Responses API, strumenti integrati, contesto con stato e primitive agentiche.",{},{"id":792,"data":793,"type":220,"tunes":794},"toc",{"title":217,"maxLevel":218,"minLevel":219},{},"2.31","Lo stack di agenti di OpenAI è cambiato a settembre 2026. Questa guida all'architettura separa Agents API, Agents SDK, Responses API e Codex SDK in base alla proprietà del runtime—in modo che i team possano scegliere il giusto confine di controllo invece di confrontare i nomi dei prodotti.","\u002Fuploads\u002F2026\u002F09\u002Fopenai-agents-api-vs-agents-sdk-vs-responses-api-what-should-you-build-on-in-2026-1790351846714-zi7lus.webp","openai-agents-api-vs-agents-sdk-vs-responses-api-what-should-you-build-on-in-2026-1790351846714-zi7lus","PUBLISHED","2026-09-25T11:56:00.000Z","2026-09-25T15:56:16.274Z","2026-09-25T19:58:41.459Z",{"en":804,"de":805,"sr":806,"es":807,"fr":808,"it":809,"ru":810,"zh":811},"\u002Fblog\u002Fopenai-agents-api-vs-agents-sdk-vs-responses-api-what-should-you-build-on-in-2026","\u002Fde\u002Fblog\u002Fopenai-agents-api-vs-agents-sdk-vs-responses-api-what-should-you-build-on-in-2026","\u002Fsr\u002Fblog\u002Fopenai-agents-api-vs-agents-sdk-vs-responses-api-what-should-you-build-on-in-2026","\u002Fes\u002Fblog\u002Fopenai-agents-api-vs-agents-sdk-vs-responses-api-what-should-you-build-on-in-2026","\u002Ffr\u002Fblog\u002Fopenai-agents-api-vs-agents-sdk-vs-responses-api-what-should-you-build-on-in-2026","\u002Fit\u002Fblog\u002Fopenai-agents-api-vs-agents-sdk-vs-responses-api-what-should-you-build-on-in-2026","\u002Fru\u002Fblog\u002Fopenai-agents-api-vs-agents-sdk-vs-responses-api-what-should-you-build-on-in-2026","\u002Fzh\u002Fblog\u002Fopenai-agents-api-vs-agents-sdk-vs-responses-api-what-should-you-build-on-in-2026",[813,816,820],{"id":101,"name":814,"slug":815},"Overview","overview-digital-platform",{"id":817,"name":818,"slug":819},48,"Capacità","capabilities",{"id":821,"name":822,"slug":823},46,"Panoramica","overview",{"id":825,"login":826,"email":827,"displayName":828},"20","rooth8233","aleksandar@stajic.de","Aleksandar Stajić",[830,1299],{"lang":831,"title":832,"content":833,"contentJson":834,"excerpt":1298},"en","OpenAI Agents API vs Agents SDK vs Responses API: What Should You Build On in 2026?","{\"time\":1790352010644,\"blocks\":[{\"id\":\"75qcDhG72q\",\"type\":\"tableOfContents\",\"data\":{\"title\":\"Contents\",\"minLevel\":2,\"maxLevel\":3},\"tunes\":{}},{\"id\":\"intro\",\"type\":\"paragraph\",\"data\":{\"text\":\"OpenAI's agent stack changed materially in September 2026. The new Agents API introduced a managed Codex harness for durable cloud agents, while the older Agents SDK moved into a feature-complete maintenance phase. The Responses API remains the lower-level surface for applications that want direct model calls or to own the agent loop themselves. These are not three interchangeable wrappers around the same thing: they place the runtime boundary in different places.\"},\"tunes\":{}},{\"id\":\"direct\",\"type\":\"callout\",\"data\":{\"variant\":\"info\",\"title\":\"Direct answer\",\"body\":\"\u003Cstrong>For a new OpenAI-native agent application in September 2026, start with the Agents API unless you have a concrete reason to own more of the runtime.\u003C\u002Fstrong> Use the Responses API when your application should own the loop, state strategy, and orchestration. Keep the Agents SDK for existing applications or short-term gaps where the Agents API does not yet support a required capability. If you want the Codex harness itself but need to run it in infrastructure you operate, evaluate the Codex SDK rather than forcing the Agents SDK into that role.\"},\"tunes\":{}},{\"id\":\"date-warning\",\"type\":\"callout\",\"data\":{\"variant\":\"warning\",\"title\":\"Time-sensitive architecture decision\",\"body\":\"This article reflects OpenAI's platform state on \u003Cstrong>25 September 2026\u003C\u002Fstrong>. The Agents API launched in public beta on 10 September 2026. Beta surfaces, feature coverage, pricing, and migration guidance can change; verify current documentation before committing a production architecture.\"},\"tunes\":{}},{\"id\":\"model-note\",\"type\":\"callout\",\"data\":{\"variant\":\"note\",\"title\":\"The decision model used here\",\"body\":\"The Runtime Ownership Test below is a practical architecture model, not an OpenAI product taxonomy. It asks which parts of the agent runtime your team must control versus which parts you want OpenAI to operate.\"},\"tunes\":{}},{\"id\":\"h-boundary\",\"type\":\"header\",\"data\":{\"text\":\"The architecture changed: choose a runtime boundary, not a library\",\"level\":2},\"tunes\":{}},{\"id\":\"p-boundary-1\",\"type\":\"paragraph\",\"data\":{\"text\":\"The important decision is no longer simply “Which SDK should I install?” It is who owns the harness, the agent loop, durable session state, context compaction, recovery, execution environment, and application lifecycle.\"},\"tunes\":{}},{\"id\":\"p-boundary-2\",\"type\":\"paragraph\",\"data\":{\"text\":\"OpenAI's current Agents overview makes this boundary explicit. The Agents API runs a hosted Codex harness and manages orchestration plus durable session state. The Responses API provides model responses and hosted capabilities while your application owns the surrounding agent loop. The Agents SDK runs the loop in your application and is now feature complete rather than the forward path for major new agent features.\"},\"tunes\":{}},{\"id\":\"h-short\",\"type\":\"header\",\"data\":{\"text\":\"The short comparison\",\"level\":2},\"tunes\":{}},{\"id\":\"short-table\",\"type\":\"table\",\"data\":{\"withHeadings\":true,\"stretched\":false,\"content\":[[\"Option\",\"Best fit in 2026\",\"Who owns the agent loop?\",\"Session \u002F context responsibility\",\"Strategic status\"],[\"Agents API\",\"New OpenAI-native durable agents\",\"OpenAI-managed Codex harness\",\"OpenAI manages sessions, orchestration, compaction and recovery\",\"Recommended starting point for new agent apps; public beta\"],[\"Responses API\",\"Direct model integrations and custom agent runtimes\",\"Your application\",\"You choose response chaining, Conversations, storage and loop logic\",\"Core API primitive; recommended over Chat Completions for new projects\"],[\"Agents SDK\",\"Existing SDK applications or temporary capability gaps\",\"Your application via the SDK runner\",\"Your application operates deployment, storage and runtime behaviour\",\"Feature complete; maintenance and compatibility continue, major new features not planned\"],[\"Codex SDK\",\"Codex harness in infrastructure you operate\",\"Codex harness in your environment\",\"You operate harness hosting and lifecycle\",\"Separate option when you want the harness without the hosted Agents API runtime\"]]},\"tunes\":{}},{\"id\":\"h-agents-api\",\"type\":\"header\",\"data\":{\"text\":\"1. Agents API: managed harness, durable cloud agent\",\"level\":2},\"tunes\":{}},{\"id\":\"p-api-1\",\"type\":\"paragraph\",\"data\":{\"text\":\"The Agents API exposes the Codex harness through an OpenAI-managed service. OpenAI manages sessions, orchestration, context compaction, and recovery. Your application still provides tools and chooses the execution environment.\"},\"tunes\":{}},{\"id\":\"p-api-2\",\"type\":\"paragraph\",\"data\":{\"text\":\"That last distinction matters. “Managed agent” does not necessarily mean “all compute runs inside OpenAI.” The Agents API architecture supports no environment, an OpenAI-hosted environment, or a self-hosted environment connected to the hosted harness. With a self-hosted environment, your application owns provisioning, reconnection, shutdown, and persistent files while the harness remains managed.\"},\"tunes\":{}},{\"id\":\"p-api-3\",\"type\":\"paragraph\",\"data\":{\"text\":\"The Agents API is therefore a runtime service, not merely a request format. Sessions can persist, stream progress, receive additional tasks, use tools, work with files, and recover across long-running work.\"},\"tunes\":{}},{\"id\":\"h-api-gain\",\"type\":\"header\",\"data\":{\"text\":\"What you gain with the Agents API\",\"level\":3},\"tunes\":{}},{\"id\":\"api-gains\",\"type\":\"list\",\"data\":{\"style\":\"unordered\",\"meta\":{},\"items\":[\"A managed Codex harness instead of building and operating the main agent loop yourself.\",\"Durable sessions for work that spans turns and long-running tasks.\",\"Managed orchestration, context compaction, and recovery.\",\"OpenAI-hosted or self-hosted execution environments, depending on workload requirements.\",\"Streaming and webhooks for progress and lifecycle events.\",\"A platform direction that OpenAI explicitly recommends for new agent applications.\"]},\"tunes\":{}},{\"id\":\"h-api-own\",\"type\":\"header\",\"data\":{\"text\":\"What you still own\",\"level\":3},\"tunes\":{}},{\"id\":\"api-own\",\"type\":\"list\",\"data\":{\"style\":\"unordered\",\"meta\":{},\"items\":[\"Your product and application server.\",\"Function-tool implementations and business logic.\",\"Authorization and policy decisions around your own systems.\",\"The execution environment lifecycle when you choose self-hosted compute.\",\"Evaluation, acceptance criteria, domain-specific guardrails, and the decision of what the agent is allowed to do.\"]},\"tunes\":{}},{\"id\":\"h-responses\",\"type\":\"header\",\"data\":{\"text\":\"2. Responses API: own the loop, use the platform primitives\",\"level\":2},\"tunes\":{}},{\"id\":\"p-resp-1\",\"type\":\"paragraph\",\"data\":{\"text\":\"The Responses API is the lower-level choice when you want OpenAI model and tool capabilities without delegating the overall agent runtime. OpenAI describes Responses as the recommended API primitive for new projects and as an evolution of Chat Completions with built-in tools, multi-turn state options, multimodal input, and agentic tool use.\"},\"tunes\":{}},{\"id\":\"p-resp-2\",\"type\":\"paragraph\",\"data\":{\"text\":\"A Responses request can itself invoke tools, but your application remains responsible for the larger workflow when you build an agent around it. That means your code decides how to persist application state, when to continue, how to recover, how to coordinate specialists, how to compact long histories, and how to represent resumable work.\"},\"tunes\":{}},{\"id\":\"p-resp-3\",\"type\":\"paragraph\",\"data\":{\"text\":\"This is not inherently inferior. It is the right boundary when agent behaviour must be deeply embedded in existing application logic, when you need a custom state model, or when a managed harness would hide control you actually need.\"},\"tunes\":{}},{\"id\":\"h-sdk\",\"type\":\"header\",\"data\":{\"text\":\"3. Agents SDK: supported, but no longer the default forward path\",\"level\":2},\"tunes\":{}},{\"id\":\"p-sdk-1\",\"type\":\"paragraph\",\"data\":{\"text\":\"The Agents SDK remains an open-source framework for running agent workflows in your application. It provides agent definitions, tools, handoffs, guardrails, tracing, sessions, and the runner loop in TypeScript and Python.\"},\"tunes\":{}},{\"id\":\"p-sdk-2\",\"type\":\"paragraph\",\"data\":{\"text\":\"But its strategic status changed. OpenAI now labels the Agents SDK feature complete: maintenance, security fixes, critical bug fixes, and compatibility work continue, but major new features are not planned. OpenAI recommends the Agents API for new applications.\"},\"tunes\":{}},{\"id\":\"p-sdk-3\",\"type\":\"paragraph\",\"data\":{\"text\":\"That does not mean an existing SDK application should be rewritten immediately. It means the architecture should stop assuming that the SDK is where the next major agent-runtime capabilities will land.\"},\"tunes\":{}},{\"id\":\"sdk-warning\",\"type\":\"callout\",\"data\":{\"variant\":\"warning\",\"title\":\"Do not translate “feature complete” into “deprecated”\",\"body\":\"OpenAI has not described the Agents SDK as unsupported. Existing applications can continue to use it, and maintenance, security, critical bug fixes, and compatibility work continue. The important change is that major new features are not planned and new applications are directed to the Agents API.\"},\"tunes\":{}},{\"id\":\"h-codex-sdk\",\"type\":\"header\",\"data\":{\"text\":\"Where the Codex SDK fits\",\"level\":2},\"tunes\":{}},{\"id\":\"p-codex-1\",\"type\":\"paragraph\",\"data\":{\"text\":\"The current choice is not a simple three-way fork. OpenAI's runtime overview includes the Codex SDK as the option for running the Codex harness in infrastructure you operate. That is architecturally different from both the hosted Agents API and the Agents SDK.\"},\"tunes\":{}},{\"id\":\"p-codex-2\",\"type\":\"paragraph\",\"data\":{\"text\":\"If your real requirement is “I want the Codex harness, but I need to operate it myself,” the Codex SDK is the surface to evaluate. If your requirement is “I want to own the loop around model calls,” evaluate Responses. If your requirement is “I already have a working Agents SDK application,” the existing SDK can remain valid while you plan against its maintenance status.\"},\"tunes\":{}},{\"id\":\"h-test\",\"type\":\"header\",\"data\":{\"text\":\"The Runtime Ownership Test\",\"level\":2},\"tunes\":{}},{\"id\":\"p-test-intro\",\"type\":\"paragraph\",\"data\":{\"text\":\"A useful architecture decision starts by deciding what your team must own. Score each requirement as either must control, prefer to control, or prefer managed.\"},\"tunes\":{}},{\"id\":\"ownership-test\",\"type\":\"comparison\",\"data\":{\"title\":\"Runtime Ownership Test\",\"layout\":\"table\",\"columns\":[{\"id\":\"decision\",\"label\":\"Decision\"},{\"id\":\"managed\",\"label\":\"If you prefer managed\"},{\"id\":\"control\",\"label\":\"If you require control\"}],\"rows\":[{\"id\":\"loop\",\"label\":\"Agent loop\",\"values\":[\"\",\"\",\"\"]},{\"id\":\"session\",\"label\":\"Durable sessions\",\"values\":[\"\",\"\",\"\"]},{\"id\":\"harness\",\"label\":\"Harness runtime\",\"values\":[\"\",\"\",\"\"]},{\"id\":\"environment\",\"label\":\"Execution environment\",\"values\":[\"\",\"\",\"\"]},{\"id\":\"orchestration\",\"label\":\"Orchestration semantics\",\"values\":[\"\",\"\",\"\"]},{\"id\":\"portability\",\"label\":\"Provider \u002F transport flexibility\",\"values\":[\"\",\"\",\"\"]},{\"id\":\"ops\",\"label\":\"Operational burden\",\"values\":[\"\",\"\",\"\"]}]},\"tunes\":{}},{\"id\":\"h-tree\",\"type\":\"header\",\"data\":{\"text\":\"A decision tree for new systems\",\"level\":2},\"tunes\":{}},{\"id\":\"decision-flow\",\"type\":\"processFlow\",\"data\":{\"title\":\"Choose the runtime by the control boundary\",\"orientation\":\"auto\",\"steps\":[{\"label\":\"1. Is this a new agent application?\",\"description\":\"If no, do not migrate solely because a newer surface exists. Evaluate the current application's actual constraints first.\"},{\"label\":\"2. Do you want a managed long-running agent harness?\",\"description\":\"If yes, start with the Agents API as OpenAI's recommended path for new agent applications.\"},{\"label\":\"3. Do you need the Codex harness but must operate it yourself?\",\"description\":\"Evaluate the Codex SDK rather than rebuilding harness behaviour on top of the Agents SDK.\"},{\"label\":\"4. Do you need to own the agent loop and state model?\",\"description\":\"Use the Responses API as the lower-level platform primitive and build the loop around it.\"},{\"label\":\"5. Are you already on the Agents SDK?\",\"description\":\"Continue if it meets requirements; major new features are not planned, so treat future platform adoption as an explicit roadmap decision.\"},{\"label\":\"6. Is a required capability missing from the Agents API?\",\"description\":\"OpenAI explicitly allows the Agents SDK as a short-term option for new applications that need unsupported capabilities.\"},{\"label\":\"7. Validate with a production-shaped spike\",\"description\":\"Test tools, environment, approvals, latency, observability, failure recovery, and lifecycle before locking the architecture.\"}]},\"tunes\":{}},{\"id\":\"h-not-drive\",\"type\":\"header\",\"data\":{\"text\":\"What should not drive the decision\",\"level\":2},\"tunes\":{}},{\"id\":\"weak-rules\",\"type\":\"table\",\"data\":{\"withHeadings\":true,\"stretched\":false,\"content\":[[\"Weak decision rule\",\"Why it fails\",\"Better question\"],[\"“The newest API must be best.”\",\"Newer can be strategically preferred while still lacking a capability you need.\",\"Which runtime responsibilities should be managed versus application-owned?\"],[\"“We already know the SDK.”\",\"Team familiarity can preserve an architecture whose roadmap has changed.\",\"What is the cost of staying versus moving over the next product cycle?\"],[\"“Managed means no infrastructure.”\",\"Agents API can still use self-hosted environments and your application still owns product logic.\",\"Which infrastructure layer is actually being delegated?\"],[\"“Responses is only for simple calls.”\",\"Responses provides built-in tools and stateful primitives; it can be the foundation of custom agent loops.\",\"Do we need the platform to own the harness, or only model\u002Ftool primitives?\"],[\"“Feature complete means we must migrate now.”\",\"The SDK remains maintained for existing applications.\",\"What concrete future requirement is blocked by staying?\"]]},\"tunes\":{}},{\"id\":\"h-migration\",\"type\":\"header\",\"data\":{\"text\":\"Migration is an architectural change, not an import rename\",\"level\":2},\"tunes\":{}},{\"id\":\"p-migration-1\",\"type\":\"paragraph\",\"data\":{\"text\":\"Moving from the Agents SDK to the Agents API changes ownership. In the SDK, the loop runs in your application. In the Agents API, OpenAI runs the harness and session while your application integrates through tasks, events, tools, and environment boundaries.\"},\"tunes\":{}},{\"id\":\"p-migration-2\",\"type\":\"paragraph\",\"data\":{\"text\":\"A real migration plan therefore needs to map session state, custom orchestration, handoffs, tool execution, approvals, storage, tracing, retries, failure recovery, environment lifecycle, and any provider-specific abstractions. Code volume may fall while operational assumptions change.\"},\"tunes\":{}},{\"id\":\"h-migration-inventory\",\"type\":\"header\",\"data\":{\"text\":\"The migration inventory\",\"level\":3},\"tunes\":{}},{\"id\":\"migration-list\",\"type\":\"list\",\"data\":{\"style\":\"unordered\",\"meta\":{},\"items\":[\"Agent definitions and instruction ownership.\",\"Tool definitions and where each tool executes.\",\"Handoffs, manager\u002Fspecialist patterns, and subagent behaviour.\",\"Session identifiers, conversation state, resumability, and history retention.\",\"Human approvals and interruption semantics.\",\"Custom context trimming or compaction logic.\",\"Tracing, evals, observability, and production debugging.\",\"Self-hosted files, containers, private-network access, or other execution dependencies.\",\"Provider abstraction or non-OpenAI model dependencies.\",\"Retry, timeout, idempotency, recovery, and lifecycle assumptions.\"]},\"tunes\":{}},{\"id\":\"h-beta\",\"type\":\"header\",\"data\":{\"text\":\"Public beta changes the risk model\",\"level\":2},\"tunes\":{}},{\"id\":\"p-beta-1\",\"type\":\"paragraph\",\"data\":{\"text\":\"The Agents API is the recommended direction for new agent applications, but it is also in public beta. Those facts are not contradictory. Strategic direction answers “where is the platform going?” Beta status answers “how much interface and operational change should I budget for?”\"},\"tunes\":{}},{\"id\":\"p-beta-2\",\"type\":\"paragraph\",\"data\":{\"text\":\"For production systems, isolate the integration behind an application boundary. Keep domain state, permissions, audit data, and business rules outside vendor-specific session objects where possible. This makes it easier to absorb API evolution without turning the agent runtime into the source of truth for your entire product.\"},\"tunes\":{}},{\"id\":\"h-default\",\"type\":\"header\",\"data\":{\"text\":\"A practical default architecture\",\"level\":2},\"tunes\":{}},{\"id\":\"p-default-1\",\"type\":\"paragraph\",\"data\":{\"text\":\"For many new OpenAI-native applications, a reasonable 2026 default is: Agents API for the managed harness and durable session, application-owned domain services and authorization, explicit function tools for business actions, and either OpenAI-hosted or self-hosted execution depending on data and compute requirements.\"},\"tunes\":{}},{\"id\":\"p-default-2\",\"type\":\"paragraph\",\"data\":{\"text\":\"That keeps the agent runtime powerful without making it the owner of business truth. The application still decides what a user may do, which data is authoritative, which actions require approval, and how results are validated.\"},\"tunes\":{}},{\"id\":\"ref-reliability\",\"type\":\"referralArticle\",\"data\":{\"url\":\"https:\u002F\u002Fstajic.de\u002Fblog\u002Fai-agent-reliability-why-the-final-answer-is-not-enough\",\"title\":\"AI Agent Reliability: Why the Final Answer Is Not Enough\",\"excerpt\":\"A managed harness reduces operational burden, but reliability still requires traceable execution, explicit acceptance criteria and evaluation beyond the final answer.\",\"ctaLabel\":\"Read the reliability article\"},\"tunes\":{}},{\"id\":\"h-change\",\"type\":\"header\",\"data\":{\"text\":\"What would change this answer?\",\"level\":2},\"tunes\":{}},{\"id\":\"p-change-1\",\"type\":\"paragraph\",\"data\":{\"text\":\"The recommendation changes if the Agents API adds or removes capabilities, exits beta with different contracts, changes environment or pricing boundaries, or introduces migration tooling that reduces ownership differences. It also changes if your application depends on provider portability, custom orchestration semantics, local-only execution, or a capability the hosted harness cannot support.\"},\"tunes\":{}},{\"id\":\"p-change-2\",\"type\":\"paragraph\",\"data\":{\"text\":\"For an existing Agents SDK application, the answer also changes with migration cost. If the system is stable, well evaluated, and not blocked by the SDK's feature-complete status, immediate migration may create more risk than value. If the product roadmap depends on capabilities landing only in the Agents API, delaying migration can create a different kind of debt.\"},\"tunes\":{}},{\"id\":\"h-limitations\",\"type\":\"header\",\"data\":{\"text\":\"Limitations\",\"level\":2},\"tunes\":{}},{\"id\":\"p-limit-1\",\"type\":\"paragraph\",\"data\":{\"text\":\"This comparison focuses on runtime ownership and OpenAI's stated platform direction. It does not benchmark latency, quality, or total cost for a specific workload. Those properties depend on model choice, tool usage, environment, task length, caching, sandbox usage, and application architecture.\"},\"tunes\":{}},{\"id\":\"p-limit-2\",\"type\":\"paragraph\",\"data\":{\"text\":\"The Agents API is also new enough that production experience is still accumulating. A design should therefore be validated with representative workloads rather than chosen solely from product positioning.\"},\"tunes\":{}},{\"id\":\"h-conclusion\",\"type\":\"header\",\"data\":{\"text\":\"Conclusion\",\"level\":2},\"tunes\":{}},{\"id\":\"p-conclusion-1\",\"type\":\"paragraph\",\"data\":{\"text\":\"The 2026 OpenAI agent decision is fundamentally about runtime ownership. Agents API means OpenAI owns more of the harness and durable-session machinery. Responses means your application owns the loop around platform primitives. The Agents SDK remains valid for existing systems but is no longer the default destination for major new agent-runtime features.\"},\"tunes\":{}},{\"id\":\"p-conclusion-2\",\"type\":\"paragraph\",\"data\":{\"text\":\"For a new application, follow the platform direction unless a real requirement pushes you lower in the stack. Start with the Agents API, move to Responses when you need to own the loop, evaluate Codex SDK when you need the harness in your infrastructure, and keep the Agents SDK where existing investments or temporary capability gaps justify it.\"},\"tunes\":{}},{\"id\":\"h-faq\",\"type\":\"header\",\"data\":{\"text\":\"FAQ\",\"level\":2},\"tunes\":{}},{\"id\":\"faq\",\"type\":\"faq\",\"data\":{\"title\":\"OpenAI agent runtime choices in 2026\",\"items\":[{\"id\":\"faq1\",\"question\":\"Should I use the OpenAI Agents API or Agents SDK for a new project?\",\"answer\":\"OpenAI currently recommends the Agents API for new agent applications. The Agents SDK is feature complete and remains supported for existing applications, with maintenance, security, critical bug fixes and compatibility work continuing.\"},{\"id\":\"faq2\",\"question\":\"Is the Agents SDK deprecated?\",\"answer\":\"OpenAI describes it as feature complete, not as unsupported. Major new features are not planned, but maintenance, security fixes, critical bug fixes and compatibility work continue.\"},{\"id\":\"faq3\",\"question\":\"When should I use the Responses API instead of the Agents API?\",\"answer\":\"Use Responses when your application should own the agent loop, state strategy, orchestration and continuation logic while still using OpenAI models and platform tools.\"},{\"id\":\"faq4\",\"question\":\"Does the Agents API require OpenAI-hosted compute?\",\"answer\":\"No. The Agents API can use no execution environment, an OpenAI-hosted environment, or a self-hosted environment connected to the managed harness.\"},{\"id\":\"faq5\",\"question\":\"Where does the Codex SDK fit?\",\"answer\":\"OpenAI positions the Codex SDK for running the Codex harness in infrastructure you operate. It is the relevant option when you want the harness but not the hosted Agents API runtime.\"},{\"id\":\"faq6\",\"question\":\"Should an existing Agents SDK app migrate immediately?\",\"answer\":\"Not automatically. Evaluate whether the current system is blocked by the SDK's feature-complete status, whether required capabilities exist in the Agents API, and whether the migration benefit exceeds the operational and architectural change.\"}]},\"tunes\":{}},{\"id\":\"h-glossary\",\"type\":\"header\",\"data\":{\"text\":\"Glossary\",\"level\":2},\"tunes\":{}},{\"id\":\"glossary\",\"type\":\"glossary\",\"data\":{\"title\":\"Key runtime terms\",\"entries\":[{\"term\":\"Harness\",\"definition\":\"The runtime loop and supporting machinery that coordinates model calls, tools, context, sessions and agent execution.\",\"anchor\":\"harness\"},{\"term\":\"Agents API\",\"definition\":\"OpenAI's managed API for durable cloud agents using a hosted Codex harness.\",\"anchor\":\"agents-api\"},{\"term\":\"Responses API\",\"definition\":\"OpenAI's lower-level API primitive for model responses, hosted tools and stateful interactions around which applications can build their own agent loop.\",\"anchor\":\"responses-api\"},{\"term\":\"Agents SDK\",\"definition\":\"OpenAI's open-source framework for running agent workflows in application code; feature complete as of September 2026.\",\"anchor\":\"agents-sdk\"},{\"term\":\"Codex SDK\",\"definition\":\"The runtime option OpenAI lists for running the Codex harness in infrastructure you operate.\",\"anchor\":\"codex-sdk\"},{\"term\":\"Runtime ownership\",\"definition\":\"The architectural boundary describing which parts of the agent loop, session state, execution environment and lifecycle are operated by the platform versus the application.\",\"anchor\":\"runtime-ownership\"}]},\"tunes\":{}},{\"id\":\"h-sources\",\"type\":\"header\",\"data\":{\"text\":\"Primary sources and further reading\",\"level\":2},\"tunes\":{}},{\"id\":\"src-launch\",\"type\":\"linkTool\",\"data\":{\"link\":\"https:\u002F\u002Fopenai.com\u002Findex\u002Fintroducing-the-agents-api\u002F\",\"meta\":{\"image\":{\"url\":\"\"},\"title\":\"OpenAI — Introducing the Agents API\",\"description\":\"Launch announcement for the Agents API on 10 September 2026, describing the managed Codex harness and public beta.\"}},\"tunes\":{}},{\"id\":\"src-agents-overview\",\"type\":\"linkTool\",\"data\":{\"link\":\"https:\u002F\u002Fdevelopers.openai.com\u002Fapi\u002Fdocs\u002Fguides\u002Fagents\",\"meta\":{\"image\":{\"url\":\"\"},\"title\":\"OpenAI — Agents runtime overview\",\"description\":\"Current comparison of Agents API, Codex SDK and Responses API, including the support status of the Agents SDK.\"}},\"tunes\":{}},{\"id\":\"src-agents-api\",\"type\":\"linkTool\",\"data\":{\"link\":\"https:\u002F\u002Fdevelopers.openai.com\u002Fapi\u002Fdocs\u002Fguides\u002Fagents-api\u002Foverview\",\"meta\":{\"image\":{\"url\":\"\"},\"title\":\"OpenAI — Agents API overview\",\"description\":\"Documentation for durable cloud agents, sessions, orchestration, context compaction, recovery and environment choices.\"}},\"tunes\":{}},{\"id\":\"src-architecture\",\"type\":\"linkTool\",\"data\":{\"link\":\"https:\u002F\u002Fdevelopers.openai.com\u002Fapi\u002Fdocs\u002Fguides\u002Fagents-api\u002Farchitecture\",\"meta\":{\"image\":{\"url\":\"\"},\"title\":\"OpenAI — Agents API architecture\",\"description\":\"Architecture boundary between the hosted harness, application server and no\u002Fopenai-hosted\u002Fself-hosted execution environments.\"}},\"tunes\":{}},{\"id\":\"src-sdk\",\"type\":\"linkTool\",\"data\":{\"link\":\"https:\u002F\u002Fdevelopers.openai.com\u002Fapi\u002Fdocs\u002Fguides\u002Fagents\u002Fsdk\",\"meta\":{\"image\":{\"url\":\"\"},\"title\":\"OpenAI — Agents SDK\",\"description\":\"Current Agents SDK support notice and explanation of the application-owned agent loop.\"}},\"tunes\":{}},{\"id\":\"src-responses\",\"type\":\"linkTool\",\"data\":{\"link\":\"https:\u002F\u002Fdevelopers.openai.com\u002Fapi\u002Fdocs\u002Fguides\u002Fmigrate-to-responses\",\"meta\":{\"image\":{\"url\":\"\"},\"title\":\"OpenAI — Migrate to the Responses API\",\"description\":\"Current Responses API positioning, built-in tools, stateful context and agentic primitives.\"}},\"tunes\":{}},{\"id\":\"toc\",\"type\":\"tableOfContents\",\"data\":{\"title\":\"Contents\",\"minLevel\":2,\"maxLevel\":3},\"tunes\":{}}],\"version\":\"2.31.6\"}",{"time":835,"blocks":836,"version":1297},1790352010644,[837,841,845,850,855,860,864,868,872,876,906,910,914,918,922,926,937,941,951,955,959,963,967,971,975,979,983,988,992,996,1000,1004,1008,1041,1045,1071,1075,1103,1107,1111,1115,1119,1134,1138,1142,1146,1150,1154,1158,1165,1169,1173,1177,1181,1185,1189,1193,1197,1201,1204,1227,1231,1249,1253,1260,1267,1274,1281,1287,1294],{"id":215,"data":838,"type":220,"tunes":840},{"title":839,"maxLevel":218,"minLevel":219},"Contents",{},{"id":223,"data":842,"type":226,"tunes":844},{"text":843},"OpenAI's agent stack changed materially in September 2026. The new Agents API introduced a managed Codex harness for durable cloud agents, while the older Agents SDK moved into a feature-complete maintenance phase. The Responses API remains the lower-level surface for applications that want direct model calls or to own the agent loop themselves. These are not three interchangeable wrappers around the same thing: they place the runtime boundary in different places.",{},{"id":229,"data":846,"type":234,"tunes":849},{"body":847,"title":848,"variant":233},"\u003Cstrong>For a new OpenAI-native agent application in September 2026, start with the Agents API unless you have a concrete reason to own more of the runtime.\u003C\u002Fstrong> Use the Responses API when your application should own the loop, state strategy, and orchestration. Keep the Agents SDK for existing applications or short-term gaps where the Agents API does not yet support a required capability. If you want the Codex harness itself but need to run it in infrastructure you operate, evaluate the Codex SDK rather than forcing the Agents SDK into that role.","Direct answer",{},{"id":237,"data":851,"type":234,"tunes":854},{"body":852,"title":853,"variant":241},"This article reflects OpenAI's platform state on \u003Cstrong>25 September 2026\u003C\u002Fstrong>. The Agents API launched in public beta on 10 September 2026. Beta surfaces, feature coverage, pricing, and migration guidance can change; verify current documentation before committing a production architecture.","Time-sensitive architecture decision",{},{"id":244,"data":856,"type":234,"tunes":859},{"body":857,"title":858,"variant":248},"The Runtime Ownership Test below is a practical architecture model, not an OpenAI product taxonomy. It asks which parts of the agent runtime your team must control versus which parts you want OpenAI to operate.","The decision model used here",{},{"id":251,"data":861,"type":42,"tunes":863},{"text":862,"level":219},"The architecture changed: choose a runtime boundary, not a library",{},{"id":256,"data":865,"type":226,"tunes":867},{"text":866},"The important decision is no longer simply “Which SDK should I install?” It is who owns the harness, the agent loop, durable session state, context compaction, recovery, execution environment, and application lifecycle.",{},{"id":261,"data":869,"type":226,"tunes":871},{"text":870},"OpenAI's current Agents overview makes this boundary explicit. The Agents API runs a hosted Codex harness and manages orchestration plus durable session state. The Responses API provides model responses and hosted capabilities while your application owns the surrounding agent loop. The Agents SDK runs the loop in your application and is now feature complete rather than the forward path for major new agent features.",{},{"id":266,"data":873,"type":42,"tunes":875},{"text":874,"level":219},"The short comparison",{},{"id":271,"data":877,"type":304,"tunes":905},{"content":878,"stretched":43,"withHeadings":14},[879,885,890,895,900],[880,881,882,883,884],"Option","Best fit in 2026","Who owns the agent loop?","Session \u002F context responsibility","Strategic status",[281,886,887,888,889],"New OpenAI-native durable agents","OpenAI-managed Codex harness","OpenAI manages sessions, orchestration, compaction and recovery","Recommended starting point for new agent apps; public beta",[287,891,892,893,894],"Direct model integrations and custom agent runtimes","Your application","You choose response chaining, Conversations, storage and loop logic","Core API primitive; recommended over Chat Completions for new projects",[293,896,897,898,899],"Existing SDK applications or temporary capability gaps","Your application via the SDK runner","Your application operates deployment, storage and runtime behaviour","Feature complete; maintenance and compatibility continue, major new features not planned",[299,901,902,903,904],"Codex harness in infrastructure you operate","Codex harness in your environment","You operate harness hosting and lifecycle","Separate option when you want the harness without the hosted Agents API runtime",{},{"id":307,"data":907,"type":42,"tunes":909},{"text":908,"level":219},"1. Agents API: managed harness, durable cloud agent",{},{"id":312,"data":911,"type":226,"tunes":913},{"text":912},"The Agents API exposes the Codex harness through an OpenAI-managed service. OpenAI manages sessions, orchestration, context compaction, and recovery. Your application still provides tools and chooses the execution environment.",{},{"id":317,"data":915,"type":226,"tunes":917},{"text":916},"That last distinction matters. “Managed agent” does not necessarily mean “all compute runs inside OpenAI.” The Agents API architecture supports no environment, an OpenAI-hosted environment, or a self-hosted environment connected to the hosted harness. With a self-hosted environment, your application owns provisioning, reconnection, shutdown, and persistent files while the harness remains managed.",{},{"id":322,"data":919,"type":226,"tunes":921},{"text":920},"The Agents API is therefore a runtime service, not merely a request format. Sessions can persist, stream progress, receive additional tasks, use tools, work with files, and recover across long-running work.",{},{"id":327,"data":923,"type":42,"tunes":925},{"text":924,"level":218},"What you gain with the Agents API",{},{"id":332,"data":927,"type":343,"tunes":936},{"meta":928,"items":929,"style":342},{},[930,931,932,933,934,935],"A managed Codex harness instead of building and operating the main agent loop yourself.","Durable sessions for work that spans turns and long-running tasks.","Managed orchestration, context compaction, and recovery.","OpenAI-hosted or self-hosted execution environments, depending on workload requirements.","Streaming and webhooks for progress and lifecycle events.","A platform direction that OpenAI explicitly recommends for new agent applications.",{},{"id":346,"data":938,"type":42,"tunes":940},{"text":939,"level":218},"What you still own",{},{"id":351,"data":942,"type":343,"tunes":950},{"meta":943,"items":944,"style":342},{},[945,946,947,948,949],"Your product and application server.","Function-tool implementations and business logic.","Authorization and policy decisions around your own systems.","The execution environment lifecycle when you choose self-hosted compute.","Evaluation, acceptance criteria, domain-specific guardrails, and the decision of what the agent is allowed to do.",{},{"id":362,"data":952,"type":42,"tunes":954},{"text":953,"level":219},"2. Responses API: own the loop, use the platform primitives",{},{"id":367,"data":956,"type":226,"tunes":958},{"text":957},"The Responses API is the lower-level choice when you want OpenAI model and tool capabilities without delegating the overall agent runtime. OpenAI describes Responses as the recommended API primitive for new projects and as an evolution of Chat Completions with built-in tools, multi-turn state options, multimodal input, and agentic tool use.",{},{"id":372,"data":960,"type":226,"tunes":962},{"text":961},"A Responses request can itself invoke tools, but your application remains responsible for the larger workflow when you build an agent around it. That means your code decides how to persist application state, when to continue, how to recover, how to coordinate specialists, how to compact long histories, and how to represent resumable work.",{},{"id":377,"data":964,"type":226,"tunes":966},{"text":965},"This is not inherently inferior. It is the right boundary when agent behaviour must be deeply embedded in existing application logic, when you need a custom state model, or when a managed harness would hide control you actually need.",{},{"id":382,"data":968,"type":42,"tunes":970},{"text":969,"level":219},"3. Agents SDK: supported, but no longer the default forward path",{},{"id":387,"data":972,"type":226,"tunes":974},{"text":973},"The Agents SDK remains an open-source framework for running agent workflows in your application. It provides agent definitions, tools, handoffs, guardrails, tracing, sessions, and the runner loop in TypeScript and Python.",{},{"id":392,"data":976,"type":226,"tunes":978},{"text":977},"But its strategic status changed. OpenAI now labels the Agents SDK feature complete: maintenance, security fixes, critical bug fixes, and compatibility work continue, but major new features are not planned. OpenAI recommends the Agents API for new applications.",{},{"id":397,"data":980,"type":226,"tunes":982},{"text":981},"That does not mean an existing SDK application should be rewritten immediately. It means the architecture should stop assuming that the SDK is where the next major agent-runtime capabilities will land.",{},{"id":402,"data":984,"type":234,"tunes":987},{"body":985,"title":986,"variant":241},"OpenAI has not described the Agents SDK as unsupported. Existing applications can continue to use it, and maintenance, security, critical bug fixes, and compatibility work continue. The important change is that major new features are not planned and new applications are directed to the Agents API.","Do not translate “feature complete” into “deprecated”",{},{"id":408,"data":989,"type":42,"tunes":991},{"text":990,"level":219},"Where the Codex SDK fits",{},{"id":413,"data":993,"type":226,"tunes":995},{"text":994},"The current choice is not a simple three-way fork. OpenAI's runtime overview includes the Codex SDK as the option for running the Codex harness in infrastructure you operate. That is architecturally different from both the hosted Agents API and the Agents SDK.",{},{"id":418,"data":997,"type":226,"tunes":999},{"text":998},"If your real requirement is “I want the Codex harness, but I need to operate it myself,” the Codex SDK is the surface to evaluate. If your requirement is “I want to own the loop around model calls,” evaluate Responses. If your requirement is “I already have a working Agents SDK application,” the existing SDK can remain valid while you plan against its maintenance status.",{},{"id":423,"data":1001,"type":42,"tunes":1003},{"text":1002,"level":219},"The Runtime Ownership Test",{},{"id":428,"data":1005,"type":226,"tunes":1007},{"text":1006},"A useful architecture decision starts by deciding what your team must own. Score each requirement as either must control, prefer to control, or prefer managed.",{},{"id":433,"data":1009,"type":476,"tunes":1040},{"rows":1010,"title":1032,"layout":304,"columns":1033},[1011,1014,1017,1020,1023,1026,1029],{"id":437,"label":1012,"values":1013},"Agent loop",[440,440,440],{"id":442,"label":1015,"values":1016},"Durable sessions",[440,440,440],{"id":446,"label":1018,"values":1019},"Harness runtime",[440,440,440],{"id":450,"label":1021,"values":1022},"Execution environment",[440,440,440],{"id":454,"label":1024,"values":1025},"Orchestration semantics",[440,440,440],{"id":458,"label":1027,"values":1028},"Provider \u002F transport flexibility",[440,440,440],{"id":462,"label":1030,"values":1031},"Operational burden",[440,440,440],"Runtime Ownership Test",[1034,1036,1038],{"id":468,"label":1035},"Decision",{"id":471,"label":1037},"If you prefer managed",{"id":474,"label":1039},"If you require control",{},{"id":479,"data":1042,"type":42,"tunes":1044},{"text":1043,"level":219},"A decision tree for new systems",{},{"id":484,"data":1046,"type":510,"tunes":1070},{"steps":1047,"title":1069,"orientation":509},[1048,1051,1054,1057,1060,1063,1066],{"label":1049,"description":1050},"1. Is this a new agent application?","If no, do not migrate solely because a newer surface exists. Evaluate the current application's actual constraints first.",{"label":1052,"description":1053},"2. Do you want a managed long-running agent harness?","If yes, start with the Agents API as OpenAI's recommended path for new agent applications.",{"label":1055,"description":1056},"3. Do you need the Codex harness but must operate it yourself?","Evaluate the Codex SDK rather than rebuilding harness behaviour on top of the Agents SDK.",{"label":1058,"description":1059},"4. Do you need to own the agent loop and state model?","Use the Responses API as the lower-level platform primitive and build the loop around it.",{"label":1061,"description":1062},"5. Are you already on the Agents SDK?","Continue if it meets requirements; major new features are not planned, so treat future platform adoption as an explicit roadmap decision.",{"label":1064,"description":1065},"6. Is a required capability missing from the Agents API?","OpenAI explicitly allows the Agents SDK as a short-term option for new applications that need unsupported capabilities.",{"label":1067,"description":1068},"7. Validate with a production-shaped spike","Test tools, environment, approvals, latency, observability, failure recovery, and lifecycle before locking the architecture.","Choose the runtime by the control boundary",{},{"id":513,"data":1072,"type":42,"tunes":1074},{"text":1073,"level":219},"What should not drive the decision",{},{"id":518,"data":1076,"type":304,"tunes":1102},{"content":1077,"stretched":43,"withHeadings":14},[1078,1082,1086,1090,1094,1098],[1079,1080,1081],"Weak decision rule","Why it fails","Better question",[1083,1084,1085],"“The newest API must be best.”","Newer can be strategically preferred while still lacking a capability you need.","Which runtime responsibilities should be managed versus application-owned?",[1087,1088,1089],"“We already know the SDK.”","Team familiarity can preserve an architecture whose roadmap has changed.","What is the cost of staying versus moving over the next product cycle?",[1091,1092,1093],"“Managed means no infrastructure.”","Agents API can still use self-hosted environments and your application still owns product logic.","Which infrastructure layer is actually being delegated?",[1095,1096,1097],"“Responses is only for simple calls.”","Responses provides built-in tools and stateful primitives; it can be the foundation of custom agent loops.","Do we need the platform to own the harness, or only model\u002Ftool primitives?",[1099,1100,1101],"“Feature complete means we must migrate now.”","The SDK remains maintained for existing applications.","What concrete future requirement is blocked by staying?",{},{"id":547,"data":1104,"type":42,"tunes":1106},{"text":1105,"level":219},"Migration is an architectural change, not an import rename",{},{"id":552,"data":1108,"type":226,"tunes":1110},{"text":1109},"Moving from the Agents SDK to the Agents API changes ownership. In the SDK, the loop runs in your application. In the Agents API, OpenAI runs the harness and session while your application integrates through tasks, events, tools, and environment boundaries.",{},{"id":557,"data":1112,"type":226,"tunes":1114},{"text":1113},"A real migration plan therefore needs to map session state, custom orchestration, handoffs, tool execution, approvals, storage, tracing, retries, failure recovery, environment lifecycle, and any provider-specific abstractions. Code volume may fall while operational assumptions change.",{},{"id":562,"data":1116,"type":42,"tunes":1118},{"text":1117,"level":218},"The migration inventory",{},{"id":567,"data":1120,"type":343,"tunes":1133},{"meta":1121,"items":1122,"style":342},{},[1123,1124,1125,1126,1127,1128,1129,1130,1131,1132],"Agent definitions and instruction ownership.","Tool definitions and where each tool executes.","Handoffs, manager\u002Fspecialist patterns, and subagent behaviour.","Session identifiers, conversation state, resumability, and history retention.","Human approvals and interruption semantics.","Custom context trimming or compaction logic.","Tracing, evals, observability, and production debugging.","Self-hosted files, containers, private-network access, or other execution dependencies.","Provider abstraction or non-OpenAI model dependencies.","Retry, timeout, idempotency, recovery, and lifecycle assumptions.",{},{"id":583,"data":1135,"type":42,"tunes":1137},{"text":1136,"level":219},"Public beta changes the risk model",{},{"id":588,"data":1139,"type":226,"tunes":1141},{"text":1140},"The Agents API is the recommended direction for new agent applications, but it is also in public beta. Those facts are not contradictory. Strategic direction answers “where is the platform going?” Beta status answers “how much interface and operational change should I budget for?”",{},{"id":593,"data":1143,"type":226,"tunes":1145},{"text":1144},"For production systems, isolate the integration behind an application boundary. Keep domain state, permissions, audit data, and business rules outside vendor-specific session objects where possible. This makes it easier to absorb API evolution without turning the agent runtime into the source of truth for your entire product.",{},{"id":598,"data":1147,"type":42,"tunes":1149},{"text":1148,"level":219},"A practical default architecture",{},{"id":603,"data":1151,"type":226,"tunes":1153},{"text":1152},"For many new OpenAI-native applications, a reasonable 2026 default is: Agents API for the managed harness and durable session, application-owned domain services and authorization, explicit function tools for business actions, and either OpenAI-hosted or self-hosted execution depending on data and compute requirements.",{},{"id":608,"data":1155,"type":226,"tunes":1157},{"text":1156},"That keeps the agent runtime powerful without making it the owner of business truth. The application still decides what a user may do, which data is authoritative, which actions require approval, and how results are validated.",{},{"id":613,"data":1159,"type":619,"tunes":1164},{"url":1160,"title":1161,"excerpt":1162,"ctaLabel":1163},"https:\u002F\u002Fstajic.de\u002Fblog\u002Fai-agent-reliability-why-the-final-answer-is-not-enough","AI Agent Reliability: Why the Final Answer Is Not Enough","A managed harness reduces operational burden, but reliability still requires traceable execution, explicit acceptance criteria and evaluation beyond the final answer.","Read the reliability article",{},{"id":622,"data":1166,"type":42,"tunes":1168},{"text":1167,"level":219},"What would change this answer?",{},{"id":627,"data":1170,"type":226,"tunes":1172},{"text":1171},"The recommendation changes if the Agents API adds or removes capabilities, exits beta with different contracts, changes environment or pricing boundaries, or introduces migration tooling that reduces ownership differences. It also changes if your application depends on provider portability, custom orchestration semantics, local-only execution, or a capability the hosted harness cannot support.",{},{"id":632,"data":1174,"type":226,"tunes":1176},{"text":1175},"For an existing Agents SDK application, the answer also changes with migration cost. If the system is stable, well evaluated, and not blocked by the SDK's feature-complete status, immediate migration may create more risk than value. If the product roadmap depends on capabilities landing only in the Agents API, delaying migration can create a different kind of debt.",{},{"id":637,"data":1178,"type":42,"tunes":1180},{"text":1179,"level":219},"Limitations",{},{"id":642,"data":1182,"type":226,"tunes":1184},{"text":1183},"This comparison focuses on runtime ownership and OpenAI's stated platform direction. It does not benchmark latency, quality, or total cost for a specific workload. Those properties depend on model choice, tool usage, environment, task length, caching, sandbox usage, and application architecture.",{},{"id":647,"data":1186,"type":226,"tunes":1188},{"text":1187},"The Agents API is also new enough that production experience is still accumulating. A design should therefore be validated with representative workloads rather than chosen solely from product positioning.",{},{"id":652,"data":1190,"type":42,"tunes":1192},{"text":1191,"level":219},"Conclusion",{},{"id":657,"data":1194,"type":226,"tunes":1196},{"text":1195},"The 2026 OpenAI agent decision is fundamentally about runtime ownership. Agents API means OpenAI owns more of the harness and durable-session machinery. Responses means your application owns the loop around platform primitives. The Agents SDK remains valid for existing systems but is no longer the default destination for major new agent-runtime features.",{},{"id":662,"data":1198,"type":226,"tunes":1200},{"text":1199},"For a new application, follow the platform direction unless a real requirement pushes you lower in the stack. Start with the Agents API, move to Responses when you need to own the loop, evaluate Codex SDK when you need the harness in your infrastructure, and keep the Agents SDK where existing investments or temporary capability gaps justify it.",{},{"id":667,"data":1202,"type":42,"tunes":1203},{"text":669,"level":219},{},{"id":672,"data":1205,"type":672,"tunes":1226},{"items":1206,"title":1225},[1207,1210,1213,1216,1219,1222],{"id":676,"answer":1208,"question":1209},"OpenAI currently recommends the Agents API for new agent applications. The Agents SDK is feature complete and remains supported for existing applications, with maintenance, security, critical bug fixes and compatibility work continuing.","Should I use the OpenAI Agents API or Agents SDK for a new project?",{"id":680,"answer":1211,"question":1212},"OpenAI describes it as feature complete, not as unsupported. Major new features are not planned, but maintenance, security fixes, critical bug fixes and compatibility work continue.","Is the Agents SDK deprecated?",{"id":684,"answer":1214,"question":1215},"Use Responses when your application should own the agent loop, state strategy, orchestration and continuation logic while still using OpenAI models and platform tools.","When should I use the Responses API instead of the Agents API?",{"id":688,"answer":1217,"question":1218},"No. The Agents API can use no execution environment, an OpenAI-hosted environment, or a self-hosted environment connected to the managed harness.","Does the Agents API require OpenAI-hosted compute?",{"id":692,"answer":1220,"question":1221},"OpenAI positions the Codex SDK for running the Codex harness in infrastructure you operate. It is the relevant option when you want the harness but not the hosted Agents API runtime.","Where does the Codex SDK fit?",{"id":696,"answer":1223,"question":1224},"Not automatically. Evaluate whether the current system is blocked by the SDK's feature-complete status, whether required capabilities exist in the Agents API, and whether the migration benefit exceeds the operational and architectural change.","Should an existing Agents SDK app migrate immediately?","OpenAI agent runtime choices in 2026",{},{"id":702,"data":1228,"type":42,"tunes":1230},{"text":1229,"level":219},"Glossary",{},{"id":707,"data":1232,"type":707,"tunes":1248},{"title":1233,"entries":1234},"Key runtime terms",[1235,1237,1239,1241,1243,1245],{"term":712,"anchor":446,"definition":1236},"The runtime loop and supporting machinery that coordinates model calls, tools, context, sessions and agent execution.",{"term":281,"anchor":715,"definition":1238},"OpenAI's managed API for durable cloud agents using a hosted Codex harness.",{"term":287,"anchor":718,"definition":1240},"OpenAI's lower-level API primitive for model responses, hosted tools and stateful interactions around which applications can build their own agent loop.",{"term":293,"anchor":721,"definition":1242},"OpenAI's open-source framework for running agent workflows in application code; feature complete as of September 2026.",{"term":299,"anchor":724,"definition":1244},"The runtime option OpenAI lists for running the Codex harness in infrastructure you operate.",{"term":1246,"anchor":728,"definition":1247},"Runtime ownership","The architectural boundary describing which parts of the agent loop, session state, execution environment and lifecycle are operated by the platform versus the application.",{},{"id":732,"data":1250,"type":42,"tunes":1252},{"text":1251,"level":219},"Primary sources and further reading",{},{"id":737,"data":1254,"type":744,"tunes":1259},{"link":739,"meta":1255},{"image":1256,"title":1257,"description":1258},{"url":440},"OpenAI — Introducing the Agents API","Launch announcement for the Agents API on 10 September 2026, describing the managed Codex harness and public beta.",{},{"id":747,"data":1261,"type":744,"tunes":1266},{"link":749,"meta":1262},{"image":1263,"title":1264,"description":1265},{"url":440},"OpenAI — Agents runtime overview","Current comparison of Agents API, Codex SDK and Responses API, including the support status of the Agents SDK.",{},{"id":756,"data":1268,"type":744,"tunes":1273},{"link":758,"meta":1269},{"image":1270,"title":1271,"description":1272},{"url":440},"OpenAI — Agents API overview","Documentation for durable cloud agents, sessions, orchestration, context compaction, recovery and environment choices.",{},{"id":765,"data":1275,"type":744,"tunes":1280},{"link":767,"meta":1276},{"image":1277,"title":1278,"description":1279},{"url":440},"OpenAI — Agents API architecture","Architecture boundary between the hosted harness, application server and no\u002Fopenai-hosted\u002Fself-hosted execution environments.",{},{"id":774,"data":1282,"type":744,"tunes":1286},{"link":776,"meta":1283},{"image":1284,"title":779,"description":1285},{"url":440},"Current Agents SDK support notice and explanation of the application-owned agent loop.",{},{"id":783,"data":1288,"type":744,"tunes":1293},{"link":785,"meta":1289},{"image":1290,"title":1291,"description":1292},{"url":440},"OpenAI — Migrate to the Responses API","Current Responses API positioning, built-in tools, stateful context and agentic primitives.",{},{"id":792,"data":1295,"type":220,"tunes":1296},{"title":839,"maxLevel":218,"minLevel":219},{},"2.31.6","OpenAI’s agent stack changed in September 2026. This architecture guide separates the Agents API, Agents SDK, Responses API, and Codex SDK by runtime ownership—so teams can choose the right control boundary instead of comparing product names.",{"lang":7,"title":208,"content":210,"contentJson":1300,"excerpt":796},{"time":212,"blocks":1301,"version":795},[1302,1305,1308,1311,1314,1317,1320,1323,1326,1329,1338,1341,1344,1347,1350,1353,1358,1361,1366,1369,1372,1375,1378,1381,1384,1387,1390,1393,1396,1399,1402,1405,1408,1430,1433,1444,1447,1457,1460,1463,1466,1469,1474,1477,1480,1483,1486,1489,1492,1495,1498,1501,1504,1507,1510,1513,1516,1519,1522,1525,1535,1538,1548,1551,1556,1561,1566,1571,1576,1581],{"id":215,"data":1303,"type":220,"tunes":1304},{"title":217,"maxLevel":218,"minLevel":219},{},{"id":223,"data":1306,"type":226,"tunes":1307},{"text":225},{},{"id":229,"data":1309,"type":234,"tunes":1310},{"body":231,"title":232,"variant":233},{},{"id":237,"data":1312,"type":234,"tunes":1313},{"body":239,"title":240,"variant":241},{},{"id":244,"data":1315,"type":234,"tunes":1316},{"body":246,"title":247,"variant":248},{},{"id":251,"data":1318,"type":42,"tunes":1319},{"text":253,"level":219},{},{"id":256,"data":1321,"type":226,"tunes":1322},{"text":258},{},{"id":261,"data":1324,"type":226,"tunes":1325},{"text":263},{},{"id":266,"data":1327,"type":42,"tunes":1328},{"text":268,"level":219},{},{"id":271,"data":1330,"type":304,"tunes":1337},{"content":1331,"stretched":43,"withHeadings":14},[1332,1333,1334,1335,1336],[275,276,277,278,279],[281,282,283,284,285],[287,288,289,290,291],[293,294,295,296,297],[299,300,301,302,303],{},{"id":307,"data":1339,"type":42,"tunes":1340},{"text":309,"level":219},{},{"id":312,"data":1342,"type":226,"tunes":1343},{"text":314},{},{"id":317,"data":1345,"type":226,"tunes":1346},{"text":319},{},{"id":322,"data":1348,"type":226,"tunes":1349},{"text":324},{},{"id":327,"data":1351,"type":42,"tunes":1352},{"text":329,"level":218},{},{"id":332,"data":1354,"type":343,"tunes":1357},{"meta":1355,"items":1356,"style":342},{},[336,337,338,339,340,341],{},{"id":346,"data":1359,"type":42,"tunes":1360},{"text":348,"level":218},{},{"id":351,"data":1362,"type":343,"tunes":1365},{"meta":1363,"items":1364,"style":342},{},[355,356,357,358,359],{},{"id":362,"data":1367,"type":42,"tunes":1368},{"text":364,"level":219},{},{"id":367,"data":1370,"type":226,"tunes":1371},{"text":369},{},{"id":372,"data":1373,"type":226,"tunes":1374},{"text":374},{},{"id":377,"data":1376,"type":226,"tunes":1377},{"text":379},{},{"id":382,"data":1379,"type":42,"tunes":1380},{"text":384,"level":219},{},{"id":387,"data":1382,"type":226,"tunes":1383},{"text":389},{},{"id":392,"data":1385,"type":226,"tunes":1386},{"text":394},{},{"id":397,"data":1388,"type":226,"tunes":1389},{"text":399},{},{"id":402,"data":1391,"type":234,"tunes":1392},{"body":404,"title":405,"variant":241},{},{"id":408,"data":1394,"type":42,"tunes":1395},{"text":410,"level":219},{},{"id":413,"data":1397,"type":226,"tunes":1398},{"text":415},{},{"id":418,"data":1400,"type":226,"tunes":1401},{"text":420},{},{"id":423,"data":1403,"type":42,"tunes":1404},{"text":425,"level":219},{},{"id":428,"data":1406,"type":226,"tunes":1407},{"text":430},{},{"id":433,"data":1409,"type":476,"tunes":1429},{"rows":1410,"title":465,"layout":304,"columns":1425},[1411,1413,1415,1417,1419,1421,1423],{"id":437,"label":438,"values":1412},[440,440,440],{"id":442,"label":443,"values":1414},[440,440,440],{"id":446,"label":447,"values":1416},[440,440,440],{"id":450,"label":451,"values":1418},[440,440,440],{"id":454,"label":455,"values":1420},[440,440,440],{"id":458,"label":459,"values":1422},[440,440,440],{"id":462,"label":463,"values":1424},[440,440,440],[1426,1427,1428],{"id":468,"label":469},{"id":471,"label":472},{"id":474,"label":475},{},{"id":479,"data":1431,"type":42,"tunes":1432},{"text":481,"level":219},{},{"id":484,"data":1434,"type":510,"tunes":1443},{"steps":1435,"title":508,"orientation":509},[1436,1437,1438,1439,1440,1441,1442],{"label":488,"description":489},{"label":491,"description":492},{"label":494,"description":495},{"label":497,"description":498},{"label":500,"description":501},{"label":503,"description":504},{"label":506,"description":507},{},{"id":513,"data":1445,"type":42,"tunes":1446},{"text":515,"level":219},{},{"id":518,"data":1448,"type":304,"tunes":1456},{"content":1449,"stretched":43,"withHeadings":14},[1450,1451,1452,1453,1454,1455],[522,523,524],[526,527,528],[530,531,532],[534,535,536],[538,539,540],[542,543,544],{},{"id":547,"data":1458,"type":42,"tunes":1459},{"text":549,"level":219},{},{"id":552,"data":1461,"type":226,"tunes":1462},{"text":554},{},{"id":557,"data":1464,"type":226,"tunes":1465},{"text":559},{},{"id":562,"data":1467,"type":42,"tunes":1468},{"text":564,"level":218},{},{"id":567,"data":1470,"type":343,"tunes":1473},{"meta":1471,"items":1472,"style":342},{},[571,572,573,574,575,576,577,578,579,580],{},{"id":583,"data":1475,"type":42,"tunes":1476},{"text":585,"level":219},{},{"id":588,"data":1478,"type":226,"tunes":1479},{"text":590},{},{"id":593,"data":1481,"type":226,"tunes":1482},{"text":595},{},{"id":598,"data":1484,"type":42,"tunes":1485},{"text":600,"level":219},{},{"id":603,"data":1487,"type":226,"tunes":1488},{"text":605},{},{"id":608,"data":1490,"type":226,"tunes":1491},{"text":610},{},{"id":613,"data":1493,"type":619,"tunes":1494},{"url":615,"title":616,"excerpt":617,"ctaLabel":618},{},{"id":622,"data":1496,"type":42,"tunes":1497},{"text":624,"level":219},{},{"id":627,"data":1499,"type":226,"tunes":1500},{"text":629},{},{"id":632,"data":1502,"type":226,"tunes":1503},{"text":634},{},{"id":637,"data":1505,"type":42,"tunes":1506},{"text":639,"level":219},{},{"id":642,"data":1508,"type":226,"tunes":1509},{"text":644},{},{"id":647,"data":1511,"type":226,"tunes":1512},{"text":649},{},{"id":652,"data":1514,"type":42,"tunes":1515},{"text":654,"level":219},{},{"id":657,"data":1517,"type":226,"tunes":1518},{"text":659},{},{"id":662,"data":1520,"type":226,"tunes":1521},{"text":664},{},{"id":667,"data":1523,"type":42,"tunes":1524},{"text":669,"level":219},{},{"id":672,"data":1526,"type":672,"tunes":1534},{"items":1527,"title":699},[1528,1529,1530,1531,1532,1533],{"id":676,"answer":677,"question":678},{"id":680,"answer":681,"question":682},{"id":684,"answer":685,"question":686},{"id":688,"answer":689,"question":690},{"id":692,"answer":693,"question":694},{"id":696,"answer":697,"question":698},{},{"id":702,"data":1536,"type":42,"tunes":1537},{"text":704,"level":219},{},{"id":707,"data":1539,"type":707,"tunes":1547},{"title":709,"entries":1540},[1541,1542,1543,1544,1545,1546],{"term":712,"anchor":446,"definition":713},{"term":281,"anchor":715,"definition":716},{"term":287,"anchor":718,"definition":719},{"term":293,"anchor":721,"definition":722},{"term":299,"anchor":724,"definition":725},{"term":727,"anchor":728,"definition":729},{},{"id":732,"data":1549,"type":42,"tunes":1550},{"text":734,"level":219},{},{"id":737,"data":1552,"type":744,"tunes":1555},{"link":739,"meta":1553},{"image":1554,"title":742,"description":743},{"url":440},{},{"id":747,"data":1557,"type":744,"tunes":1560},{"link":749,"meta":1558},{"image":1559,"title":752,"description":753},{"url":440},{},{"id":756,"data":1562,"type":744,"tunes":1565},{"link":758,"meta":1563},{"image":1564,"title":761,"description":762},{"url":440},{},{"id":765,"data":1567,"type":744,"tunes":1570},{"link":767,"meta":1568},{"image":1569,"title":770,"description":771},{"url":440},{},{"id":774,"data":1572,"type":744,"tunes":1575},{"link":776,"meta":1573},{"image":1574,"title":779,"description":780},{"url":440},{},{"id":783,"data":1577,"type":744,"tunes":1580},{"link":785,"meta":1578},{"image":1579,"title":788,"description":789},{"url":440},{},{"id":792,"data":1582,"type":220,"tunes":1583},{"title":217,"maxLevel":218,"minLevel":219},{},"Post erfolgreich abgerufen",{"items":1586,"source":1615,"manualIds":1616,"manualMatchedIds":1617},[1587,1594,1601,1608],{"id":1588,"slug":1589,"title":1590,"excerpt":1591,"featuredImage":1592,"publishedAt":1593},"382","a-practical-monorepo-architecture-next-js-platform-admin-fastify-api-prisma-and-nginx","Un'Architettura Monorepo Pratica con Next.js, Fastify, Prisma e NGINX","Esplora un'architettura monorepo pratica che utilizza Next.js, Fastify, Prisma e NGINX, evidenziando l'integrazione e il flusso di lavoro nel mondo reale.","\u002Fuploads\u002F2026\u002F01\u002Fa-practical-monorepo-architecture-next-js-platform-admin-fastify-api-prisma-and-nginx-1769885526116-q1100n.webp","2026-01-31T08:18:00.000Z",{"id":1595,"slug":1596,"title":1597,"excerpt":1598,"featuredImage":1599,"publishedAt":1600},"476","mcp-vs-a2a-vs-ucp-vs-ap2-vs-a2ui-the-agent-protocol-stack-explained","MCP vs A2A vs UCP vs AP2 vs A2UI: Lo stack di protocolli degli agenti spiegato","MCP, A2A, UCP, AP2 e A2UI sono spesso presentati come standard per agenti concorrenti. Per lo più risolvono problemi di interoperabilità diversi. Questa guida mappa ciascun protocollo sul confine che effettivamente standardizza—e mostra come possano lavorare insieme in un unico sistema di produzione.","\u002Fuploads\u002F2026\u002F09\u002Fmcp-vs-a2a-vs-ucp-vs-ap2-vs-a2ui-the-agent-protocol-stack-explained-1790352625869-2ezle0.webp","2026-09-25T12:09:00.000Z",{"id":1602,"slug":1603,"title":1604,"excerpt":1605,"featuredImage":1606,"publishedAt":1607},"478","what-is-rag-the-simplest-explanation-of-how-it-works","Cos'è il RAG? La spiegazione più semplice di come funziona","RAG sembra complicato, ma l'idea è semplice: prima che un'IA risponda, cerca prima informazioni utili da una fonte di conoscenza e fornisce tali informazioni al modello linguistico. Questa guida spiega RAG, LLM, stato, memoria e strumenti utilizzando un semplice modello mentale.","\u002Fuploads\u002F2026\u002F09\u002Fwhat-is-rag-the-simplest-explanation-of-how-it-works-1790377492124-khjagt.webp","2026-09-25T19:03:00.000Z",{"id":1609,"slug":1610,"title":1611,"excerpt":1612,"featuredImage":1613,"publishedAt":1614},"381","enterprise-grade-multi-tenant-architecture-for-an-international-platform","Architettura Multi-Tenant di Livello Enterprise per una Piattaforma Internazionale","Loving Rocks è una piattaforma per matrimoni di livello enterprise progettata con una vera architettura multi-tenant, database isolati per tenant e internazionalizzazione integrata per scalabilità globale, sicurezza e stabilità operativa a lungo termine.","\u002Fuploads\u002F2026\u002F01\u002Fenterprise-grade-multi-tenant-architecture-for-an-international-platform-1769789121298-b6v7ak.webp","2026-01-30T12:04:00.000Z","fallback",[],[]]