用途:从已连接的 Salesforce 组织获取 Agentic Setup 提示类别数据,调用 Connect API 的 GET /services/data/{apiVersion}/agenticsetup/categories 端点。
主要能力:通过 SF CLI 发起 REST 请求;可传 fetchPrompts 查询参数以包含嵌套提示;解析并展示返回的 JSON(categories、label、prompts);处理错误,如功能未启用时的 403、认证失败等。该 API 为只读,不支持创建或修改提示类别。
使用方式:先确认组织连通性,运行 sf org display --json,确认已认证并获取实例 URL;未设置默认组织时用 --target-org 指定。基础调用:sf api request rest /services/data/v67.0/agenticsetup/categories --method GET。包含嵌套提示:sf api request rest "/services/data/v67.0/agenticsetup/categories?fetchPrompts=true" --method GET。默认 API 版本 v67.0,用户可指定其他版本。
结果展示:列出类别名称与标签;若使用 fetchPrompts=true,展示各类别下的嵌套提示;标注提示数组为空的类别。类别按标签字母排序,提示按文本字母排序,不要重新排序。
限制与约束:必须使用 sf api request rest,禁止 curl 或原始 HTTP;禁止使用 SOQL 查询;禁止生成文件(LWC、Apex、XML);除非用户要求,否则不要传 fetchPrompts;组织认证、权限集分配等不在本技能范围内。错误处理:FUNCTIONALITY_NOT_ENABLED 表示功能未启用,需在 Setup 中检查 Einstein/Agentforce;INVALID_SESSION_ID 需重新登录;NOT_FOUND 表示 API 版本过旧或功能未部署。
适用场景:需要读取 Salesforce 组织中 Agentic Setup 提示类别及提示清单时使用。其他细节暂未提供。