本章节面向运维人员，介绍使用 Docker Compose 在 Linux 服务器上部署通达 AI 平台的最短路径。命令中的 SERVER_HOST、CHANGE_ME 等占位符请替换为实际值。

部署前准备

• Linux 服务器；控制面建议至少 4C8G，启用 Sandbox 时还要按并发量和 SANDBOX_MEMORY_MB 额外预留资源。
• 已安装并正常运行的 Docker Engine 和较新的 Docker Compose；过旧的 Compose 不支持当前服务依赖条件。
• 服务器可以访问阿里云镜像仓库 registry.cn-hangzhou.aliyuncs.com。
• API 容器需要挂载宿主机 /var/run/docker.sock，用于创建 Sandbox。

需要开放的端口

部署和启动

下载内网部署包：T20-AI-Agent-intranet-deploy.zip。解压后进入部署目录，完成 .env.production 配置，再执行启动命令：

curl -LO https://cdndown.tongda2000.com/other/T20-AI-Agent-intranet-deploy.zip
unzip T20-AI-Agent-intranet-deploy.zip
cd T20-AI-Agent-intranet-deploy

docker compose --env-file .env.production -f docker-compose.prod.yml up -d

部署验证

将以下命令中的 SERVER_HOST 替换为服务器 IP 或域名：

curl -i http://SERVER_HOST:30000/health
curl -I http://SERVER_HOST:30001
curl -i http://SERVER_HOST:30080/

• API 健康检查应返回 HTTP 200，并且内容包含 db=true、redis=true。
• 管理后台未登录时通常跳转到 /login。
• APISIX 返回 404 Route Not Found 只表示当前没有注册 Sandbox 预览路由，端口连通仍属正常。
• 执行 docker exec t20-agentkit-api docker version，确认 API 容器可以访问宿主机 Docker。

更新注意事项

更新前先备份 PostgreSQL。进入 T20-AI-Agent-intranet-deploy 目录，修改 .env.production 中的 AGENTKIT_VERSION 后，再重新拉取并启动：

cd T20-AI-Agent-intranet-deploy
docker compose --env-file .env.production -f docker-compose.prod.yml pull
docker compose --env-file .env.production -f docker-compose.prod.yml rm -f db-init
docker compose --env-file .env.production -f docker-compose.prod.yml up -d

1.1 注册新账号

1. 在浏览器中打开管理后台地址（开发环境默认为 http://localhost:3001）
2. 点击登录页底部的 「还没有账户？注册」 链接
3. 在注册页面填写以下信息：
   • 姓名（可选）— 你的显示名称
   • 邮箱（必填）
   • 密码（必填，至少 8 位）
4. 完成验证码验证（根据配置可能显示：Altcha 滑块验证 / Cloudflare Turnstile 复选框 / hCaptcha 图片选择）
5. 点击 「注册」 按钮
6. 注册成功后页面显示绿色提示条 "注册成功"，自动返回登录页

1.2 登录

1. 在登录页填写 邮箱 和 密码
2. 完成验证码验证
3. 点击 「登录」 按钮
4. 登录成功后进入管理后台首页（默认跳到 模型供应商 页面）

1.3 登录页截图说明

登录页左侧展示 通达AI平台 品牌标识和轮播海报（每 5 秒切换一次），包含三个场景：工作空间、沙箱编码、平台管理。右上角可切换语言和主题（浅色 / 深色 / 跟随系统）。

图 1 通达AI平台 登录页

2.1 整体布局

登录后你看到的是如下布局：

图 2 通达AI平台整体布局（模型供应商页）

界面结构说明

2.2 侧边栏导航

左侧侧边栏分为 5 个分组，点击可折叠展开：

平台组 — 基础设施配置

智能体组 — 核心功能

集成组 — 开发中

开发组

评测组

侧边栏折叠：点击顶部 图标可将侧边栏折叠为仅显示图标，鼠标悬停时弹出文字提示。

2.3 用户菜单（右上角）

点击右上角用户头像（显示姓名或邮箱首字母）展开菜单：

2.4 空间切换器（侧边栏顶部）

位于侧边栏顶部 Logo 下方，显示当前所在的空间名称和类型。

个人空间显示 图标，团队空间显示 图标。

点击下拉菜单可：

• 查看当前空间 — 显示名称 + 类型（个人空间/团队）+ 角色（所有者/管理员/成员/访客）
• 空间管理（仅所有者/管理员）— 点击齿轮图标跳转到成员管理页
• 切换其他空间 — 点击列表中的其他空间直接切换
• 申请加入团队 — 输入团队名称搜索并提交申请
• 创建新团队 — 填写名称和描述即可创建

