用途:从已连接的 Salesforce 组织读取 Agentic Setup 的提示类别数据,属于只读的数据获取任务,不支持创建或修改类别。
主要能力:调用 GET /services/data/{apiVersion}/agenticsetup/categories;可通过 fetchPrompts 查询参数附带嵌套提示;解析并展示返回的 JSON 响应(categories、label、prompts);处理 403 功能未启用、认证失败等错误。
使用方式:
- 先用 sf org display --json 确认组织已认证,未设置默认组织时用 --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
适用场景:需要查看某组织中 Agentic Setup 提示类别及其提示清单时。
限制与约束:必须使用 sf api request rest,禁止 curl 或原始 HTTP;禁止使用 SOQL;禁止生成文件(LWC、Apex、XML);默认 API 版本 v67.0(该端点引入的最低版本),用户可指定其他版本;未要求时不要传 fetchPrompts。类别按 label 字母排序,提示按文本字母排序,不要重新排序。当返回 403 FUNCTIONALITY_NOT_ENABLED 时提示需在 Setup > Einstein/Agentforce 启用该功能;INVALID_SESSION_ID 需重新登录;NOT_FOUND 表示 API 版本过低或该组织未部署该功能。组织认证和权限集分配需另行处理。