用途:分析生产环境 Agentforce 智能体的运行行为,定位问题并改进 .agent 文件,同时管理 Agent Health Monitoring(AHM)告警。
主要能力:三阶段工作流——观察(从 Data Cloud 查询 STDM 会话,或在不可用时回退到测试套件与本地追踪)、复现(用 sf agent preview 模拟问题对话)、改进(直接编辑 .agent 文件、校验、发布、验证)。支持会话详情、LLM 提示/响应、聚合指标、时刻洞察与 RAG 深挖查询;可识别动作错误、子智能体误路由、变量捕获失败、LOW adherence、语音智能体 UX 与延迟反模式等问题,并按 P1/P2/P3 分级。AHM 支持创建、列出、更新、删除告警及查询通知。
使用方式:需已认证的 org 别名与智能体 API 名称。先解析智能体名称(GenAiPlannerDefinition 查询 MasterLabel/DeveloperName),定位 .agent 文件,发现 Data Space,部署 AgentforceOptimizeService 辅助类并探测 STDM DMO。关键命令包括 sf agent preview start/send/end、sf agent validate authoring-bundle、sf agent publish authoring-bundle。追踪文件位于 .sfdx/agents/{Name}/sessions/{sessionId}/traces/{planId}.json。
适用场景:生产智能体行为分析、问题复现与修复、语音智能体检查、告警监控。
限制:STDM 路径依赖 Data Cloud 且约有 15 分钟延迟;无 STDM 时回退路径仅能预览、无真实用户数据。Windows 需替换命令语法。部分命令为 beta,具体细节以官方文档为准。