图 3 空间切换器

2.5 全局助手（右下角浮动按钮）

右下角的 按钮是全局助手，点击展开一个随时可用的 AI 对话面板：

• 输入问题并按 Enter 发送
• 无输入时显示 9 个快捷提问芯片（如"有哪些智能体？""有哪些模型服务商？"等）
• 支持上传附件（ 文档 / 图片）
• 可在任意页面使用，不打断当前工作
• 对话结束后可点击「新对话」重置

3.1 模型供应商列表页

进入页面后显示一个表格，包含以下列：

页面顶部右侧有 搜索框 和 「+ 新建供应商」 按钮。

3.2 创建供应商（三步向导）

点击「新建供应商」按钮，弹出创建向导对话框（分 3 步）：

图 4 新建模型供应商向导

第 1 步：基本信息

第 2 步：连接信息

第 3 步：高级设置

点击 「创建」 按钮完成。创建后 API Key 会使用 AES-256-GCM 加密存储。

3.3 编辑供应商

在表格行点击 按钮，弹出编辑向导（与创建类似）：

• API Key 为非必填（留空则保留原有密钥）
• Slug 不可修改（只读显示在对话框标题下方）

3.4 删除供应商

点击 按钮，弹出确认弹窗：

• 标题：「删除供应商」
• 描述：确认删除 "{供应商名称}"？
• 按钮：取消 / 确认删除（红色）

4.1 模型列表页

表格列包括：

页面顶部有搜索框和 「+ 新建模型」 按钮。

图 5 模型列表

4.2 创建模型（四步向导）

图 6 新建模型向导

第 1 步：选择供应商

下拉选择该模型所属的供应商（显示品牌图标 + 名称 + 协议类型）。

第 2 步：基本信息

第 3 步：能力配置

如果模型 ID 被自动识别（匹配种子数据），则：

• Model Purpose 显示为只读标签
• Capabilities 中 chat 和 function_calling 锁定，仅可编辑 图片理解 / 视频理解 / 推理

如果未自动识别（手动输入），你需要选择：

Model Purpose（单选按钮样式，每个有不同颜色图标）

Capabilities（多选标签，仅「对话」用途显示）

推理（Reasoning） 开启后，额外显示「支持思考强度」开关，开启后可选默认思考强度：继承默认值 / 低 / 中 / 高 / 超高。

可见性: 私有 / 团队内

状态: 已启用 / 已停用

第 4 步：生成参数（仅「对话」用途）

点击 「创建」 完成。

4.3 测试模型

在模型列表中点击 按钮，系统立即发送测试请求到该模型。

• 成功: 弹出提示显示回复内容片段和响应延迟（毫秒）
• 失败: 弹出错误提示，显示模型 ID 和请求地址

4.4 编辑/删除模型

编辑操作与创建类似，但所属供应商不可更换。删除需要确认弹窗。

5.1 智能体列表

表格列：

空状态时显示"暂无智能体"，提示"创建对话智能体或代码智能体"，并显示 「新建智能体」 按钮。

图 7 智能体列表

5.2 选择智能体类型

点击「新建智能体」后，首先选择类型：

图 8 智能体类型选择

选择后进入创建向导。对话智能体有 8 步，代码智能体有 9 步（多一个「技能」步骤）。

5.3 第 1 步：基本信息

推理方式详解

5.4 第 2 步：提示词

有两种模式可选：

模式 A：选择已有提示词

• 下拉选择已创建的提示词模板
• 如果还没有提示词，会提示「请先在提示词页面创建」

模式 B：自定义系统提示词

