agent-platform-api

Stars13

Forks11

UpdatedJuly 14, 2026 at 07:54

RCS Platform API 完整参考。Agent 通过 curl + jq 调用 REST API 操作平台资源：环境、会话、工作流、配置、任务、知识库、组织等。

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Source

HuangPuStar

HuangPuStar/FenixAgent

View GitHub Repository View Creator Repositories

Download

Related occupationsSOC

Based on SOC occupation classification

Software DevelopersComputer and Mathematical Occupations·SOC 15-1252

File Explorer

11 files

SKILL.md

readonly

name	agent-platform-api
description	RCS Platform API 完整参考。Agent 通过 curl + jq 调用 REST API 操作平台资源：环境、会话、工作流、配置、任务、知识库、组织等。
allowed-tools	Bash

RCS Platform API

认证

以下环境变量由系统自动注入：

$USER_META_BASE_URL — API 服务器地址（仅限 agent 内部调用 RCS API 使用）

$USER_META_BASE_URL 是服务器内部地址，与用户通过浏览器访问的外部地址不同。 该变量只用于 curl 调用 RCS 后端 API（如 curl $USER_META_BASE_URL/web/...），禁止直接拼接后展示给用户。建站等需要告知用户访问地址的场景，统一通过 <agent-sites> 卡片标签或引导用户操作 UI tab 来提供入口，不要手工拼接和暴露 URL。

$USER_META_API_KEY — Bearer token，所有请求必须携带
$USER_META_USER_ID — 当前请求用户 ID，用于标注资源归属或调用 user-scoped API
$USER_META_ORG_ID — 当前组织 ID，多租户隔离/调用 organization-scoped API 时使用

所有请求必须携带 Authorization 头：

AUTH="-H 'Authorization: Bearer $USER_META_API_KEY' -H 'Content-Type: application/json'"

