用途:Maple agent tracing(router)本身不直接埋点,而是为仓库中的每个 AI 智能体或 LLM 应用挑选正确的按框架追踪技能,便于接入 Maple 追踪,使每次对话在 Maple 中显示为一个 Agent Session,包含转录、模型调用、工具调用、token、成本等信息。
主要能力:在仓库各应用与服务中查找 LLM 与智能体依赖,检查 package.json、pyproject.toml、requirements*.txt、uv.lock、pom.xml、build.gradle*、*.csproj、go.mod;一个仓库可含多个服务,需分别处理。随后按依赖匹配对应的框架技能,例如 Mastra 对应 maple-agent-tracing-mastra,OpenAI Agents 对应 maple-agent-tracing-openai-agents,LangChain/LangGraph(Python)对应 maple-agent-tracing-langchain,LangChain.js/LangGraph.js 对应同一技能并参考 references/typescript.md,Claude Agent SDK 对应 maple-agent-tracing-claude-agent-sdk,Cloudflare Agents 对应 maple-agent-tracing-cloudflare-agents,Vercel AI SDK 对应 maple-agent-tracing-vercel-ai-sdk,Genkit 对应 maple-agent-tracing-genkit,Pydantic AI、CrewAI、Google ADK、LlamaIndex、Strands、smolagents、Agno、DSPy、Haystack、Microsoft Agent Framework、Spring AI、LiteLLM、OpenRouter、仅用提供商 SDK、以及手写循环或其它语言分别对应各自技能(含 maple-agent-tracing-opentelemetry)。
使用方式:安装命令为 npx skills add MapleTechLabs/maple/skills --skill <skill> -y,然后阅读安装后的 SKILL.md 并遵循它;若 npx skills 不可用,可从 https://raw.githubusercontent.com/MapleTechLabs/maple/main/skills/<skill>/SKILL.md 直接读取。
匹配顺序:框架行优先于提供商 SDK 行,因为框架依赖提供商 SDK,同时插桩会重复记录每次模型调用;例如 Mastra 依赖 ai、LangChain.js 依赖 openai,应先匹配框架,不要把 LangChain.js 服务路由到提供商 SDK 技能。
收尾:当按框架技能自身检查通过后,告知用户已插桩的服务与所用技能;一次对话运行后,对话会出现在 Maple 的 Agent Sessions(https://app.maple.dev/agent-sessions,EU 组织为 app.eu.maple.dev);并说明该框架技能未捕获的内容(如成本或消息内容),使该缺口属于预期而非缺陷。
限制:本技能只负责路由选择,不执行具体埋点;依赖识别范围限于所列清单文件类型,其它情况按资料中的兜底技能处理。关于价格、收费、平台支持与效果等细节暂未提供。