• 系统提示词 — 大文本编辑区，等宽字体，最少高度 240px，最多 5000 字
• 右侧有 AI 辅助生成 按钮，点击后在弹出框中描述需求，AI 自动生成提示词
• 预填充助手回复 — 可选，引导模型以指定内容开头回复，如 {" 强制 JSON 输出

提示词中可以使用 @{snippet-slug} 引用提示词片段，运行时自动替换。

5.5 第 3 步：模型参数

下方显示模型默认参数概要（上下文长度、最大输出、Temperature、Top P），留空则继承模型默认参数。

5.6 第 4 步：内置工具

勾选你想让智能体使用的工具。每个工具显示名称、标识和说明：

勾选 present_ui 后，可配置 A2UI 模板权限：

• 选择「限制」→ 勾选允许使用的 A2UI 模板
• 如未勾选任何模板，智能体将无法展示 A2UI。

5.7 第 5 步：MCP 服务

勾选已创建的 MCP 服务器。空状态提示「暂无 MCP 服务，请先在 MCP 服务页面创建」。

5.8 第 6 步：工作流

勾选已集成的工作流平台。空状态提示「暂无工作流，请先在工作流页面创建」。

5.9 第 7 步：技能（仅代码智能体或对话+沙箱）

勾选已创建的技能包。空状态提示「暂无技能，请先在技能页面创建」。

5.10 第 8 步：语音

启用语音交互 — 开关切换，开启后允许通过录音输入和语音输出对话。

语音模式：

Pipeline 模式需分别选择：

• 语音识别模型（ASR，需支持 speech_to_text）
• 语音合成模型（TTS，需支持 text_to_speech）

Realtime 模式需选择：

• 实时语音模型（需支持 realtime_audio）

其他设置：

5.11 第 9 步：沙箱

对话智能体：显示「启用沙箱」开关，开启后按需启动 Docker 沙箱，允许编写和运行代码。

代码智能体：默认启用沙箱，需选择沙箱模板。

每个步骤底部有「上一步」/「下一步」按钮，最后一步显示 「创建」 按钮。

5.12 直接生成模型（图片/视频）的特殊情况

如果选择的模型输出形态为图片或视频，页面顶部会显示蓝色提示框：

"该模型是直接生成图片/视频的模型，不支持工具调用链。已自动跳过 MCP、内置工具、工作流、语音和沙箱配置。"

此时向导自动缩减为「基本信息」和「提示词」两步。

5.13 删除智能体

在列表中点击 按钮，弹出确认弹窗：「确认删除 "{名称}"？此操作不可撤销。」

在列表行点击 按钮，打开与创建相同的多步向导，已预填现有配置。

与创建的区别：

• Slug 不可修改（只读显示）
• 步骤数量和结构与创建一致
• 最后一步按钮显示 「保存」 而不是「创建」

7.1 对话界面布局

对话页面分三个主要区域：

1. 左侧可收起 — 会话历史侧边栏（280px 宽）
2. 中间主体 — 消息列表 + 底部输入区
3. 右侧可弹出 — 预览面板（显示 Web 预览 / Markdown 内容）

图 9 对话界面

7.2 选择智能体

页面顶部有模式切换按钮：

• Agent — 单智能体对话模式
• Team — 团队对话模式（需团队功能开启）

下拉选择要对话的智能体（或团队），显示名称和类型标签（代码智能体有紫色标签）。

7.3 发送消息

输入框位于底部，支持：

• 文字输入 — 支持 Markdown 格式、@ 提示词引用、{{变量}} 语法高亮
• Enter 发送 / Shift+Enter 换行
• 文件上传 — 点击 按钮上传文档，点击 上传图片
• 语音输入 — 按钮录音（需配置语音模型）
• 拖拽上传 — 将文件拖入输入区
• 快捷建议 — 空对话时显示 3 个预设问题按钮

支持的图片格式：avif, bmp, gif, heic, jpeg, jpg, png, svg, webp

支持的文档格式：md, txt, json, csv, xml, yaml, html, css, js, ts, tsx, py, java, go, rs, sql, sh, log

7.4 AI 回复展示

AI 回复以气泡形式展示，包含：

• 头像 — 用户蓝色头像 / AI 白色头像
• 角色标签 — "You" / 智能体名称
• 时间戳
• 文本内容 — Markdown 渲染
• 思考过程 — 可折叠展开（⏳ 正在思考…）
• 工具调用 — 显示工具名称和状态（执行中 / 完成 失败）
• 代码产物 — 代码/网页应用内联展示
• Web 预览 — 显示标题和 链接
• 参考资料 — 引用来源列表

消息操作（鼠标悬停显示）：

7.5 停止生成

生成过程中，发送按钮变为 ■ 停止 按钮，点击后停止 AI 回复。

键盘快捷键：

• Esc — 按一次预备停止，再按一次确认停止

7.6 会话管理

左侧会话侧边栏（点击顶部 按钮展开）：

• 会话按时间分组：已置顶 / 今天 / 昨天 / 最近 7 天 / 最近 30 天 / 更早
• 每个会话显示标题（无标题显示 ID 前 8 位）和相对时间
• 右键或点击 ⋮ 菜单：
• 置顶 / 取消置顶
• 重命名
• 删除

7.7 上下文状态

点击底部的上下文进度条，展开详情卡片：

• Session ID
• 上下文使用进度条（已用 / 总容量）
• Segments 组成条形图

8.1 提示词列表页

表格列：

操作按钮（从左到右）：

1. Versions — 查看版本历史
2. Publish — 发布新版本
3. Edit Content — 编辑提示词内容
4. Edit — 编辑基本信息
5. Delete — 删除

页面顶部有搜索框和 「+ 新建提示词」 按钮。

图 10 提示词列表

8.2 分类说明

8.3 创建提示词

点击「新建提示词」，弹出对话框填写：

8.4 编辑提示词内容

在操作列点击 Edit Content，打开左右分栏编辑器：

左侧 — 内容编辑区

等宽字体编辑区，支持语法高亮：

• {{变量名}} — 蓝色高亮（自定义变量）
• @{slug} — 绿色高亮（引用其他提示词）
• 输入 @ 触发提示词选择下拉
• 输入 {{ 自动补全 }}

点击 AI 辅助生成 按钮，输入需求让 AI 帮你写提示词。

右侧 — 变量配置面板（384px）

自动检测内容中的 {{varName}} 变量，每个变量可配置：

内置变量（点击即可插入）：

8.5 发布版本

点击 Publish 按钮，填写：

发布后该版本锁定，编辑内容将创建新的草稿版本。

8.6 版本历史

点击 Versions 查看所有已发布版本，按时间倒序排列，显示版本号、发布时间、发布说明，以及内容预览（前 96 字）。

图 11 MCP 服务列表

9.1 创建 MCP 服务器（两步向导）

第 1 步：基本信息

第 2 步：请求头配置

9.2 查看工具列表

在列表中点击 按钮，查看该 MCP 服务器提供的工具：

• 工具按名称搜索
• 每个工具显示名称、参数列表（必填参数有红色 * 标记）、描述
• 如果服务器未连接，显示"连接中…"

9.3 配置用户凭证

在列表中点击 按钮，配置当前用户的 MCP 凭证：

• 输入 API Token
• 已有凭证时显示绿色提示「已配置此 MCP 服务器的凭证」
• 可删除已有凭证

图 12 技能列表

10.1 上传技能

点击「+ 新建技能」，支持：

• 拖放上传 或 点击选择 .skill 或 .zip 文件
• 填写的字段：

10.2 查看技能结构

点击 按钮，查看技能包内部的目录结构：

SKILL.md [md] 蓝色 — 技能描述文档

scripts/  绿色 — 可执行脚本（含语言标签）

references/ [md] 紫色 — 参考文档

assets/ — 琥珀 — 资源文件

右侧面板支持预览图片、查看脚本源代码。

工作流支持将外部平台作为智能体的工具使用。支持以下类型：

创建时需填写名称、类型、连接地址和认证信息。创建后可点击「测试连接」验证配置是否正确。

图 13 工作流列表

图 14 团队列表

12.1 创建团队（四步向导）

第 1 步：基本信息

第 2 步：选择 Leader

选择一个智能体作为团队的 主管（Leader），负责规划、分配任务和汇总结果。

第 3 步：添加成员

逐一添加团队成员：

• 选择智能体
• 填写角色描述（如 "数据分析师"）
• 点击「+ 添加成员」继续添加

第 4 步：高级设置

12.2 三种编排模式

主管模式（Supervisor）

Leader 规划并分配任务

 ├── Worker A（执行子任务）

 ├── Worker B（执行子任务）

 ├── Worker C（执行子任务）

 └── 质量审核 → 汇总结果

适合：需要领导统筹、分工协作的复杂任务。

管道模式（Pipeline）

Agent A → Agent B → Agent C → Agent D

（步骤1） （步骤2） （步骤3） （步骤4）

适合：有固定处理流程、前后依赖的任务。

并行模式（Parallel）

输入 → Agent A, Agent B, Agent C 同时执行

 ↓

 Leader 汇总去重

适合：需要从多个角度分析同一问题的场景。

12.3 运行团队

在团队列表点击 运行 按钮：

1. 输入阶段: 填写任务描述，点击开始
2. 执行阶段: 实时显示每个成员的计划和步骤

• 执行中 ⏳ 蓝色
• 完成 绿色
• 失败 红色
• 等待审批 ⏰ 琥珀色

1. 人工审批: 如果遇到需要确认的步骤，显示审批面板（可批准/拒绝并填写反馈）
2. 完成: 显示最终汇总结果

13.1 个人空间 vs 团队空间

13.2 创建新团队

在空间切换器中选择「新建团队」，填写名称和描述。创建后你自动成为该团队的所有者。

13.3 邀请成员

1. 进入团队管理页，点击 「+ 邀请成员」
2. 选择角色：成员 / 管理员 / 访客
3. 点击「创建链接」生成邀请 URL
4. 复制链接发送给要邀请的人

13.4 成员角色权限

13.5 成员管理操作

在成员表格中，管理员可对每个成员执行：

13.6 申请加入团队

在空间切换器中选择「申请团队」：

1. 输入团队名称搜索
2. 选择目标团队
3. 填写申请消息（可选）
4. 提交后等待团队管理员审批

13.7 接受邀请

收到邀请链接的用户访问后：

• 如果已登录 → 显示接受邀请页面，包含团队信息和过期时间
• 如果未登录 → 先登录再接受
• 如果链接已过期或无效 → 显示"邀请无效或已过期"

14.1 记忆项目

记忆页面顶部有三个 作用域切换 标签：

图 15 记忆管理页

14.2 指令文档

项目卡片展示项目名称和相关信息。展开后可管理指令文档列表：

每条指令包括：

• 序号
• 标题
• 更新时间
• 内容（Markdown 格式，支持拖拽排序）

创建/编辑指令：

15.1 语音设备列表

表格列：

15.2 创建设备

点击「+ 创建设备」，填写：

创建成功后弹出 Token — 这是唯一一次展示，请立即复制保存。

16.1 A2UI 是什么

A2UI（Agent-to-UI）让智能体不仅能输出文字，还能直接渲染交互式 UI 界面，如信息卡片、确认对话框、表单、数据表格、步骤向导等。

图 16 A2UI 管理页

16.2 模板管理

页面顶部有过滤选项：

• 来源: 全部 / 系统内置 / 自定义
• 分类: 下拉选择特定分类

点击 「+ 创建模板」 打开三步向导：

第 1 步：基本信息

名称、Slug、分类、可见性、描述。

第 2 步：设计

选择组件类型：

根据类型不同，配置不同的 Props 字段。可通过 Data Contract Designer 绑定数据来源。

第 3 步：操作

配置用户交互后的行为：

17.1 凭证列表

以卡片形式展示每个凭证：

• 名称 + 状态标签（启用/禁用）
• 权限范围标签（Shield 图标）
• 调用次数 + 最后使用时间
• App Key — 显示文本 + 复制按钮
• App Secret — 默认隐藏为 ••••••••••••••••，点击 查看明文 + 复制

17.2 创建凭证

点击「创建凭证」：

图 17 创建 API 凭证（仅展示表单，不含密钥）

1. 填写 名称（如 "Production"、"Testing"）
2. 填写 描述（可选）
3. 选择权限范围（复选框，分组列出）：

全局权限

按资源分组

• 智能体: 读取 / 写入 / 执行
• 会话: 读取 / 写入 / 删除
• 提示词: 读取 / 写入 / 删除
• 供应商: 读取 / 写入
• MCP: 读取 / 写入
• 技能: 读取 / 写入
• 团队: 读取 / 写入 / 删除
• 记忆: 读取 / 写入 / 删除

底部显示已选数量。

17.3 使用凭证调用 API

凭证可用于程序化访问。页面底部提供代码示例（支持 cURL、TypeScript、Python），包含：

# 1. 获取 Token

POST /api/auth/token

Body: {"appKey": "...", "appSecret": "..."}

# 2. 使用 Token 调用 API

Authorization: Bearer 

# 3. 刷新 Token

POST /api/auth/refresh

Body: {"refreshToken": "..."}

从右侧滑出的抽屉面板，包含以下设置：

图 18 系统设置

18.1 默认模型

模型下拉按供应商分组显示。

18.2 主题

三个图标按钮切换： 浅色 / 深色 / 跟随系统

18.3 语言

下拉选择：中文 / English / 日本語 / 한국어 / 繁體中文 / Français

18.4 内置工具配置

为租户级别的内置工具配置全局凭证（如搜索 API 密钥等）。

19.1 安装与登录

# 配置 API 地址

tclaw config set api-url http://localhost:4000

# 登录（通过 Token）

tclaw login --url http://localhost:4000 --token your-token

# 或通过凭证登录

tclaw login --key your-app-key --secret your-app-secret

# 查看配置

tclaw config show

19.2 常用命令速查

# 列出所有智能体

tclaw agent list

# 创建智能体

tclaw agent create \

 --name "数据分析助手" \

 --slug data-analyst \

 --model \

 --type chat \

 --reasoning-mode react \

 --system-prompt "你是一个数据分析师"

# 运行智能体（流式输出）

tclaw agent run my-agent "你好"

# 查看上下文状态

tclaw agent context-status my-agent --session 

# 列出供应商

tclaw provider list

# 创建供应商

tclaw provider create \

 --name "我的 OpenAI" \

 --slug my-openai \

 --type openai \

 --api-key sk-xxx

# 列出会话

tclaw session list

# 查看 MCP 服务工具

tclaw mcp tools 

19.3 全部命令一览