关于组织隔离：绝大多数 /web/* 路由后端会从 API Key 元数据自动取 $USER_META_ORG_ID 作为隔离范围，无需在 URL query 或 body 中显式传 organizationId。$USER_META_ORG_ID / $USER_META_USER_ID 仅在少数需要明确指定目标组织/用户的接口（如 /web/organizations 的 action 类操作）中作为 body 字段传入。

响应格式

成功：{ "success": true, "data": ... } 失败：{ "success": false, "error": { "type": "ERROR_CODE", "message": "..." } }

API 模块索引

模块	文档	说明
环境	`references/environment.md`	环境创建/列表/进入/实例管理
会话	`references/session.md`	会话列表/历史/控制/中断
工作流	`references/workflow.md`	工作流定义/执行引擎/触发器/看板/作业
配置	`references/config.md`	Provider/Model/Agent/Skill/MCP 配置
任务	`references/task.md`	定时任务 CRUD/触发/日志
知识库	`references/knowledge.md`	知识库 CRUD/文件上传/URL 导入
组织	`references/org.md`	组织管理/成员/API Key
Agent Sites	`references/agent-sites.md`	建站部署/App 管理/PocketBase 后端配置/前端上传

使用某个模块的 API 前，先 cat references/<module>.md 读取完整文档和 curl 示例。

常用 jq 技巧

| jq '.data'                  # 提取 data 字段
| jq '.data[] | { id, name }' # 列表提取 id 和 name
| jq -r '.data.draftYaml'     # 原文输出工作流草稿
| jq '{ success }'            # 只看成功状态

More from this repository

same repository

auto-devflow

HuangPuStar/FenixAgent

Use when starting an issue, bugfix, feature, or refactor that should be driven by multiple coordinated subagents: explore → plan → code → review, with the main agent acting as controller and subagents exchanging handoff files.

2026-07-2813

zentao-manager

HuangPuStar/FenixAgent

通过 zentao 命令行工具查询和操作禅道（ZenTao）数据，覆盖项目集、产品、项目、执行、需求、Bug、任务、测试用例、测试单、产品计划、版本、发布、反馈、工单、应用、用户、附件等模块的增删改查及状态流转。当用户提到禅道、zentao、查询项目进展、获取 Bug 列表、创建任务、更新需求状态等项目管理操作时使用本技能。

2026-07-1513

show-html-or-picture

HuangPuStar/FenixAgent

当需要把本地 HTML 或图片文件展示给前端时使用。优先引用工作目录下 user/ 目录中的文件；如果目标文件不在 user/ 目录下，先复制到 user/ 再展示。路径由前端自动改写为 /fs/ 路由代理，Agent 只需输出 user/ 相对路径即可。最终只输出可直接渲染的相对路径片段：HTML 输出 iframe，图片输出 Markdown 图片；路径不能是绝对路径，也不能以 / 开头，且不要附加额外说明文字。

2026-07-0313

fenix-code-review

HuangPuStar/FenixAgent

执行 FenixAgent 项目专用代码审查。手动触发，默认审查已暂存改动，或按用户提供的文件路径、提交范围、分支 diff 范围进行审查，并生成审查报告。

2026-07-0213

skill-creator

HuangPuStar/FenixAgent

帮助用户创建、编辑和优化 Agent Skill 指令文件。当用户提到"创建 skill"、"写技能"、"编辑 skill"、"优化技能"、"新建技能"或需要生成 SKILL.md 文件时使用。

2026-06-0913

RCS Platform API

认证

以下环境变量由系统自动注入：

$USER_META_BASE_URL — API 服务器地址（仅限 agent 内部调用 RCS API 使用）

$USER_META_BASE_URL 是服务器内部地址，与用户通过浏览器访问的外部地址不同。 该变量只用于 curl 调用 RCS 后端 API（如 curl $USER_META_BASE_URL/web/...），禁止直接拼接后展示给用户。建站等需要告知用户访问地址的场景，统一通过 <agent-sites> 卡片标签或引导用户操作 UI tab 来提供入口，不要手工拼接和暴露 URL。

$USER_META_API_KEY — Bearer token，所有请求必须携带

$USER_META_USER_ID — 当前请求用户 ID，用于标注资源归属或调用 user-scoped API

$USER_META_ORG_ID — 当前组织 ID，多租户隔离/调用 organization-scoped API 时使用

所有请求必须携带 Authorization 头：

AUTH="-H 'Authorization: Bearer $USER_META_API_KEY' -H 'Content-Type: application/json'"

关于组织隔离：绝大多数 /web/* 路由后端会从 API Key 元数据自动取 $USER_META_ORG_ID 作为隔离范围，无需在 URL query 或 body 中显式传 organizationId。$USER_META_ORG_ID / $USER_META_USER_ID 仅在少数需要明确指定目标组织/用户的接口（如 /web/organizations 的 action 类操作）中作为 body 字段传入。

响应格式

成功：{ "success": true, "data": ... } 失败：{ "success": false, "error": { "type": "ERROR_CODE", "message": "..." } }

API 模块索引

模块

文档

说明

环境

references/environment.md

环境创建/列表/进入/实例管理

会话

references/session.md

会话列表/历史/控制/中断

工作流

references/workflow.md

工作流定义/执行引擎/触发器/看板/作业

配置

references/config.md

Provider/Model/Agent/Skill/MCP 配置

任务

references/task.md

定时任务 CRUD/触发/日志

知识库

references/knowledge.md

知识库 CRUD/文件上传/URL 导入

组织

references/org.md

组织管理/成员/API Key

Agent Sites

references/agent-sites.md

建站部署/App 管理/PocketBase 后端配置/前端上传

使用某个模块的 API 前，先 cat references/<module>.md 读取完整文档和 curl 示例。

常用 jq 技巧

| jq '.data' # 提取 data 字段 | jq '.data[] | { id, name }' # 列表提取 id 和 name | jq -r '.data.draftYaml' # 原文输出工作流草稿 | jq '{ success }' # 只看成功状态