入门
Agent 快速开始
连接 MCP、匿名使用公开工具,以及遵守每个 Agent 的操作规则。Markdown 版本位于 /help/agents.md。
连接
- MCP 端点为
/mcp/,使用 Streamable HTTP。公开工具支持匿名访问;需要账户的工具使用 OAuth 2.1。 - 不支持 OAuth 的客户端可携带
Authorization: Bearer tb_…,使用用户在已连接 Agent中创建的令牌。 - 首先调用
whoami:返回访问级别、授权及可用词库,或匿名限额与注册链接。 - 注册、登录和授权同意仅在人的浏览器中完成,不在聊天中进行。
没有账户时
匿名 Agent 可读取公开术语库,并按地址限流(默认每 15 分钟 60 次请求)。超限返回 HTTP 429 anonymous_limit_reached,附带 register_url 和 sign_in_url 供转交给用户。
| 目的 | MCP 工具 | REST |
|---|---|---|
| 使用术语库中固定的术语翻译 | pin_terms,之后使用 unpin_terms | POST /api/v1/terms/pin、POST /api/v1/terms/unpin |
| 查询最多 500 个术语的译法 | terms_lookup | POST /api/v1/terms/lookup |
| 在文档中查找已知术语 | terms_find_in_text | POST /api/v1/terms/find-in-text |
| 依据术语检查译文 | translation_check | POST /api/v1/translations/check |
| 为某个词选取首选术语 | resolve_term | POST /api/v1/resolve |
| 搜索公开概念 | search_public_concepts | GET /api/v1/public/search |
| 获取任务所需的公开术语 | 不指定词库的 sync_pull | POST /api/v1/public/sync/pull |
以 Markdown 阅读页面
本网站各页面均提供 Markdown 版本:发送 Accept: text/markdown,或在路径后添加 .md(首页为 /index.md)。私人页面需要与 HTML 页面相同的凭证。Agent 索引位于 /llms.txt。
每个 Agent 都须遵守的规则
- 推送先进入暂存,不直接写入。由人或其授权的 Agent 提交。
- 缺少某条术语不会将其删除;只有
withdrawn: true才会撤回。 - 公开术语不原地修改。修改将成为词库覆盖项、提案或贡献。
- 保持原始拼写、BCP 47 标签、来源和许可不变。
- 不得合并概念。可以建议合并,由人决定。
- 只有凭证具备覆盖权限时,才能修改已审核词条。新的不限缩角色授权包含这项能力;只读或仅提议模式不包含。
现成工作流程
MCP 服务提供三个提示词:prepare_glossary、translate_with_termbank 和 maintain_collection。详见翻译工作流程。