К основному содержанию
скилл CX Codex

platform-agenticsetup-categories-get — скилл для Claude Code

Скилл platform-agenticsetup-categories-get получает категории Agentic Setup из подключённой Salesforce org через Connect API. Можно запросить и вложенные промпты.

Apache-2.0 235 установок ★ 1 183 обновлён 2026-10-23

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add forcedotcom/sf-skills --skill platform-agenticsetup-categories-get -a claude-code
Открыть на GitHub

Что делает platform-agenticsetup-categories-get

Скилл проверяет подключение через sf org display --json, затем вызывает GET /services/data/v67.0/agenticsetup/categories командой sf api request rest. В ответе показывает имя и метку каждой категории; с параметром fetchPrompts=true добавляет вложенные промпты. API возвращает категории и промпты в алфавитном порядке.

Для работы нужна уже авторизованная Salesforce org; если org по умолчанию не задана, потребуется выбрать её через --target-org. Скилл использует Salesforce CLI sf версии 2.0.0 или новее и API версии 67.0 либо указанной пользователем. API доступен только для чтения: создавать и менять категории с его помощью нельзя. Запрос вложенных промптов увеличивает ответ, поэтому их получают только по просьбе.

Какие задачи решает

  • получить список категорий Agentic Setup
  • показать метки категорий из Salesforce org
  • вывести промпты внутри каждой категории
  • разобраться с ошибкой авторизации при запросе категорий

Примеры запросов агенту

  • Покажи категории Agentic Setup в подключённой Salesforce org.
  • Получи категории библиотеки промптов и включи вложенные промпты.
  • Выведи категории Agentforce и объясни ошибку запроса, если она возникнет.

Как установить platform-agenticsetup-categories-get

1Через Skills CLI (Vercel)

npx skills add forcedotcom/sf-skills --skill platform-agenticsetup-categories-get -a claude-code

2Вручную: положить файлы

~/.claude/skills/platform-agenticsetup-categories-get/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/platform-agenticsetup-categories-get/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о platform-agenticsetup-categories-get

Как установить platform-agenticsetup-categories-get в Claude Code?

Выполните npx skills add forcedotcom/sf-skills --skill platform-agenticsetup-categories-get -a claude-code. Файл скилла будет размещён по пути ~/.claude/skills/platform-agenticsetup-categories-get/SKILL.md.

Что делает platform-agenticsetup-categories-get?

Получает категории Agentic Setup из подключённой Salesforce org через Connect API. По запросу включает промпты, вложенные в категории.

Что нужно для работы скилла?

Нужна авторизованная Salesforce org и Salesforce CLI sf версии 2.0.0 или новее. Используется API версии 67.0 или версия, заданная пользователем.

Исходный текст

SKILL.md · Apache-2.0
---
name: platform-agenticsetup-categories-get
description: "Get agentic setup prompt categories from a connected Salesforce org using the Connect API via sf api request rest. Use this skill to call GET /services/data/vXX.0/agenticsetup/categories and return the list of prompt categories, optionally with their nested prompts using fetchPrompts=true. TRIGGER when: user asks to get, fetch, retrieve, list, or show agentic setup categories, prompt categories, setup copilot categories, prompt library categories, available setup prompts, Agentforce prompt library, copilot prompts, or calls the agenticsetup categories Connect REST API. DO NOT TRIGGER when: user wants to create new categories, work with non-categories endpoints, or generate OpenAPI specs."
allowed-tools: Bash Read
metadata:
  version: "1.1"
  domains: ["Platform", "Agentforce"]
  minApiVersion: "67.0"
  cliTools:
    - tool: ["sf"]
      semver: ">=2.0.0"
---

# platform-agenticsetup-categories-get

Get prompt categories from the Agentic Setup Categories Connect API on a connected Salesforce org.

## Scope

**In scope:**
- Calling `GET /services/data/{apiVersion}/agenticsetup/categories` via SF CLI
- Passing the `fetchPrompts` query parameter to include nested prompts
- Parsing and presenting the JSON response (categories, labels, prompts)
- Handling errors (403 when feature is disabled, auth failures)

**Out of scope — delegate elsewhere:**
- Creating or modifying prompt categories → not supported via this API (read-only)
- Org authentication setup → use `sf org login` separately
- Permission set assignment → assigning-permission-set

---

## Required Inputs

The agent needs:
- A connected org (already authenticated via `sf org login`)
- Optionally: whether to include nested prompts (`fetchPrompts=true`)
- Optionally: target API version (default: v67.0). Replace `v67.0` in the URL with the user-specified version if provided.

---

## Workflow

### 1. Verify org connectivity

```bash
sf org display --json
```

Confirm the org is authenticated and extract the instance URL. If no default org is set, ask the user which org to target with `--target-org`.

### 2. Call the Categories API

**Basic call (categories only):**
```bash
sf api request rest /services/data/v67.0/agenticsetup/categories --method GET
```

**With nested prompts:**
```bash
sf api request rest "/services/data/v67.0/agenticsetup/categories?fetchPrompts=true" --method GET
```

### 3. Parse and present the response

The API returns a JSON object with a `categories` array. Each category has `name`, `label`, and `prompts` fields. See `references/api-response-schema.md` for the full response structure and examples for both `fetchPrompts=true` and `fetchPrompts=false`.

Present the results clearly:
- List categories with their name and label
- If `fetchPrompts=true` was used, show nested prompts under each category
- Note any categories with empty `prompts` arrays (means no prompts exist for that category)

