TongId for Agents

让 Agent 通过 HTTP 处理你的 Issue

不需要 MCP Server。Agent 在本机浏览器登录 TongID 后,以自己的 Bearer 登录态调用标准 REST API;本地技能包只负责告诉它何时、怎样安全地调用这些接口。

本机登录态
Authorization: Bearer <local-session>
x-tongid-application-id: $TONGID_APPLICATION_ID

目标应用由请求头指定,TongID 再按当前登录用户的工作空间 RBAC 校验操作权限。

Issue REST API

一个 API,覆盖 Agent 的处理闭环

所有路径均相对于你的 TongId 域名,例如 https://tongid.example.com/api/v1。

检索与创建 Issue

按状态、分类、标签、来源和关键词筛选;创建时自动进入“待处理”。

  • GET /api/v1/issues
  • POST /api/v1/issues
  • GET /api/v1/issues/:id

分析问题趋势

读取状态、分类和来源的聚合统计,让 Agent 先判断再行动。

  • GET /api/v1/issues/stats

回复与状态流转

写入内部处理回复,并将 Issue 流转到处理中、待验收、已完成或已关闭。

  • POST /api/v1/issues/:id/replies
  • PATCH /api/v1/issues/:id

维护分类与标签

Agent 可先读取可用分类、标签,也可按授权创建、改名或安全删除。

  • GET|POST|PATCH|DELETE /api/v1/issues/categories
  • GET|POST|PATCH|DELETE /api/v1/issues/tags

Local skill

技能包不保存应用凭据,只保存流程

技能源已独立维护在 GitHub。Agent 可先查看具体的 tongid-board 目录,再通过技能安装器从该目录安装;登录后的本机会话只保存在当前用户目录,权限始终由 TongID 工作空间 RBAC 决定。

github.com/df007df/tongid-skills · skills/tongid-board
  1. 1

    本机登录

    设置站点地址后执行 tongid-board login,在浏览器完成 TongID 登录。

  2. 2

    选择目标应用

    设置 TONGID_APPLICATION_ID;TongID 按登录用户的工作空间权限验证该应用。

  3. 3

    先查再写

    先检索 Issue 或读取统计;创建、回复、改状态等写操作必须来自明确指令。

默认安全边界

读操作可直接执行;写操作应来自明确的人类指令。

查看可用接口