用途：为不依赖智能体框架、直接调用 OpenAI／Anthropic／Gemini SDK 的智能体接入 Maple 追踪。目标是把一段对话记为一次 Maple Agent Session：每条用户消息为一个 turn，对应一条以 invoke_agent 为根 span 的 trace，内含每次模型调用的 chat／generate_content span（含消息与 token）和每次工具调用的 execute_tool span（参数、结果、失败）。
主要能力与用法：Python 用官方 OpenTelemetry GenAI 插桩包（opentelemetry-instrumentation-genai-openai、-genai-anthropic、opentelemetry-instrumentation-google-genai，均需 >= 1.2b0）；TypeScript 无可用官方插桩，需按参考文档用 helper 手动记录模型调用。两种语言都需要自行添加 invoke_agent span（带 gen_ai.conversation.id）和 execute_tool span。需先确认未使用任何智能体框架，否则应改用对应框架技能；否则会出现重复记录。还需检查语言与 SDK 版本范围、已有 OTel 配置、同一 SDK 的其他插桩。配置包含端点（美国 https://ingest.maple.dev，欧盟 https://ingest.eu.maple.dev）、Authorization=Bearer <key>、OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf、OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT=SPAN_ONLY 等环境变量，并设置真实 service.name、稳定的会话 id、工具执行经 run_tool／runTool 包装、流式调用处理 token 统计与 flush。
限制：框架维度显示 Unidentified；Python 无成本数据（显示 unpriced）；Anthropic 插桩不记录 messages.stream() 的首块时延；Gemini 路径尚未端到端验证；键与区域绑定，跨区会 401。资料未提供公开的安装命令与服务条款。