{"id":6403,"date":"2026-09-14T16:54:26","date_gmt":"2026-09-14T07:54:26","guid":{"rendered":"https:\/\/route-zero.com\/recruit\/?post_type=route&#038;p=6403"},"modified":"2026-10-02T16:56:22","modified_gmt":"2026-10-02T07:56:22","slug":"openai-agents-api-basics","status":"publish","type":"route","link":"https:\/\/route-zero.com\/recruit\/route\/6403\/","title":{"rendered":"OpenAI Agents API\u3068\u306f\uff1f\u30af\u30e9\u30a6\u30c9Agent\u3092\u52d5\u304b\u3059\u57fa\u672c"},"content":{"rendered":"<p>OpenAI Agents API\u306f\u3001Agent\u306e\u5b9f\u884c\u30eb\u30fc\u30d7\u3060\u3051\u3067\u306a\u304f\u3001Session\u3001context\u7ba1\u7406\u3001\u56de\u5fa9\u3001\u5fc5\u8981\u306b\u5fdc\u3058\u305f\u5b9f\u884c\u74b0\u5883\u307e\u3067OpenAI\u5074\u3067\u7ba1\u7406\u3059\u308b\u30af\u30e9\u30a6\u30c9Agent\u5411\u3051API\u3067\u3059\u30022026\u5e749\u670810\u65e5\u306bpublic beta\u3068\u3057\u3066\u516c\u958b\u3055\u308c\u307e\u3057\u305f\u3002\u307e\u305a\u306fAgents SDK\u3068\u306e\u9055\u3044\u3092\u62bc\u3055\u3048\u308b\u3068\u3001\u3069\u3061\u3089\u3092\u4f7f\u3046\u3079\u304d\u304b\u5224\u65ad\u3057\u3084\u3059\u304f\u306a\u308a\u307e\u3059\u3002<\/p>\n<h2>\u307e\u305a\u7d50\u8ad6\uff1aAgents API\u3068Agents SDK\u306f\u7ba1\u7406\u3059\u308b\u5834\u6240\u304c\u9055\u3046<\/h2>\n<table>\n<thead>\n<tr>\n<th>\u6bd4\u8f03\u70b9<\/th>\n<th>Agents API<\/th>\n<th>Agents SDK<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>Agent harness<\/td>\n<td>OpenAI\u304c\u7ba1\u7406<\/td>\n<td>\u81ea\u5206\u306e\u30a2\u30d7\u30ea\u5074\u3067\u5b9f\u884c<\/td>\n<\/tr>\n<tr>\n<td>Session<\/td>\n<td>durable session\u3092API\u3067\u7ba1\u7406<\/td>\n<td>\u30a2\u30d7\u30ea\u5074\u3067\u5b9f\u884c\u72b6\u614b\u3092\u8a2d\u8a08<\/td>\n<\/tr>\n<tr>\n<td>\u5b9f\u884c\u74b0\u5883<\/td>\n<td>OpenAI-hosted sandbox\u306a\u3069\u3092\u63a5\u7d9a\u53ef\u80fd<\/td>\n<td>SDK\u5074\u3067sandbox\u3084\u5b9f\u884c\u74b0\u5883\u3092\u7d44\u307f\u5408\u308f\u305b\u308b<\/td>\n<\/tr>\n<tr>\n<td>\u5411\u304f\u30b1\u30fc\u30b9<\/td>\n<td>\u9577\u6642\u9593\u30fb\u7d99\u7d9a\u30fb\u30af\u30e9\u30a6\u30c9\u5b9f\u884c\u3092\u4efb\u305b\u305f\u3044<\/td>\n<td>\u5b9f\u884c\u30eb\u30fc\u30d7\u3084\u30a4\u30f3\u30d5\u30e9\u3092\u7d30\u304b\u304f\u5236\u5fa1\u3057\u305f\u3044<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>Agents API\u306f\u300cmodel\u3092\u547c\u3076API\u300d\u3060\u3051\u3067\u306f\u3042\u308a\u307e\u305b\u3093\u3002OpenAI\u306e\u73fe\u884c\u30c9\u30ad\u30e5\u30e1\u30f3\u30c8\u3067\u306f\u3001Codex harness\u304cSession\u3001orchestration\u3001context compaction\u3001recovery\u3092\u7ba1\u7406\u3057\u3001\u5fc5\u8981\u306a\u3089Agent\u304c\u30d5\u30a1\u30a4\u30eb\u3084\u30b3\u30de\u30f3\u30c9\u3092\u6271\u3046Environment\u3082\u63a5\u7d9a\u3067\u304d\u307e\u3059\u3002<\/p>\n<hr>\n<h2>Agents API\u3092\u69cb\u6210\u3059\u308b4\u3064\u306e\u8981\u7d20<\/h2>\n<blockquote>\n<p><strong>\u7528\u8a9e\u89e3\u8aac\uff1aAgent<\/strong><br \/>model\u3001instructions\u3001tools\u3001MCP servers\u306a\u3069\u3001Agent\u304c\u3069\u3046\u52d5\u304f\u304b\u3092\u5b9a\u7fa9\u3059\u308b\u5358\u4f4d\u3067\u3059\u3002<\/p>\n<\/blockquote>\n<blockquote>\n<p><strong>\u7528\u8a9e\u89e3\u8aac\uff1aEnvironment<\/strong><br \/>Agent\u304c\u30d5\u30a1\u30a4\u30eb\u3092\u6271\u3063\u305f\u308a\u30b3\u30de\u30f3\u30c9\u3092\u5b9f\u884c\u3057\u305f\u308a\u3059\u308b\u5834\u6240\u3067\u3059\u3002\u51e6\u7406\u306bcompute\u304c\u4e0d\u8981\u306a\u3089Environment\u3092\u6301\u305f\u306a\u3044\u69cb\u6210\u3082\u9078\u3079\u307e\u3059\u3002<\/p>\n<\/blockquote>\n<blockquote>\n<p><strong>\u7528\u8a9e\u89e3\u8aac\uff1aSession<\/strong><br \/>Agent\u8a2d\u5b9a\u3001\u4f1a\u8a71\u3001\u4fdd\u5b58\u3055\u308c\u305f\u4f5c\u696d\u3092\u6642\u9593\u3092\u307e\u305f\u3044\u3067\u7d99\u7d9a\u3059\u308bdurable\u306a\u5b9f\u884c\u5358\u4f4d\u3067\u3059\u3002<\/p>\n<\/blockquote>\n<blockquote>\n<p><strong>\u7528\u8a9e\u89e3\u8aac\uff1aEvents \/ items<\/strong><br \/>Session\u3078\u306e\u5165\u529b\u3084\u3001Agent\u304c\u51e6\u7406\u4e2d\u306b\u751f\u6210\u3059\u308b\u9032\u6357\u30fb\u7d50\u679c\u3092\u8ffd\u3046\u305f\u3081\u306e\u60c5\u5831\u3067\u3059\u3002streaming\u3084webhook\u3067\u72b6\u614b\u5909\u5316\u3092\u53d7\u3051\u53d6\u308c\u307e\u3059\u3002<\/p>\n<\/blockquote>\n<hr>\n<h2>\u6700\u5c0f\u69cb\u6210\u3067\u306fSession\u3092\u4f5c\u3063\u3066task\u3092\u6e21\u3059<\/h2>\n<p>\u73fe\u884cQuickstart\u3067\u306fSDK\u306ebeta.agents namespace\u304b\u3089Session\u3092\u4f5c\u6210\u3057\u307e\u3059\u3002OpenAI-hosted Environment\u3092\u6307\u5b9a\u3059\u308b\u3068\u3001Agent\u7528\u306esandbox\u3082OpenAI\u5074\u3067\u7528\u610f\u3067\u304d\u307e\u3059\u3002API key\u306fAgent\u306esandbox\u5185\u3078\u7f6e\u304b\u305a\u3001\u30a2\u30d7\u30ea\u5074\u3067\u4fdd\u6301\u3057\u307e\u3059\u3002<\/p>\n<pre><code>from openai import OpenAI\r\n\r\nwith OpenAI() as client:\r\n    with client.beta.agents.sessions.create(\r\n        agent={\r\n            &quot;model&quot;: &quot;gpt-6-astra&quot;,\r\n            &quot;instructions&quot;: &quot;\u5909\u66f4\u524d\u306b\u5bfe\u8c61\u3092\u78ba\u8a8d\u3057\u3001\u5b9f\u884c\u7d50\u679c\u3092\u5831\u544a\u3059\u308b&quot;,\r\n        },\r\n        environment={&quot;type&quot;: &quot;openai_hosted&quot;},\r\n        input=&quot;sample.txt\u3092\u4f5c\u6210\u3057\u3001\u5185\u5bb9\u3092\u78ba\u8a8d\u3057\u3066\u7d50\u679c\u3092\u5831\u544a\u3057\u3066&quot;,\r\n        stream=True,\r\n    ) as events:\r\n        for event in events:\r\n            print(event.type)<\/code><\/pre>\n<p>cURL\u3067\u76f4\u63a5\u547c\u3076\u5834\u5408\u306f\u3001public beta\u306e\u73fe\u884c\u4ed5\u69d8\u3068\u3057\u3066OpenAI-Beta: agents=v1 header\u304c\u5fc5\u8981\u3067\u3059\u3002\u516c\u5f0fSDK\u306f\u3053\u306ebeta header\u3092\u4ed8\u4e0e\u3057\u307e\u3059\u3002Session\u64cd\u4f5c\u306b\u306fAgents\u7528\u306eread\/write\u6a29\u9650\u306b\u52a0\u3048\u3001model\u63a8\u8ad6\u7528\u306eResponses\u6a29\u9650\u3082\u5fc5\u8981\u306b\u306a\u308b\u305f\u3081\u3001\u6700\u5c0f\u6a29\u9650\u3067API key\u3092\u767a\u884c\u3057\u307e\u3059\u3002<\/p>\n<hr>\n<h2>Session\u3092\u7d99\u7d9a\u3059\u308b\u3068\u3001\u540c\u3058\u4f5c\u696d\u3092\u9014\u4e2d\u304b\u3089\u518d\u958b\u3067\u304d\u308b<\/h2>\n<p>Session\u306f1\u56de\u306eprompt\u3067\u4f7f\u3044\u6368\u3066\u308b\u3082\u306e\u3067\u306f\u3042\u308a\u307e\u305b\u3093\u3002session_id\u3092\u30a2\u30d7\u30ea\u5074\u3067\u4fdd\u6301\u3057\u3001\u540c\u3058Session\u3078\u6b21\u306e\u5165\u529b\u3092\u9001\u308b\u3068\u3001\u4f1a\u8a71\u3084\u4fdd\u5b58\u3055\u308c\u305f\u4f5c\u696d\u3092\u5f15\u304d\u7d99\u3044\u3067\u7d9a\u3051\u3089\u308c\u307e\u3059\u3002\u9577\u3044\u8abf\u67fb\u3001\u8907\u6570step\u306e\u958b\u767a\u3001\u9014\u4e2d\u6210\u679c\u7269\u3092\u6b8b\u3059\u51e6\u7406\u3068\u76f8\u6027\u304c\u3088\u3044\u8a2d\u8a08\u3067\u3059\u3002<\/p>\n<ul>\n<li>\u521d\u56detask\u3067Session\u3092\u4f5c\u308b<\/li>\n<li>streaming\u307e\u305f\u306fwebhook\u3067\u9032\u6357\u3092\u8ffd\u3046<\/li>\n<li>session_id\u3092\u30a2\u30d7\u30ea\u5074\u306e\u72b6\u614b\u3068\u7d10\u4ed8\u3051\u308b<\/li>\n<li>\u8ffd\u52a0\u6307\u793a\u306f\u540c\u3058Session\u3078\u9001\u308b<\/li>\n<li>\u4e0d\u8981\u306b\u306a\u3063\u305fSession\u306f\u904b\u7528\u30eb\u30fc\u30eb\u306b\u6cbf\u3063\u3066\u7d42\u4e86\u30fb\u524a\u9664\u3059\u308b<\/li>\n<\/ul>\n<h2>turn.completed\u3060\u3051\u3067\u300e\u5168\u90e8\u6210\u529f\u300f\u3068\u5224\u65ad\u3057\u306a\u3044<\/h2>\n<p>Agent\u51e6\u7406\u3067\u306f\u3001\u6700\u7d42turn\u304c\u5b8c\u4e86\u3057\u3066\u3082\u3001\u9014\u4e2d\u306eTool\u304c\u671f\u5f85\u3069\u304a\u308a\u6210\u529f\u3057\u305f\u3068\u306f\u9650\u308a\u307e\u305b\u3093\u3002\u516c\u5f0fQuickstart\u3067\u3082\u3001agent.session.turn.completed\u306fturn\u306e\u5b8c\u4e86\u3092\u793a\u3057\u307e\u3059\u304c\u3001\u3059\u3079\u3066\u306eTool\u6210\u529f\u3092\u4fdd\u8a3c\u3059\u308b\u3082\u306e\u3067\u306f\u306a\u3044\u3068\u8aac\u660e\u3055\u308c\u3066\u3044\u307e\u3059\u3002<\/p>\n<table>\n<thead>\n<tr>\n<th>\u898b\u308b\u3082\u306e<\/th>\n<th>\u78ba\u8a8d\u3059\u308b\u5185\u5bb9<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>turn event<\/td>\n<td>completed \/ failed \/ cancelled\u306e\u3069\u308c\u304b<\/td>\n<\/tr>\n<tr>\n<td>Tool\u7d50\u679c<\/td>\n<td>error\u3084\u671f\u5f85\u3057\u305foutput\u304c\u3042\u308b\u304b<\/td>\n<\/tr>\n<tr>\n<td>\u6210\u679c\u7269<\/td>\n<td>\u5fc5\u8981\u306afile\u3084\u5909\u66f4\u304c\u5b9f\u969b\u306b\u6b8b\u3063\u3066\u3044\u308b\u304b<\/td>\n<\/tr>\n<tr>\n<td>\u6700\u7d42\u56de\u7b54<\/td>\n<td>\u5b9f\u884c\u7d50\u679c\u3068Agent\u306e\u8aac\u660e\u304c\u4e00\u81f4\u3057\u3066\u3044\u308b\u304b<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>\u9577\u6642\u9593Agent\u307b\u3069\u3001Agent\u306e\u81ea\u5df1\u7533\u544a\u3060\u3051\u3067\u306f\u306a\u304f\u3001event\u3068\u6210\u679c\u7269\u3092\u5206\u3051\u3066\u78ba\u8a8d\u3059\u308b\u65b9\u304c\u904b\u7528\u3057\u3084\u3059\u304f\u306a\u308a\u307e\u3059\u3002<\/p>\n<h2>Environment\u306f\u300eAgent\u306bcompute\u304c\u5fc5\u8981\u304b\u300f\u3067\u6c7a\u3081\u308b<\/h2>\n<p>\u8cea\u554f\u56de\u7b54\u3084\u5916\u90e8Tool\u547c\u3073\u51fa\u3057\u3060\u3051\u306a\u3089\u3001Environment\u3092\u6301\u305f\u306a\u3044\u69cb\u6210\u3067\u3082\u59cb\u3081\u3089\u308c\u307e\u3059\u3002\u4e00\u65b9\u3001\u30d5\u30a1\u30a4\u30eb\u7de8\u96c6\u3001command\u5b9f\u884c\u3001package\u5229\u7528\u3001\u6210\u679c\u7269\u751f\u6210\u304c\u5fc5\u8981\u306a\u3089Environment\u3092\u63a5\u7d9a\u3057\u307e\u3059\u3002OpenAI-hosted sandbox\u3092\u4f7f\u3046\u3068\u3001Agent\u306e\u4f5c\u696d\u5834\u6240\u3082managed\u5074\u3078\u5bc4\u305b\u3089\u308c\u307e\u3059\u3002<\/p>\n<ul>\n<li>Tool\u3060\u3051\u3067\u5b8c\u7d50\u3059\u308b\uff1aEnvironment\u306a\u3057\u3092\u691c\u8a0e<\/li>\n<li>file\u3084command\u304c\u5fc5\u8981\uff1asandbox\u3092\u63a5\u7d9a<\/li>\n<li>\u793e\u5185\u74b0\u5883\u3078\u63a5\u7d9a\u3057\u305f\u3044\uff1a\u5b9f\u884c\u5883\u754c\u3068\u6a29\u9650\u3092\u5148\u306b\u5b9a\u7fa9<\/li>\n<li>\u79d8\u5bc6\u60c5\u5831\uff1aAgent\u306e\u4f5c\u696d\u9818\u57df\u3078\u4e0d\u7528\u610f\u306b\u8907\u88fd\u3057\u306a\u3044<\/li>\n<\/ul>\n<p>\uff08Codex\u305d\u306e\u3082\u306e\u306e\u5f79\u5272\u306b\u3064\u3044\u3066\u306f\u300e<a href=\"https:\/\/route-zero.com\/recruit\/route\/1726\/\">Copilot\u3068Codex\u306e\u9055\u3044\u3068\u4f7f\u3044\u5206\u305110\u9078\uff5cVS Code\u3067\u52b9\u7387\u5316\u3059\u308bAI\u958b\u767a\u30ac\u30a4\u30c9<\/a>\u300f\u3092\u3054\u53c2\u7167\u304f\u3060\u3055\u3044\uff09<\/p>\n<h2>Agents API\u3092\u9078\u3076\u304b\u8ff7\u3063\u305f\u3068\u304d\u306e\u5224\u65ad\u57fa\u6e96<\/h2>\n<table>\n<thead>\n<tr>\n<th>\u72b6\u6cc1<\/th>\n<th>\u5224\u65ad<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>Session\u7d99\u7d9a\u30fb\u56de\u5fa9\u30fb\u9577\u6642\u9593\u5b9f\u884c\u3092managed\u5074\u3078\u5bc4\u305b\u305f\u3044<\/td>\n<td>Agents API\u3092\u5148\u306b\u691c\u8a0e<\/td>\n<\/tr>\n<tr>\n<td>Agent loop\u3084runtime\u3092\u81ea\u5206\u306eprocess\u5185\u3067\u7d30\u304b\u304f\u5236\u5fa1\u3057\u305f\u3044<\/td>\n<td>Agents SDK\u3092\u5148\u306b\u691c\u8a0e<\/td>\n<\/tr>\n<tr>\n<td>file\/command\u4f5c\u696d\u304c\u306a\u3044<\/td>\n<td>Environment\u306a\u3057\u306eAgents API\u3082\u5019\u88dc<\/td>\n<\/tr>\n<tr>\n<td>beta\u5909\u66f4\u3092\u8a31\u5bb9\u3057\u306b\u304f\u3044\u672c\u756a\u8981\u4ef6<\/td>\n<td>\u4ed5\u69d8\u5909\u66f4\u30fb\u5236\u7d04\u3092\u78ba\u8a8d\u3057\u3001\u5c0f\u3055\u304f\u691c\u8a3c\u3057\u3066\u304b\u3089\u63a1\u7528<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>Agents API\u306f2026\u5e7410\u67082\u65e5\u6642\u70b9\u3067public beta\u3067\u3059\u3002\u52d5\u4f5c\u3084API surface\u304c\u5c06\u6765\u5909\u308f\u308b\u524d\u63d0\u3067\u3001beta header\u3001SDK version\u3001\u516c\u5f0fchangelog\u3092\u56fa\u5b9a\u3057\u3066\u691c\u8a3c\u3059\u308b\u65b9\u304c\u5b89\u5168\u3067\u3059\u3002<\/p>\n<p>\u6700\u521d\u306e\u691c\u8a3c\u3067\u306f\u30011\u3064\u306e\u5c0f\u3055\u306atask\u3092OpenAI-hosted Session\u3067\u5b9f\u884c\u3057\u3001streaming event\u3001\u6210\u679c\u7269\u3001\u6700\u7d42\u56de\u7b54\u306e3\u70b9\u304c\u4e00\u81f4\u3059\u308b\u304b\u3092\u78ba\u8a8d\u3057\u3066\u307f\u3066\u304f\u3060\u3055\u3044\u3002<\/p>\n<h2>\u3088\u304f\u3042\u308b\u8cea\u554f<\/h2>\n<h3>Agents API\u3092\u4f7f\u3046\u3068Agents SDK\u306f\u4e0d\u8981\u3067\u3059\u304b\uff1f<\/h3>\n<p>\u7528\u9014\u304c\u7570\u306a\u308a\u307e\u3059\u3002managed\u306aCodex harness\u3084durable session\u3092\u4f7f\u3044\u305f\u3044\u5834\u5408\u306fAgents API\u304c\u5411\u304d\u307e\u3059\u3002\u81ea\u5206\u306e\u30a2\u30d7\u30eaprocess\u3067Agent loop\u3092\u5b9f\u884c\u30fb\u5236\u5fa1\u3057\u305f\u3044\u5834\u5408\u306fAgents SDK\u304c\u5411\u304d\u307e\u3059\u3002<\/p>\n<h3>\u5fc5\u305aOpenAI-hosted sandbox\u304c\u5fc5\u8981\u3067\u3059\u304b\uff1f<\/h3>\n<p>\u3044\u3044\u3048\u3002\u516c\u5f0fQuickstart\u3067\u306f\u3001command\u5b9f\u884c\u3084file\u4f5c\u696d\u304c\u4e0d\u8981\u306aAgent\u306fenvironment.type\u3092none\u306b\u3067\u304d\u308b\u3068\u6848\u5185\u3055\u308c\u3066\u3044\u307e\u3059\u3002\u5fc5\u8981\u306acompute\u5883\u754c\u306b\u5408\u308f\u305b\u3066\u9078\u3073\u307e\u3059\u3002<\/p>\n<h3>Session\u304ccompleted\u306a\u3089Tool\u3082\u5168\u90e8\u6210\u529f\u3067\u3059\u304b\uff1f<\/h3>\n<p>\u4fdd\u8a3c\u3055\u308c\u307e\u305b\u3093\u3002turn\u306e\u5b8c\u4e86event\u3068\u3001\u5404Tool\u7d50\u679c\u30fb\u6210\u679c\u7269\u3092\u5206\u3051\u3066\u78ba\u8a8d\u3057\u3066\u304f\u3060\u3055\u3044\u3002<\/p>\n","protected":false},"featured_media":6404,"template":"","meta":{"ssp_meta_title":"OpenAI Agents API\u3068\u306f\uff1f\u4f7f\u3044\u65b9\u3068Agents SDK\u3068\u306e\u9055\u3044","ssp_meta_description":"OpenAI Agents API\u306e\u57fa\u672c\u3092\u3001Agents SDK\u3068\u306e\u9055\u3044\u3001Session\u30fbEnvironment\u30fbEvent\u306e\u5f79\u5272\u3001\u6700\u5c0f\u5b9f\u884c\u4f8b\u3001\u904b\u7528\u6642\u306e\u78ba\u8a8d\u70b9\u307e\u3067\u5b9f\u52d9\u5411\u3051\u306b\u89e3\u8aac\u3057\u307e\u3059\u3002","ssp_meta_keyword":"OpenAI Agents API \u4f7f\u3044\u65b9,Agents API,OpenAI Agents API,Agents API Agents SDK \u9055\u3044,agent session,openai hosted sandbox,Codex harness","ssp_meta_canonical":""},"route_category":[8],"_links":{"self":[{"href":"https:\/\/route-zero.com\/recruit\/wp-json\/wp\/v2\/route\/6403"}],"collection":[{"href":"https:\/\/route-zero.com\/recruit\/wp-json\/wp\/v2\/route"}],"about":[{"href":"https:\/\/route-zero.com\/recruit\/wp-json\/wp\/v2\/types\/route"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/route-zero.com\/recruit\/wp-json\/wp\/v2\/media\/6404"}],"wp:attachment":[{"href":"https:\/\/route-zero.com\/recruit\/wp-json\/wp\/v2\/media?parent=6403"}],"wp:term":[{"taxonomy":"route_category","embeddable":true,"href":"https:\/\/route-zero.com\/recruit\/wp-json\/wp\/v2\/route_category?post=6403"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}