### 4. Handle errors

| Error | Meaning | Action |
|-------|---------|--------|
| Success (exit 0) | 200 OK | Parse and display results |
| `FUNCTIONALITY_NOT_ENABLED` | Feature not enabled for this org/user | Tell user the Agentic Setup Categories feature needs to be enabled — check Setup > Einstein/Agentforce |
| `INVALID_SESSION_ID` | Session expired | Re-authenticate with `sf org login` |
| `NOT_FOUND` | Endpoint not found | API version too old or feature not deployed to this org |

---

## Rules / Constraints

| Rule | Rationale |
|------|-----------|
| Always use `sf api request rest` — never curl or raw HTTP | curl bypasses `~/.sfdx` session tokens and requires manual Authorization headers, making it brittle |
| NEVER use SOQL queries | Categories are NOT in standard objects — only available via this Connect REST API |
| NEVER generate files (LWC, Apex, XML) | This is a data-fetching task, not a code generation task |
| Default to v67.0 unless user specifies | This is the min-version where the endpoint was introduced |
| Don't pass fetchPrompts unless asked | Reduces payload size; prompts can be large |
| Categories are sorted by label | The API returns them alphabetically — don't re-sort |
| Prompts are sorted by text | Within each category, prompts come alphabetically |

---

## Output Expectations

When finishing, present:

1. **Number of categories** returned
2. **Category list** — name and label for each
3. **Prompts** (if requested) — nested under their category
4. **Any errors** encountered with suggested fixes

---

## Reference File Index

| File | When to read |
|------|--------------|
| `references/api-response-schema.md` | When you need to understand the full response structure and field descriptions |

© forcedotcom · Apache-2.0 · forcedotcom/sf-skills

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
agentforce-adlc SalesforceAIResearch Плагин agentforce-adlc для Claude Code создаёт, разворачивает, тестирует и улучшает агентов Agentforce через .agent и Agent Script DSL. Закрывает полный цикл разработки. ★ 119звёзд репо sfagent-tools lucianostraga Плагин sfagent-tools прогоняет тестовые диалоги с вашим агентом Agentforce, проверяет маршрутизацию и правила и отдаёт отчёт с оценками. ★ 24звёзд репо salesforce-flow-design официальный github Скилл salesforce-flow-design проверяет архитектуру Salesforce Flow: выбор типа, bulk-безопасность и обработку ошибок. Подходит для проектирования и ревью Flow перед активацией. CX Codex +1 839установок crm-integration manojbajaj95 Скилл crm-integration для Claude Code содержит шаблоны интеграции Close CRM, HubSpot и Salesforce для синхронизации лидов, сделок и вебхуков. CX Codex +1 211установок Salesforce Visualforce Development официальный github Субагент Salesforce Visualforce Development для GitHub Copilot, который пишет и проверяет страницы Visualforce вместе с их Apex-контроллерами. CX Codex +1 ★ 41 430звёзд репо salesforce-apex-cursorrules-prompt-file PatrickJS Правило salesforce-apex-cursorrules-prompt-file для Cursor, которое задаёт стиль разработки Salesforce на Apex. Подключается в проектах, где ассистент пишет Apex-классы и асинхронную логику. CX Codex +1 ★ 41 178звёзд репо

Из того же набора232

Весь набор →
service-itsm-slack-itservice-configure Скилл service-itsm-slack-itservice-configure ведёт настройку Employee Service в Slack: включает настройку организации, назначает наборы разрешений и связывает портал сотрудников с Slack. CX Codex +1 320установок service-itsm-agentic-setup-agent-runtime-access-assign Скилл service-itsm-agentic-setup-agent-runtime-access-assign для Claude Code выдаёт пользователям права для активированных ITSM-агентов Salesforce. Устраняет ошибки доступа при действиях агента. CX Codex +1 314установок experience-search-coordinate Скилл experience-search-coordinate координирует поиск статей, новостей и медиафайлов в Salesforce CMS. Он распределяет запросы на поиск структурированного контента и файлов по нужным каналам. CX Codex +1 275установок experience-lwc-legacy-migrate Скилл experience-lwc-legacy-migrate проверяет полноту миграции компонентов Aura в LWC и переводит внешние страницы Lightning Out Beta на Lightning Out 2.0 с OAuth PKCE. CX Codex +1 245установок experience-cms-content-render Скилл experience-cms-content-render для Claude Code, Codex, Cursor и других агентов, который встраивает готовый контент Salesforce CMS в React- или Angular-приложение uiBundle. CX Codex +1 226установок experience-design-validate Скилл experience-design-validate проводит визуальный аудит интерфейса по скриншотам или URL и составляет отчёт по пяти критериям качества. Пригодится на дизайн-ревью перед релизом. CX Codex +1 220установок platform-role-hierarchy-apply Скилл platform-role-hierarchy-apply для Claude Code перестраивает иерархию ролей Salesforce по оргсхеме. Он подключается для пакетного изменения ролей, а перед отправкой показывает сводку операций для подтверждения администратора. CX Codex +1 178установок consumer-goods-promotion-bo-api-deploy Скилл consumer-goods-promotion-bo-api-deploy включает Promotion BO API в Salesforce Consumer Goods Cloud, создаёт и деплоит кастомный Workflow Step и проверяет весь путь через REST. CX Codex +1 160установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой