agentforce-observe

用途：分析生产环境 Agentforce 智能体行为，基于会话追踪数据与 Data Cloud 定位问题，并管理 Agent Health Monitoring（AHM）告警。整体为三阶段工作流：观察（Observe）→ 复现（Reproduce）→ 改进（Improve）。

主要能力：

1. 观察：可用时从 Data Cloud 查询 STDM 会话；不可用时回退到测试套件加 sf agent preview 本地追踪分析。提供 findSessions、getMultipleConversationDetails、getLlmStepDetails、getAggregatedMetrics、getMomentInsights、runObservabilityQuery 等方法。
2. 复现：用 sf agent preview 实时模拟问题对话，每个场景跑 3 次，判定 [CONFIRMED]、[INTERMITTENT] 或 [NOT REPRODUCED]。
3. 改进：直接编辑 .agent 文件，校验、发布、验证。
4. AHM：创建、列出、更新（PUT）、删除告警，并获取通知。

必要用法：需已认证的 org 别名与智能体 API 名称。查询前先解析智能体名称：sf data query --json --query "SELECT Id, MasterLabel, DeveloperName FROM GenAiPlannerDefinition WHERE MasterLabel LIKE '%<名称>%' OR DeveloperName LIKE '%<名称>%'" -o <org>。校验与发布：sf agent validate authoring-bundle --json --api-name <名称> -o <org>；sf agent publish authoring-bundle --json --api-name <名称> -o <org>。

适用场景：生产问题排查、开发迭代、无 STDM 的 org 回退分析、语音智能体检查。

限制：默认回看 7 天；STDM 需 Data Cloud 且约 15 分钟延迟；预览无真实用户数据；Windows 需替换 python3、/tmp 与 jq 等价命令；sf api request rest 为 beta 命令，不支持 --json；跨智能体依赖与发布漂移需额外检查。平台具体价格、配额与效果暂未提供。