REST API

Gisia 在约定的 URL 上提供机器可读的技能文件。你的 AI 机器人不需要阅读静态 API 文档，而是直接从你的运行实例抓取技能文件 — 因此它拿到的 URL、ID 和作用域始终准确且最新。

为什么抓取而不是写文档

技能文件有意不在这里以静态示例的形式重复。原因有二：

• 实例相关的值 — 基础 URL、项目 ID 和令牌作用域在不同安装之间各不相同。硬编码的示例需要手动替换，容易出错。
• 始终最新 — 当接口或字段变化时，技能文件会自动更新。直接抓取文件的机器人总能获得正确的指令，无需维护文档。

推荐的做法是把技能 URL 交给机器人，让它读取实时文件，而不是从文档里粘贴示例 curl 命令。

可用技能

• /-/users/skills.md — 当前认证用户以及所有用户级技能的链接
• /:namespace/:project/-/skills.md — 项目概览以及所有项目级技能的链接
• /:group/-/skills.md — 群组概览以及所有群组级技能（成员、标签）的链接

这些文件都链接到各自的子技能，因此机器人可以从这些入口遍历整个 API。

要在浏览器中查看这些文件，你需要先登录。

如何使用

把上面任一技能 URL 连同你的个人访问令牌交给机器人，然后让它下载列出的全部技能。

Read /-/users/skills.md using PRIVATE-TOKEN: YOUR_PERSONAL_ACCESS_TOKEN

Read the project skill and download all skills by running:
curl -s https://your-instance/:namespace/:project/-/skills.md -H "PRIVATE-TOKEN: YOUR_PERSONAL_ACCESS_TOKEN"