{ "archive_path": "archive/1789077959.379808", "base_url": "developers.openai.com/api/docs/guides/agents-api/overview", "basename": "overview", "bookmarked_date": "2026-09-10 22:05", "canonical": { "archive_org_path": "https://web.archive.org/web/developers.openai.com/api/docs/guides/agents-api/overview", "dom_path": "output.html", "favicon_path": "favicon.ico", "git_path": "git/", "google_favicon_path": "https://www.google.com/s2/favicons?domain=developers.openai.com", "headers_path": "headers.json", "htmltotext_path": "htmltotext.txt", "index_path": "index.html", "media_path": "media/", "mercury_path": "mercury/content.html", "pdf_path": "output.pdf", "readability_path": "readability/content.html", "screenshot_path": "screenshot.png", "singlefile_path": "singlefile.html", "warc_path": "warc/", "wget_path": "developers.openai.com/api/docs/guides/agents-api/overview.html" }, "domain": "developers.openai.com", "extension": "", "hash": "C2ZMNCXMKCCNPHDYSB5C", "history": { "archive_org": [], "dom": [], "favicon": [ { "cmd": [ "curl", "--silent", "--location", "--compressed", "--max-time", "120", "--output", "favicon.ico", "--user-agent", "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/118.0.0.0 Safari/537.36 ArchiveBox/0.7.4 (+https://github.com/ArchiveBox/ArchiveBox/) curl/curl 8.14.1 (x86_64-pc-linux-gnu)", "https://www.google.com/s2/favicons?domain=developers.openai.com" ], "cmd_version": "curl 8.14.1 (x86_64-pc-linux-gnu)", "end_ts": "2026-09-10T22:07:00.985875+00:00", "index_texts": null, "output": "favicon.ico", "pwd": "/data/archive/1789077959.379808", "schema": "ArchiveResult", "start_ts": "2026-09-10T22:07:00.562158+00:00", "status": "succeeded" } ], "git": [], "headers": [ { "cmd": [ "curl", "--silent", "--location", "--compressed", "--head", "--max-time", "120", "--user-agent", "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/118.0.0.0 Safari/537.36 ArchiveBox/0.7.4 (+https://github.com/ArchiveBox/ArchiveBox/) curl/curl 8.14.1 (x86_64-pc-linux-gnu)", "https://developers.openai.com/api/docs/guides/agents-api/overview" ], "cmd_version": "curl 8.14.1 (x86_64-pc-linux-gnu)", "end_ts": "2026-09-10T22:07:01.274507+00:00", "index_texts": null, "output": "headers.json", "pwd": "/data/archive/1789077959.379808", "schema": "ArchiveResult", "start_ts": "2026-09-10T22:07:00.994411+00:00", "status": "succeeded" } ], "htmltotext": [], "media": [], "mercury": [ { "cmd": [ "/app/node_modules/@postlight/parser/cli.js", "https://developers.openai.com/api/docs/guides/agents-api/overview" ], "cmd_version": "1.0.0", "end_ts": "2026-09-10T22:07:22.324541+00:00", "index_texts": null, "output": "mercury", "pwd": "/data/archive/1789077959.379808", "schema": "ArchiveResult", "start_ts": "2026-09-10T22:07:16.902470+00:00", "status": "succeeded" } ], "pdf": [], "readability": [ { "cmd": [ "/app/node_modules/readability-extractor/readability-extractor", "/tmp/tmps0o3pmbg", "https://developers.openai.com/api/docs/guides/agents-api/overview" ], "cmd_version": "0.0.11", "end_ts": "2026-09-10T22:07:16.894576+00:00", "index_texts": [ "The Agents API gives your application access to the Codex harness through an OpenAI-managed API.\nOpenAI manages sessions, orchestration, context compaction, and recovery while your application provides tools and chooses its execution environment.\nAgents can operate in a sandbox where they can execute code, edit files, connect to MCP servers, and produce artifacts.\n\nModel usage is billed at the selected model\u2019s API rates. OpenAI tools use their standard rates, and OpenAI-hosted sandboxes use standard container rates.\n\nTry these complete examples:\n\nCreate and run a directory-tree script in an OpenAI-hosted sandbox.\nCompare release notes with subagents and combine their findings into one answer.\n\nExplore complete applications:\n\nIncident response agent: investigate alerts and request approval for recovery actions.\nSlack bot: investigate requests using connected workplace tools.\nData analyst: answer warehouse questions with read-only SQL.\nGitHub issue investigator: reproduce reported bugs and share findings on GitHub.\nDocument reviewer: review documents with policy skills and specialist agents.\n\n\nThe Agents API is built around four main concepts:\n\nAgent: The model, instructions, tools, and MCP servers available to the agent.\nEnvironment: An optional sandbox or computer where the agent accesses files, loads skills, and runs commands.\nSession: A durable instance of an agent that works on tasks and responds to input.\nEvents and items: The inputs sent to an agent and the output produced during a session.\n\nA session from start to finish\nStart with an OpenAI-hosted sandbox in the quickstart:\n\nCreate a session. Configure the agent; OpenAI provisions its environment.\nGive it a task. User input starts a turn of work once the environment is ready.\nFollow progress. Stream output or use webhooks to learn when the agent finishes or needs input.\nContinue or steer. Send another task to the same session, or guide the agent during its current turn.\n\nWith an OpenAI-hosted session, your application sends input and receives events, while OpenAI runs the agent and provisions and manages its sandbox. See environment options for setup and limitations.\n\n\nThe managed Codex harness supports:\n\nRunning commands and code in a sandbox.\nApplying relevant skills and instructions.\nConnecting to external data through tools or MCP.\nSteering the agent while it works.\nSummarizing previous work to manage its context window.\nBreaking work into subtasks and delegating to subagents.\nResuming a session where it left off.\n\nCheck the quickstart prerequisites for API-key permissions and SDK setup. Configure these capabilities when you create a session:\nfrom openai import OpenAI\n\nclient = OpenAI()\n\nsession = client.beta.agents.sessions.create(\n agent={\n \"model\": \"gpt-6-astra\",\n \"instructions\": \"Use the OpenAI documentation MCP and web search to answer technical questions accurately. Delegate independent research tasks to subagents when useful.\",\n \"tools\": [\n {\"type\": \"programmatic_tool_calling\"},\n {\n \"type\": \"mcp\",\n \"server_label\": \"openai_docs\",\n \"transport\": {\n \"type\": \"http\",\n \"server_url\": \"https://developers.openai.com/mcp\",\n },\n },\n {\"type\": \"web_search\"},\n ],\n \"multi_agent\": {\"enabled\": True, \"max_concurrent_subagents\": 4},\n },\n environment={\n \"type\": \"self_hosted\",\n \"workspace_directory\": \"/workspace\",\n \"capability_directories\": [\"/workspace/capabilities/skills\"],\n },\n input=[\n {\n \"role\": \"user\",\n \"content\": [\n {\n \"type\": \"input_text\",\n \"text\": \"Research how to connect an MCP server to an OpenAI agent, check for recent updates, and summarize the recommended setup.\",\n }\n ],\n }\n ],\n)\nprint(session.id)\n\nFor a runtime comparison, see the Agents overview.\nThe Agents API retains session state so you can continue work across turns without\nrebuilding the conversation context. You can delete sessions and published\nartifacts when you no longer need them.\nThe Agents API currently supports data residency only in the United States and\ndoes not support Zero Data Retention (ZDR). Choosing a self-hosted sandbox does\nnot make the Agents API ZDR-eligible. See Data controls\nin the OpenAI platform\nfor details on data residency and retention." ], "output": "readability", "pwd": "/data/archive/1789077959.379808", "schema": "ArchiveResult", "start_ts": "2026-09-10T22:07:12.660381+00:00", "status": "succeeded" } ], "screenshot": [], "singlefile": [], "title": [ { "cmd": [ "curl", "--silent", "--location", "--compressed", "--max-time", "120", "--user-agent", "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/118.0.0.0 Safari/537.36 ArchiveBox/0.7.4 (+https://github.com/ArchiveBox/ArchiveBox/) curl/curl 8.14.1 (x86_64-pc-linux-gnu)", "https://developers.openai.com/api/docs/guides/agents-api/overview" ], "cmd_version": "curl 8.14.1 (x86_64-pc-linux-gnu)", "end_ts": "2026-09-10T22:07:12.653142+00:00", "index_texts": null, "output": "Agents API | OpenAI API", "pwd": "/data/archive/1789077959.379808", "schema": "ArchiveResult", "start_ts": "2026-09-10T22:07:12.551902+00:00", "status": "succeeded" } ], "wget": [ { "cmd": [ "wget", "--no-verbose", "--adjust-extension", "--convert-links", "--force-directories", "--backup-converted", "--span-hosts", "--no-parent", "-e", "robots=off", "--timeout=120", "--restrict-file-names=windows", "--warc-file=/data/archive/1789077959.379808/warc/1789078021", "--page-requisites", "--user-agent=Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/118.0.0.0 Safari/537.36 ArchiveBox/0.7.4 (+https://github.com/ArchiveBox/ArchiveBox/) wget/GNU Wget 1.21.3", "--compression=auto", "https://developers.openai.com/api/docs/guides/agents-api/overview" ], "cmd_version": "GNU Wget 1.21.3", "end_ts": "2026-09-10T22:07:12.542380+00:00", "index_texts": null, "output": "developers.openai.com/api/docs/guides/agents-api/overview.html", "pwd": "/data/archive/1789077959.379808", "schema": "ArchiveResult", "start_ts": "2026-09-10T22:07:01.284611+00:00", "status": "succeeded" } ] }, "icons": null, "is_archived": true, "is_static": false, "latest": { "archive_org": null, "dom": null, "favicon": "favicon.ico", "git": null, "media": null, "pdf": null, "screenshot": null, "singlefile": null, "title": "Agents API | OpenAI API", "warc": null, "wget": "developers.openai.com/api/docs/guides/agents-api/overview.html" }, "link_dir": "/data/archive/1789077959.379808", "newest_archive_date": "2026-09-10T22:07:16.902470+00:00", "num_failures": 0, "num_outputs": 6, "oldest_archive_date": "2026-09-10T22:07:00.562158+00:00", "path": "/api/docs/guides/agents-api/overview", "schema": "Link", "scheme": "https", "snapshot_id": "00e3fee5-1d7a-4fda-9334-7548934ee2d4", "sources": [ "/data/sources/1789077959-import.txt" ], "tags": null, "tags_str": "", "timestamp": "1789077959.379808", "title": "Agents API | OpenAI API", "updated": "2026-09-10T22:07:00.561527+00:00", "updated_date": "2026-09-10 22:07", "url": "https://developers.openai.com/api/docs/guides/agents-api/overview" }