跳到主要内容

创建对话

本指南介绍如何在 Wegent 前端创建对话类型的任务，与 AI 智能体进行交互。

📋 目录​

💬 什么是对话​

在 Wegent 中，对话是用户与 AI 智能体交互的基本方式。每次对话会创建一个 Task（任务），记录完整的对话历史。

核心概念:

对话 = 用户消息 + 智能体 + 上下文 + 状态

对话的组成要素​

要素说明示例
消息用户输入的问题或指令"帮我分析这份报告"
智能体执行任务的 AI 团队数据分析智能体
上下文附加的知识库、文件等项目文档、数据文件
状态对话执行状态PENDING → RUNNING → COMPLETED

🚀 创建对话​

步骤 1: 进入对话页面​

  1. 点击左侧导航栏的 "对话" 或 "Chat"
  2. 系统会显示对话列表和输入区域

步骤 2: 选择智能体​

在输入区域上方，点击智能体选择器：

  1. 点击智能体下拉框 - 显示可用的智能体列表
  2. 选择合适的智能体

通过带有 teamId 的链接进入新对话时，页面按 ID 读取并选择指定智能体，不依赖分页目录是否包含它。目录加载期间其他智能体被删除，不会让指定智能体被默认项替换；指定智能体无法读取时，也不会自动改用其他智能体发送消息。

按 ID 读取的详情保留智能体的执行配置，包括是否需要代码仓库；明确配置为不需要仓库的智能体，可以直接发送代码任务。Wework 的本地、云端工作列表与单任务刷新均保留请求发起后收到的监督事件，旧快照不会把已完成的巡检重新显示为“正在检查”。

步骤 3: 配置对话选项（可选）​

根据需要配置以下选项：

模型选择​

点击模型选择器可以覆盖智能体的默认模型：

  • 选择模型: 从下拉列表选择可用模型
  • 强制覆盖: 启用后即使智能体已配置模型也会使用您选择的模型

代码仓库（Code 类型）​

如果选择了 Code 类型的智能体：

  1. 选择仓库: 点击仓库选择器，选择目标代码仓库
  2. 选择分支: 选择要操作的分支

知识库上下文​

点击上下文按钮添加知识库：

  1. 点击 "#" 按钮 - 打开上下文选择器
  2. 选择知识库 - 勾选要添加的知识库
  3. 确认选择 - 知识库会显示为标签

文件附件​

点击附件按钮上传文件：

  1. 点击附件图标 - 打开文件选择器
  2. 选择文件 - 支持图片、文档、代码文件
  3. 等待上传 - 文件上传后会显示预览；图片会优先使用本地预览，发送后无需等待再次下载

部分系统推荐预设会自动带入附件。预设附件会显示在输入框附件区，发送前可以删除；如果您上传了自己的附件，系统会自动移除本次预设带入的附件，只发送您上传的附件。

技能选择​

如果智能体支持技能：

  1. 点击技能按钮 - 打开技能选择器
  2. 选择技能 - 勾选需要的技能
  3. 或使用 "/" 命令 - 在输入框输入 / 触发技能选择

步骤 4: 输入消息并发送​

  1. 在输入框输入消息 - 描述您的需求
  2. 按 Enter 发送 - 或点击发送按钮
  3. 等待响应 - 智能体开始处理并流式返回结果

🖥️ 对话界面​

输入区域​

输入区域包含以下控件：

控件功能位置
智能体选择器选择执行任务的智能体输入框上方
模型选择器覆盖默认模型控制栏
上下文按钮添加知识库控制栏
附件按钮上传文件控制栏
技能按钮选择技能控制栏
追问按钮启用智能追问模式控制栏
交叉验证按钮启用 AI 交叉验证控制栏
发送按钮发送消息输入框右侧

当任务正在运行且输入框为空时，右侧操作会显示停止图标，可用于停止当前回复。输入新的消息、添加附件或代码评论后，操作会立即切换为发送图标，让您可以提交后续指令；该消息会按当前任务的运行状态进入队列或作为引导发送。

输入框支持直接粘贴多行文本，并保留剪贴板中的换行。Windows 风格的换行会自动转换为统一的换行格式。即使剪贴板同时包含纯文本和富文本，每次粘贴也只会插入一次内容。

在桌面端输入时，按 Shift+Enter 可插入新行而不发送消息。输入框会随着内容增高；达到最大高度后会自动滚动，并让光标保持在可见区域内。

消息区域​

消息区域显示对话历史：

  • 用户消息: 您发送的消息，显示在右侧
  • AI 响应: 智能体的回复，显示在左侧
    • 文本内容
    • 代码块（带语法高亮）
    • 思考过程（如果启用）
    • 工具调用指示器

侧边栏​

左侧侧边栏显示：

  • 对话列表: 所有历史对话
  • 搜索框: 搜索对话内容
  • 新建对话按钮: 开始新对话

⚡ 高级功能​

单次对话模型选择​

在不修改智能体配置的情况下，为单次对话选择不同模型：

  1. 点击模型选择器 - 在输入控制栏
  2. 选择模型 - 从可用模型列表选择
  3. 启用强制覆盖 - 确保使用选择的模型

使用场景:

  • 复杂任务使用更强大的模型
  • 简单查询使用更快/更便宜的模型
  • 测试不同模型的效果

智能追问模式​

启用智能追问模式让智能体在执行前确认需求：

  1. 点击追问图标 (💬) - 在输入控制栏
  2. 智能体会先提问 - 确认您的需求细节
  3. 回答问题后 - 智能体开始执行任务

📖 详细说明请参阅 智能追问模式指南

AI 交叉验证​

