{"id":6397,"date":"2026-07-01T14:25:48","date_gmt":"2026-07-01T05:25:48","guid":{"rendered":"https:\/\/route-zero.com\/recruit\/?post_type=route&p=6397"},"modified":"2026-10-01T14:26:01","modified_gmt":"2026-10-01T05:26:01","slug":"ai-agent-tracing-tool-handoff","status":"publish","type":"route","link":"https:\/\/route-zero.com\/recruit\/route\/6397\/","title":{"rendered":"AI\u30a8\u30fc\u30b8\u30a7\u30f3\u30c8\u306eTracing\u3068\u306f\uff1f\u5931\u6557\u539f\u56e0\u3092\u8ffd\u8de1\u3059\u308b\u65b9\u6cd5"},"content":{"rendered":"

AI\u30a8\u30fc\u30b8\u30a7\u30f3\u30c8\u304c\u300c\u6700\u7d42\u7d50\u679c\u306f\u8fd4\u3057\u305f\u3051\u308c\u3069\u3001\u9014\u4e2d\u3067\u4f55\u304c\u8d77\u304d\u305f\u306e\u304b\u5206\u304b\u3089\u306a\u3044\u300d\u72b6\u614b\u306b\u306a\u308b\u3068\u3001\u539f\u56e0\u8abf\u67fb\u304c\u96e3\u3057\u304f\u306a\u308a\u307e\u3059\u3002Tracing\u3067\u306f\u30011\u56de\u306eworkflow\u3092Trace\u3001\u305d\u306e\u4e2d\u306eTool Call\u3084Handoff\u306a\u3069\u3092Span\u3068\u3057\u3066\u8ffd\u3044\u3001\u3069\u306e\u6bb5\u968e\u3067\u6319\u52d5\u304c\u5909\u308f\u3063\u305f\u304b\u3092\u78ba\u8a8d\u3057\u307e\u3059\u3002<\/p>\n

\u307e\u305a\u78ba\u8a8d\uff1a\u75c7\u72b6\u3054\u3068\u306b\u898b\u308bSpan\u3092\u5909\u3048\u308b<\/h2>\n\n\n\n\n\n\n\n\n\n
\u75c7\u72b6<\/th>\n\u5148\u306b\u898b\u308b\u5bfe\u8c61<\/th>\n\u78ba\u8a8d\u30dd\u30a4\u30f3\u30c8<\/th>\n<\/tr>\n<\/thead>\n
Tool\u7d50\u679c\u304c\u4e0d\u6b63<\/td>\nTool span<\/td>\n\u5165\u529b\u30fb\u51fa\u529b\u30fberror<\/td>\n<\/tr>\n
\u5225Agent\u3078\u6e21\u3089\u306a\u3044<\/td>\nHandoff span<\/td>\n\u9077\u79fb\u5148\u30fb\u767a\u706b\u6761\u4ef6<\/td>\n<\/tr>\n
\u56de\u7b54\u304c\u9014\u4e2d\u3067\u6b62\u307e\u308b<\/td>\nGeneration \/ Agent span<\/td>\nmodel\u5fdc\u7b54\u30fb\u4f8b\u5916\u30fbguardrail<\/td>\n<\/tr>\n
\u5b89\u5168\u30c1\u30a7\u30c3\u30af\u3067\u6b62\u307e\u308b<\/td>\nGuardrail span<\/td>\ntripwire\u3084\u5224\u5b9a\u7d50\u679c<\/td>\n<\/tr>\n
\u5168\u4f53\u304c\u9045\u3044<\/td>\n\u5404Span\u306e\u6642\u9593<\/td>\n\u3069\u306eoperation\u304c\u6642\u9593\u3092\u4f7f\u3063\u305f\u304b<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

OpenAI Agents SDK\u306eTracing\u306f\u3001LLM\u751f\u6210\u3001Tool Call\u3001Handoff\u3001Guardrail\u3001\u30ab\u30b9\u30bf\u30e0\u30a4\u30d9\u30f3\u30c8\u306a\u3069\u3092\u8a18\u9332\u3067\u304d\u307e\u3059\u3002\u307e\u305a\u300c\u6700\u7d42\u7d50\u679c\u300d\u3060\u3051\u3067\u306a\u304f\u3001\u3069\u306eoperation\u304c\u539f\u56e0\u5019\u88dc\u304b\u3092\u7d5e\u308a\u307e\u3059\u3002<\/p>\n

\n

Trace\u3068Span\u306e\u9055\u3044\u3092\u5148\u306b\u7406\u89e3\u3059\u308b<\/h2>\n
\n

\u7528\u8a9e\u89e3\u8aac\uff1aTrace<\/strong>
1\u56de\u306eend-to-end workflow\u3092\u8868\u3059\u5358\u4f4d\u3067\u3059\u3002\u4f1a\u8a711\u30bf\u30fc\u30f3\u30841\u3064\u306e\u696d\u52d9\u51e6\u7406\u306a\u3069\u3001\u5168\u4f53\u3092\u3072\u3068\u307e\u3068\u307e\u308a\u3068\u3057\u3066\u8ffd\u3044\u307e\u3059\u3002<\/p>\n<\/blockquote>\n

\n

\u7528\u8a9e\u89e3\u8aac\uff1aSpan<\/strong>
Trace\u306e\u4e2d\u306b\u3042\u308b\u500b\u5225operation\u3067\u3059\u3002Agent\u5b9f\u884c\u3001LLM generation\u3001Tool Call\u306a\u3069\u306b\u958b\u59cb\u30fb\u7d42\u4e86\u3084\u89aa\u5b50\u95a2\u4fc2\u3092\u6301\u305f\u305b\u3066\u8ffd\u8de1\u3057\u307e\u3059\u3002<\/p>\n<\/blockquote>\n

Trace\u304c\u300c\u6ce8\u6587\u51e6\u7406\u5168\u4f53\u300d\u306a\u3089\u3001Span\u306f\u300c\u5728\u5eab\u78ba\u8a8d\u300d\u300c\u6c7a\u6e08\u300d\u300c\u901a\u77e5\u300d\u306e\u3088\u3046\u306a\u500b\u5225\u51e6\u7406\u3067\u3059\u3002\u3069\u306eSpan\u3067\u60f3\u5b9a\u3068\u9055\u3046\u5024\u306b\u306a\u3063\u305f\u304b\u3092\u898b\u308b\u3068\u3001\u539f\u56e0\u306e\u7bc4\u56f2\u3092\u72ed\u3081\u3089\u308c\u307e\u3059\u3002<\/p>\n

\n

Agents SDK\u3067\u306fTracing\u304c\u6a19\u6e96\u3067\u8a18\u9332\u3055\u308c\u308b<\/h2>\n

OpenAI Agents SDK\u306ePython\u5b9f\u88c5\u3067\u306fTracing\u304c\u65e2\u5b9a\u3067\u6709\u52b9\u3067\u3059\u3002Runner\u306b\u3088\u308bAgent\u5b9f\u884c\u304cTrace\u3067\u56f2\u307e\u308c\u3001\u5185\u90e8\u306eGeneration\u3001Tool\u3001Handoff\u306a\u3069\u304cSpan\u3068\u3057\u3066\u8a18\u9332\u3055\u308c\u307e\u3059\u3002Trace viewer\u3092\u4f7f\u3046\u3068workflow\u3092\u6642\u7cfb\u5217\u3067\u78ba\u8a8d\u3067\u304d\u307e\u3059\u3002<\/p>\n

from agents import Agent, Runner\r\n\r\nagent = Agent(\r\n    name="Support Agent",\r\n    instructions="\u554f\u3044\u5408\u308f\u305b\u5185\u5bb9\u3092\u5206\u985e\u3057\u3001\u5fc5\u8981\u306aTool\u3092\u4f7f\u3063\u3066\u56de\u7b54\u3059\u308b"\r\n)\r\n\r\nresult = Runner.run_sync(agent, "\u6ce8\u6587A-1041\u306e\u72b6\u6cc1\u3092\u78ba\u8a8d\u3057\u3066")\r\nprint(result.final_output)<\/code><\/pre>\n
\n
\u81ea\u5206\u3067workflow\u540d\u3068metadata\u3092\u4ed8\u3051\u308b<\/h2>\n
\u8907\u6570\u306e\u51e6\u7406\u3092\u6bd4\u8f03\u3057\u305f\u3044\u5834\u5408\u306f\u3001workflow\u540d\u3084metadata\u3092\u4ed8\u3051\u308b\u3068Trace\u3092\u63a2\u3057\u3084\u3059\u304f\u306a\u308a\u307e\u3059\u3002\u4f1a\u8a71ID\u3084request\u7a2e\u5225\u306a\u3069\u3001\u500b\u4eba\u60c5\u5831\u3092\u907f\u3051\u305f\u8b58\u5225\u5b50\u3092\u4f7f\u3046\u3068\u904b\u7528\u3057\u3084\u3059\u304f\u306a\u308a\u307e\u3059\u3002<\/p>\n
from agents import trace\r\n\r\nwith trace(\r\n    workflow_name="order_support",\r\n    group_id="thread-1041",\r\n    metadata={"flow": "status_check"}\r\n):\r\n    result = Runner.run_sync(agent, "\u6ce8\u6587\u72b6\u6cc1\u3092\u78ba\u8a8d\u3057\u3066")<\/code><\/pre>\n
metadata\u306b\u306f\u539f\u56e0\u5207\u308a\u5206\u3051\u306b\u5fc5\u8981\u306a\u60c5\u5831\u3060\u3051\u3092\u6b8b\u3057\u307e\u3059\u3002\u79d8\u5bc6\u60c5\u5831\u3084\u4e0d\u8981\u306a\u672c\u6587\u3092\u89b3\u6e2c\u6027\u306e\u305f\u3081\u3060\u3051\u306b\u8907\u88fd\u3057\u306a\u3044\u3053\u3068\u3082\u91cd\u8981\u3067\u3059\u3002<\/p>\n
Tool Call\u306e\u5931\u6557\u306f\u5165\u529b\u3068\u51fa\u529b\u3092\u30bb\u30c3\u30c8\u3067\u898b\u308b<\/h2>\n
Tool\u304c\u547c\u3070\u308c\u305f\u306e\u306b\u7d50\u679c\u304c\u304a\u304b\u3057\u3044\u5834\u5408\u3001Tool\u540d\u3060\u3051\u3067\u306f\u539f\u56e0\u3092\u5224\u65ad\u3067\u304d\u307e\u305b\u3093\u3002\u5165\u529bargument\u3001Tool\u5074\u306e\u623b\u308a\u5024\u3001error\u3001\u524d\u5f8c\u306eAgent\u5224\u65ad\u3092\u540c\u3058Trace\u3067\u78ba\u8a8d\u3057\u307e\u3059\u3002<\/p>\n
    \n
  • \u60f3\u5b9a\u3057\u305fTool\u304c\u9078\u629e\u3055\u308c\u3066\u3044\u308b\u304b<\/li>\n
  • argument\u304cschema\u3069\u304a\u308a\u304b<\/li>\n
  • Tool\u5b9f\u884c\u81ea\u4f53\u306f\u6210\u529f\u3057\u3066\u3044\u308b\u304b<\/li>\n
  • \u623b\u308a\u5024\u3092Agent\u304c\u3069\u3046\u89e3\u91c8\u3057\u305f\u304b<\/li>\n
  • \u540c\u3058Tool\u3092\u4e0d\u8981\u306b\u7e70\u308a\u8fd4\u3057\u3066\u3044\u306a\u3044\u304b<\/li>\n<\/ul>\n
    Handoff\u3067\u306f\u300e\u6e21\u3063\u305f\u304b\u300f\u3068\u300e\u6e21\u3063\u305f\u5f8c\u300f\u3092\u5206\u3051\u308b<\/h2>\n
    \u8907\u6570Agent\u69cb\u6210\u3067\u306f\u3001Handoff\u304c\u767a\u751f\u3057\u306a\u3044\u554f\u984c\u3068\u3001Handoff\u5f8c\u306eAgent\u304c\u671f\u5f85\u3069\u304a\u308a\u52d5\u304b\u306a\u3044\u554f\u984c\u3092\u5206\u3051\u307e\u3059\u3002\u524d\u8005\u306f\u9077\u79fb\u6761\u4ef6\u3001\u5f8c\u8005\u306f\u9077\u79fb\u5148Agent\u306einstructions\u30fbTools\u30fb\u5165\u529bcontext\u3092\u898b\u308b\u3068\u5207\u308a\u5206\u3051\u3084\u3059\u304f\u306a\u308a\u307e\u3059\u3002<\/p>\n
      \n
    • Handoff span\u81ea\u4f53\u304c\u5b58\u5728\u3059\u308b\u304b<\/li>\n
    • \u3069\u306eAgent\u304b\u3089\u3069\u306eAgent\u3078\u79fb\u3063\u305f\u304b<\/li>\n
    • Handoff\u5f8c\u306e\u6700\u521d\u306eGeneration\u3067\u4f55\u3092\u5224\u65ad\u3057\u305f\u304b<\/li>\n
    • \u5fc5\u8981\u306aTool\u3084context\u304c\u9077\u79fb\u5148\u3067\u3082\u5229\u7528\u3067\u304d\u308b\u304b<\/li>\n<\/ul>\n
      Tracing\u3092Evals\u3078\u3064\u306a\u3052\u308b<\/h2>\n
      1\u4ef6\u306eTrace\u3067\u539f\u56e0\u304c\u5206\u304b\u3063\u3066\u3082\u3001\u540c\u3058\u5931\u6557\u304c\u7e70\u308a\u8fd4\u3055\u308c\u308b\u304b\u306f\u5225\u554f\u984c\u3067\u3059\u3002\u5931\u6557\u30d1\u30bf\u30fc\u30f3\u3092\u5206\u985e\u3057\u3001Tool\u6210\u529f\u7387\u3084Handoff\u306e\u8aa4\u9078\u629e\u306a\u3069\u3092\u8a55\u4fa1\u30c7\u30fc\u30bf\u3078\u843d\u3068\u3059\u3068\u3001\u5358\u767a\u30c7\u30d0\u30c3\u30b0\u304b\u3089\u56de\u5e30\u691c\u77e5\u3078\u5e83\u3052\u3089\u308c\u307e\u3059\u3002<\/p>\n
      \u307e\u305a1\u3064\u306eAgent workflow\u3092Trace viewer\u3067\u958b\u304d\u3001Tool\u30fbHandoff\u30fbGeneration\u306e\u9806\u306bSpan\u3092\u305f\u3069\u3063\u3066\u3001\u671f\u5f85\u3068\u6700\u521d\u306b\u305a\u308c\u305f\u5730\u70b9\u30921\u3064\u7279\u5b9a\u3057\u3066\u307f\u3066\u304f\u3060\u3055\u3044\u3002<\/p>\n","protected":false},"featured_media":6400,"template":"","meta":{"ssp_meta_title":"AI\u30a8\u30fc\u30b8\u30a7\u30f3\u30c8\u306eTracing\u3068\u306f\uff1fTool Call\u30fbHandoff\u3092\u8ffd\u8de1","ssp_meta_description":"AI\u30a8\u30fc\u30b8\u30a7\u30f3\u30c8\u306eTracing\u3092\u3001Trace\u3068Span\u306e\u5f79\u5272\u304b\u3089\u89e3\u8aac\u3002Tool Call\u3001Handoff\u3001Guardrail\u3001LLM\u751f\u6210\u3092\u3069\u3053\u3067\u78ba\u8a8d\u3057\u3001\u5931\u6557\u539f\u56e0\u3092\u3069\u3046\u5207\u308a\u5206\u3051\u308b\u304b\u3092\u5b9f\u52d9\u5411\u3051\u306b\u6574\u7406\u3057\u307e\u3059\u3002","ssp_meta_keyword":"AI\u30a8\u30fc\u30b8\u30a7\u30f3\u30c8 Tracing,Agent Tracing,Tool Call \u8ffd\u8de1,Handoff \u8ffd\u8de1,OpenAI Agents SDK,Trace Span,AI observability","ssp_meta_canonical":""},"route_category":[8],"_links":{"self":[{"href":"https:\/\/route-zero.com\/recruit\/wp-json\/wp\/v2\/route\/6397"}],"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\/6400"}],"wp:attachment":[{"href":"https:\/\/route-zero.com\/recruit\/wp-json\/wp\/v2\/media?parent=6397"}],"wp:term":[{"taxonomy":"route_category","embeddable":true,"href":"https:\/\/route-zero.com\/recruit\/wp-json\/wp\/v2\/route_category?post=6397"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}