SuperAPI AI 工具集

maple-agent-tracing-microsoft-agent-framework

智能体与模型

查看项目

更新于 10-16 00:05

技能介绍

用途:把 Microsoft Agent Framework(MAF)和 Semantic Kernel(SK)的智能体运行追踪接入 Maple,使一次用户对话对应一个 Maple Agent Session,包含转录、每次模型调用、每次工具调用(参数、结果、失败)与 token 用量。spans 由框架自身发出,接入方只需添加 OTLP/HTTP exporter、内容捕获、gen_ai.conversation.id span processor 和 flush。

主要能力与用法:先检测项目框架与版本(Python MAF ≥ 1.19.0,.NET MAF ≥ 1.22.0,Python SK ≥ 1.44.1)。安装 opentelemetry-exporter-otlp-proto-http 或对应 .NET 包,配置端点 https://ingest.maple.dev(EU 为 https://ingest.eu.maple.dev),协议 http/protobuf,Authorization=Bearer <key>。若已存在 OpenTelemetry provider,应把 Maple exporter 与 conversation processor 加入其中,不要另建 provider 或重复调用 configure_otel_providers()。通过 ConversationIdProcessor 与 conversation(id) 包装每个请求或轮次,确保同会话所有 span 带相同 gen_ai.conversation.id;流式、审批恢复与工作流运行也需在同一 with 内。开启敏感数据捕获以获取消息与工具参数结果,并保持 enable_message_events=False 避免重复负载。每个 Agent 与工具需显式命名。脚本、CLI、无服务器场景需在退出前 flush 或 shutdown provider。

适用场景:Python 或 .NET 的 MAF 与 Semantic Kernel 应用,包括 Chat Completions、OpenRouter、Ollama、工作流与子智能体编排。

限制:无密钥时 export 被禁用而非报错;密钥分区域绑定,401 可能需改用另一区域端点;SK 的模型调用内容为 Python 日志,Maple 不读取,且无 agent 的纯 kernel 代码无转录;SK 的 finish reason 为 Python 枚举名,Maple 的回复长度与拒答检查无法读取。未提供定价与套餐信息。