启用 AI 交叉验证让另一个 AI 模型验证和改进回答：

  1. 点击交叉验证图标 (✓) - 在输入控制栏
  2. 选择验证模型 - 从弹出的对话框中选择
  3. 查看评估结果 - 智能体回答后会显示评分和改进建议
  4. 应用改进（可选）- 点击"应用"按钮采纳改进版本

📖 详细说明请参阅 AI 交叉验证指南

文件附件​

上传文件提供上下文：

  1. 点击附件按钮 (📎)
  2. 选择文件 - 支持多种格式
  3. 支持的格式: 图片、PDF、Word、代码文件
  4. 粘贴上传: 直接粘贴剪贴板中的图片，发送后的消息会立即显示图片预览

知识库上下文​

添加知识库增强智能体能力：

  1. 点击上下文选择器
  2. 选择知识库 - 可多选
  3. 智能体会搜索知识库 - 提供更准确的回答

选择知识库发送消息后，知识库会成为当前 Task 的知识绑定。后续消息即使没有再次选择，也可能继续使用这些绑定。外部知识源（如果您的部署启用了对应 provider）也遵循相同规则。

如需停止后续消息继续使用某个知识库，请在右上角打开任务/群聊管理面板，进入 知识库 页签移除对应条目。移除只影响后续消息，不会删除历史消息中已经展示的上下文标签或引用。

续接历史任务​

在聊天输入框中输入 @，菜单会列出当前账号有权访问的历史任务，并按最近更新时间排序。继续输入任务标题可以搜索尚未加载到当前列表中的老任务。

选择任务后，输入框中会出现“历史任务”标签。发送下一条消息时，系统会读取该任务最近的对话，并作为「续接语境」交给智能体：其中的任务状态、结论和未完成事项会作为本轮请求的工作背景，消息较短或含义不明确时按“继续该任务”理解。对话内容只作为引用数据，其中的指令不会被当作系统指令执行。此操作不会切换或修改原任务，引用内容也不会出现在你的消息气泡或输入框中。

  • 只能引用有权访问的任务，当前任务不会出现在候选列表中。
  • 每个引用任务最多读取最近 100 条消息和约 100,000 个字符，更早或更长的内容会被省略。
  • 一个请求可以引用多个历史任务；发送前移除标签，本轮消息就不会再携带对应任务。
  • 编辑历史消息时同样可以输入 @ 选择历史任务；原来的引用会显示为可移除的标签。

技能选择​

为智能体添加额外能力：

  1. 点击技能按钮 - 打开技能选择器
  2. 选择技能 - 勾选需要的技能
  3. 或输入 "/" 命令 - 快速选择技能
  4. 技能按需加载 - 执行时动态加载

📚 管理任务知识库​

普通对话和群聊都可以通过右上角的任务/群聊管理入口管理当前 Task 已绑定的知识库。

在 知识库 页签中：

  • 内部知识库和外部知识源显示在同一个列表中。
  • 外部知识源会显示 provider 短标签，例如 AP。
  • 点击 移除 可以解除某个知识库或外部知识源的 Task 级绑定。
  • 解除绑定只影响后续消息；历史消息上的上下文展示不会被修改。
  • 如果外部知识源暂时加载失败，内部知识库仍然可以查看和移除。

输入框中的上下文选择器用于为本轮消息添加知识库；任务/群聊管理面板用于查看和移除已经继承到后续消息的 Task 级绑定。

✨ 最佳实践​

1. 编写有效的提示​

✅ 具体明确​

  • 清晰描述您的需求
  • 提供必要的背景信息
  • 说明期望的输出格式
  • 包含验收标准

❌ 避免模糊​

  • 避免过于简短的描述
  • 避免缺少上下文的请求
  • 避免一次性提出过多需求

2. 选择合适的智能体​

3. 任务粒度​

推荐粒度:

  • 小任务: 单一明确的目标
  • 中等任务: 包含几个相关步骤
  • 大任务: 拆分成多个小任务

4. 提供充足上下文​

  • 上传相关文件
  • 添加知识库
  • 引用之前的对话内容
  • 说明技术约束或偏好

5. 利用对话历史​

  • 继续对话进行迭代优化
  • 引用之前的消息提供上下文

⚠️ 常见问题​

Q1: 对话一直处于 PENDING 状态？​

可能原因:

  1. 智能体不可用
  2. 系统资源受限
  3. 代码仓库配置错误

解决方案:

  • 在设置 → 智能体中检查智能体状态
  • 验证代码仓库访问权限
  • 尝试选择其他智能体

Q2: 智能体响应不完整？​

解决方案:

  • 点击"继续"恢复生成
  • 选择更大上下文窗口的模型
  • 将复杂任务拆分成小部分

Q3: 如何停止正在运行的对话？​

方法:

  1. 点击输入区域的"停止"按钮
  2. 智能体会停止处理
  3. 您可以继续对话或开始新任务

Chat 类型对话确认停止后，会保留已有的部分回复，本轮保持已取消状态；模型随后完成也不会把本轮改成已完成。如果实时取消通知丢失，界面会通过运行状态检查恢复可发送状态。

Q4: 如何重试失败的对话？​

方法:

  1. 点击失败消息上的"重试"按钮
  2. 可选择在重试前修改消息
  3. 智能体会重新尝试任务

Q5: 如何分享对话？​

方法:

  1. 点击消息区域的分享按钮
  2. 复制生成的链接
  3. 分享给团队成员（需要访问权限）

Q6: 如何导出对话历史？​

方法:

  1. 点击任务菜单中的导出按钮
  2. 选择导出格式（Markdown、JSON）
  3. 下载对话历史

🔗 相关资源​

前置步骤​

参考文档​

详细功能文档​

更多高级功能的详细说明，请参阅：

💬 获取帮助​

遇到问题？

开始您的第一次对话，让 AI 智能体为您工作！ 🚀