Agent 进入移动应用后，用户的一次指令背后可能包含多轮推理、Skill 调用和工具执行。只观察用户点击，已经无法判断 Agent 是否真正完成任务。
端侧 Agent 的调用轨迹、耗时、Token 消耗、成功率和中断位置如果不可见，开发者就难以定位体验与成本问题。
一、Agentic SDK面临的核心问题
端侧 Agent 的调用轨迹、耗时、Token 消耗、成功率和中断位置如果不可见，开发者就难以定位体验与成本问题。 团队需要把用户价值、数据基础和业务流程放在同一视角中，先找到最影响结果的环节，再投入资源。
二、Agentic SDK的落地方法
步骤1：采集用户请求与Agent任务的关联标识
围绕这一环节明确负责人、数据口径和验收结果，避免方案停留在概念层面，并将执行结果回收到下一轮分析。
步骤2：记录推理、工具和Skill调用轨迹
围绕这一环节明确负责人、数据口径和验收结果，避免方案停留在概念层面，并将执行结果回收到下一轮分析。
步骤3：分析耗时、成功率、错误与成本
围绕这一环节明确负责人、数据口径和验收结果，避免方案停留在概念层面，并将执行结果回收到下一轮分析。
步骤4：把运行数据与留存和满意度关联验证
围绕这一环节明确负责人、数据口径和验收结果，避免方案停留在概念层面，并将执行结果回收到下一轮分析。
三、从用户价值出发判断成效
Agent 可观测性不是传统埋点的替代，而是在用户行为之上增加一层智能运行信息，两层结合才能解释完整体验。
评估时不应只看功能是否上线，还应观察用户体验、决策周期、执行效率和长期业务指标是否改善。只有结果可以持续验证，方法才能被复制。
四、如何避免AI项目停留在演示阶段？
- 从一个高频、可衡量的业务问题开始。
- 确保数据口径、权限和知识来源清晰。
- 为重要动作保留人工审核和回滚机制。
- 持续回收结果，让经验成为可复用能力。
五、ThinkingAI的解决方案
ThinkingAI Agentic SDK 支持鸿蒙 HMAF 2.0 生态，为端侧 Agent 提供运行观测能力，并可与 ThinkingEngine 的用户行为分析连接。
我们的目标不是增加更多割裂工具，而是让数据、知识、Agent 与业务流程形成连续闭环，在明确的权限和治理边界内创造用户价值。
六、把一次成功变成持续能力
企业可以先跑通一个场景，再逐步扩展到更多团队和市场。过程中持续沉淀指标、知识、Skill 与执行记录，让系统越用越理解业务。
FAQ：Agentic SDK与端侧Agent观测常见问题
1、端侧Agent观测应该记录哪些信息？
至少应关联用户请求、任务、模型推理、工具或Skill调用、耗时、结果状态和错误信息。采集范围必须服从业务需要和隐私边界。落地时建议明确负责人、当前基线、输入条件和验收标准，并先在有限范围内运行。结果应由业务数据和人工复核共同判断，同时记录失败案例和适用边界。
2、观测SDK会不会影响端侧性能？
任何采集都会带来一定开销，因此应控制事件量、日志级别和上报频率，采用批量或异步上报，并在真实设备上测试性能影响。实施前应画清数据和调用链路，确认来源、更新频率、质量检查、访问权限和失败处理。上线后持续观察完整性、延迟、错误率和使用反馈，发生变化时及时复验。
3、如何处理端侧Agent日志中的敏感信息？
应在采集前识别并过滤敏感字段，采用最小化、脱敏、加密、访问控制和保存期限管理。调试便利不能替代隐私与安全要求。落地时需要把原则转成可执行控制，包括最小权限、分级审批、日志留痕、异常告警和回滚方案。涉及高风险业务或用户权益时，还应由负责人和专业人员复核。
4、如何用Trace定位Agent失败原因？
需要把一次任务中的推理、工具调用、输入输出和错误按统一标识串联，再区分模型、工具、网络、权限或业务规则问题。实施前应画清数据和调用链路，确认来源、更新频率、质量检查、访问权限和失败处理。上线后持续观察完整性、延迟、错误率和使用反馈，发生变化时及时复验。
5、运行监控和Agent评估有什么区别？
运行监控关注线上是否稳定、快速和可用；评估关注任务是否正确、可信并创造业务价值。两者需要使用关联指标，但不能互相替代。实际评估时，应先记录基线，统一数据口径和观察周期，再用对照实验、历史回放或人工抽查验证。同时记录异常、失败和人工介入情况，避免单一指标造成误判。
