agent-platform-api

Estrellas13

Forks11

Actualizado14 de julio de 2026 a las 07:54

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

Instalación

Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.

Fuente

HuangPuStar

HuangPuStar/FenixAgent

Abrir repositorio de GitHub Ver repositorios del creador

Descarga

Ocupaciones relacionadasSOC

Basado en la clasificación ocupacional SOC

Desarrolladores de softwareOcupaciones informáticas y matemáticas·SOC 15-1252

Explorador de archivos

11 archivos

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 }'            # 只看成功状态

Más de este repositorio

mismo repositorio

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 }' # 只看成功状态