智能体（Agent）

概述

智能体页面（侧边栏菜单 智能体）是工作空间中浏览和使用 AI 代理的入口。它支持两种代理类型：

A2A 协议代理：第三方按 A2A 协议对外提供的标准化 Agent，添加一个 URL 即可对话
传统代理（QuestionAnswer / Flow 类型）：在 GPTBots 平台上发布的智能体，通过 iframe 嵌入

关键差异：和 Claw 不同，智能体页面是一个应用市场 —— 你调用的是别人或自己已经做好的 Agent，而不是从零开始一次任务。

入口

Web：https://www.gptbots.ai/工作区/agent
APP：左侧菜单"智能体"

列表视图

智能体以卡片网格形式展示：

元素	说明
图标 + 名称	代理头像和显示名称
类型徽章	`Agent`（传统代理）或 `A2A`（A2A 协议代理）
描述	代理能力简介
统计	使用次数、收藏数等
收藏星标	点击收藏，收藏后可在"我的收藏"快速找到

筛选

顶部分类标签：全部 / Default / 自定义分类（如财务 / 行政 / 产研 / 法务）
关键词搜索：右上角搜索框
我的收藏：右上角按钮，仅显示已收藏的代理

A2A 代理

添加 A2A 代理

通过 Agent Card URL 添加标准 A2A 协议代理：

在智能体页面，点击 添加 A2A 代理 按钮（仅管理员）
输入代理的 Agent Card URL（例如 https://agent.example.com/.well-known/agent.json）
系统自动获取代理信息（头像、名称、描述、能力列表）
设置分类和显示名称
保存后代理出现在列表中

什么是 Agent Card URL？ 它是第三方 A2A 代理暴露的 HTTP 端点，返回代理的身份描述信息（JSON 格式）。通常由代理开发者提供。

A2A 对话

点击代理卡片进入 A2aChatView 对话界面：

功能	说明
SSE 流式响应	实时接收代理回复
结构化响应	支持 text / file / data / a2ui 四种内容块
会话管理	自动复用已有会话，或强制新建
消息历史	浏览历史对话记录

结构化响应类型：

Part 类型	渲染方式
`text`	Markdown 渲染（含数学公式、代码高亮、表格）
`file`	文件附件（内联图片或下载链接）
`data`	JSON 数据（代码块格式展示）
`a2ui`	Agent-to-UI 交互组件（A2UIRenderer 渲染）

协议技术详解请参考 A2A 协议。

跨账号调用

A2A 代理支持跨账号 Gateway 派发 —— 当一个用户从 Web 端调用 enterprise 范围的代理时，请求会通过 Gateway 路由到目标节点执行。详见多节点架构 — 权限弹窗分发规则。

传统代理

传统代理（QuestionAnswer / Flow 类型）通过 iframe 嵌入 Space Web 的代理详情页面。

类型	说明
QuestionAnswer	问答型代理，基于 RAG 知识库
Flow	流程型代理，基于编排好的工作流

点击传统代理卡片后，进入 AgentDetailPage，嵌入 Space Web 的 /space/agent-details/{botId} 页面。

权限控制

角色	操作
所有成员	浏览列表、搜索、筛选、收藏、与代理对话
管理员	添加、编辑、删除代理

管理员权限通过 canManageAgents() 检查（角色为 Owner / Admin 或具备特定权限码）。

操作指南

如何添加 A2A 代理

在开发空间构建发布Agent后，可以在集成页面点击发布到工作空间。
在工作空间-空间管理-企业资源-Agent页面，管理员可以审核是否上线。
审核通过后，该Agent将展示在工作空间列表中，在工作空间侧边栏点击 智能体
找到自己刚上线的Agent，点击卡片即可进入对话界面

如何与代理对话

在智能体页面找到目标代理卡片
点击卡片进入对话界面
输入消息，按 Enter 发送
等待代理回复（SSE 流式，实时显示）

提示：系统默认复用上一次的会话。如果想开启全新对话，点击"新建会话"按钮。

常见问题

代理连接失败

确认 Agent Card URL 可从当前网络访问
确认 URL 是 HTTPS 且非内网地址（系统有 SSRF 防护）
如果代理需要认证，确认 authType 和凭证配置正确

代理回复为空或格式异常

可能是代理端问题，尝试重新发送
检查代理是否支持中文（部分代理可能只支持英文）