SuperAPI AI 工具集

platform-agenticsetup-categories-get

智能体与模型

查看项目

更新于 10-16 08:47

技能介绍

用途:从已连接的 Salesforce 组织读取 Agentic Setup 的提示类别数据,属于只读的数据获取任务,不支持创建或修改类别。

主要能力:调用 GET /services/data/{apiVersion}/agenticsetup/categories;可通过 fetchPrompts 查询参数附带嵌套提示;解析并展示返回的 JSON 响应(categories、label、prompts);处理 403 功能未启用、认证失败等错误。

使用方式:

  1. 先用 sf org display --json 确认组织已认证,未设置默认组织时用 --target-org 指定。
  2. 基本调用: sf api request rest /services/data/v67.0/agenticsetup/categories --method GET
  3. 含嵌套提示: 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 版本过低或该组织未部署该功能。组织认证和权限集分配需另行处理。