Bot 管理

前置知识： 阅读本文前建议先了解 核心概念 中的资源模型和权限模型部分。

Bot 是 Monstrum 平台中受管的 AI 行为主体。本文详细介绍 Bot 的创建、配置、资源绑定、渠道接入、生命周期管理等全部操作。

概述

Bot 是 Monstrum 平台的核心实体。每个 Bot 拥有独立的：

  • 身份 — 名称、描述、所属工作区
  • 权限 — 通过角色分配和资源绑定控制可用的工具和操作范围
  • 资源绑定 — 决定 Bot 可以访问哪些外部系统（SSH 服务器、MCP 工具、其他 Bot 等）
  • 凭据隔离 — Bot 永远接触不到明文凭据，由平台在执行时解密注入
  • 记忆 — 跨会话持久化的知识库，支持自动提取和手动管理
  • 预算 — 月度 Token 消耗上限，超预算自动停止执行

Bot 遵循平台的核心安全原则：最小权限（未授权的工具对 Bot 完全不可见）、凭据隔离（LLM 全程无法接触密钥）、Fail-Closed（任何环节出错，Bot 什么也做不了而非不受限制）。

创建 Bot

导航

在左侧导航栏点击 Bot 管理，进入 Bot 列表页面。

创建步骤

  1. 点击页面右上角的 创建 Bot 按钮
  2. 填写基本信息：
    • Bot 名称 — 必填，在工作区内唯一。建议使用能体现职责的名称，如”运维巡检”、“客服助手”
    • 描述 — 可选，描述 Bot 的定位和职责。此描述会被注入到系统提示词中，帮助 LLM 理解自己的角色
  3. 点击 创建

Bot 创建后默认处于”运行中”状态，使用工作区默认的 LLM 提供商和模型。你可以立即在概览页与它对话，也可以先进入设置页进行详细配置。

如果工作区尚未配置任何 LLM 提供商，页面会提示”未配置 LLM 提供商”，需要先前往 LLM Providers 页面添加提供商。

Bot 详情页

点击 Bot 卡片或在列表中点击 Bot 名称，进入 Bot 详情页。详情页通过 Tab 组织不同功能区域：

Tab说明
概览Bot 状态概览 + 内置对话界面
资源配置管理 Bot 绑定的 Resource 和权限
消息渠道配置 Slack、飞书、Telegram 等 IM 接入
执行历史查看历史任务的执行记录和详情
定时任务配置周期性自动执行的任务
工作流管理与 Bot 关联的工作流及绑定模式
记忆查看和管理 Bot 的持久化记忆
提示词自定义 Bot 级别的提示词模板
设置Bot 的身份、模型、约束、能力等全部配置

概览 Tab

概览 Tab 是进入 Bot 详情页的默认视图，包含两个主要区域。

状态面板

页面上方展示 Bot 的关键运行指标：

  • 当前状态 — 运行中 / 已暂停 / 已禁用
  • 本月费用 — 当月 Token 消耗折算的 USD 金额，附日均费用
  • 调用效率 — LLM 调用次数和资源调用次数
  • 权限通过率 — 工具调用中通过权限校验的比例，以及被拒绝的次数
  • Token 消耗 — 累计消耗的 Token 数量
  • 模型 — 当前使用的 LLM 模型
  • 快捷操作 — 创建任务、查看任务历史

对话界面

页面下方内嵌了一个完整的对话界面，你可以直接与 Bot 进行交互：

  • 在输入框中输入消息，按回车发送
  • Bot 会使用配置的 LLM 进行推理并回复，支持流式输出
  • 如果 Bot 调用了工具，界面会展示工具调用的名称、参数和执行结果
  • 点击 新对话 开始全新会话，清除之前的对话上下文
  • 点击 结束会话 主动关闭当前会话，触发记忆提取（如已开启自动记忆）

关于对话功能的详细说明，请参阅 对话交互。

设置 Tab

设置 Tab 是 Bot 的核心配置页面，包含身份与行为、模型配置、执行与约束、Agent 能力等多个配置区域。

身份与行为

系统提示词

系统提示词决定了 Bot 的身份认知和行为方式。

  • 自定义提示词 — 在文本框中输入你希望 Bot 遵循的指令。例如：“你是一个专业的运维工程师，擅长服务器监控和故障排查。在执行任何危险操作前，先向用户确认。”
  • 留空使用默认 — 不填写时，Bot 使用工作区级别的默认模板（如果工作区也未自定义，则使用平台内置的默认模板）

重要提示： 自定义系统提示词只替换基础模板部分。以下内容始终会自动附加到系统提示词末尾，无需手动添加：

  • 可用资源摘要 — 根据 Bot 绑定的 Resource 自动生成的工具说明
  • Bot 记忆 — 从记忆库中加载的相关记忆条目
  • 技能指令 — 已启用的技能的详细操作说明
  • 推理模式指令 — 计划式或自适应模式的框架说明

Bot 名称与描述

你也可以在设置中修改 Bot 的名称和描述。描述内容会被注入到系统提示词中，建议用一两句话概括 Bot 的职责。

模型配置

LLM 提供商

默认情况下，Bot 使用工作区的默认 LLM 提供商。你可以为特定 Bot 选择不同的提供商：

  1. 在”LLM 提供商”下拉框中选择一个已配置的提供商
  2. 如果需要新建提供商，点击 新建提供商 直接跳转创建

选择”使用工作空间默认提供商”可恢复为默认。

模型选择

选择提供商后，模型下拉框会展示该提供商支持的所有模型。选择适合你场景的模型：

  • 复杂推理和多步工具调用：建议选用能力较强的模型
  • 简单对话和分类：可以选用更轻量的模型以降低成本

Temperature

Temperature 控制 LLM 输出的随机性：

  • 0 — 输出最确定，适合需要稳定可重复结果的场景（如运维操作）
  • 0.5-0.7 — 平衡创造性和一致性，适合大多数场景
  • 1 — 输出最多样化，适合创意写作等场景

执行与约束

最大迭代次数

控制 Bot 在单次任务中的推理-工具调用循环上限。每一轮循环包含：LLM 推理 -> 工具调用 -> 获取结果 -> 再次推理。

  • 默认值通常能满足大部分场景
  • 如果 Bot 需要处理复杂的多步操作（如依次执行多个命令），可以适当调高
  • 达到上限后，Bot 会停止执行并在回复中提示”已达到最大执行轮次”

超时时间

单次任务的超时秒数。超过此时间后，任务会被强制终止。

  • 对于简单对话场景，默认值即可
  • 对于涉及长时间工具调用的任务（如大文件传输、复杂查询），建议适当调高
  • 超时后，Bot 会在回复中提示”请求超时”

月度预算

以 USD 为单位设置 Bot 的月度 Token 消耗上限。

  • 预算警告 — 当月消耗达到预算的 80% 时，平台会发送预算警告通知
  • 自动停止 — 当月消耗达到 100% 时，Bot 自动停止执行新任务，直到下月预算重置
  • 留空 — 不设置预算上限（不建议在生产环境中这样做）

你可以在概览 Tab 的状态面板中查看当前的月度费用和日均消耗。

Agent 能力

推理模式

推理模式决定了 Bot 处理任务的方式：

模式行为适用场景
响应式（reactive）收到消息后直接推理和执行，不做前置规划简单对话、单步操作
计划式（planning）先输出执行计划，再按计划逐步执行多步操作、需要可预测的执行路径
自适应（adaptive）先制定计划，执行过程中根据结果反思并调整计划复杂任务、结果不确定的场景
  • 响应式是默认模式，消耗 Token 最少
  • 计划式和自适应模式会额外消耗 Token（用于生成和维护计划），但在复杂任务中能提供更好的结果

自动记忆提取

开启后，Bot 会在以下时机自动从对话中提取有价值的信息并保存到记忆库：

  • 任务完成 — Task 模式下任务执行结束后
  • 会话过期 — Session 模式下会话因空闲超时自动关闭时

提取的记忆会自动分类（用户偏好、规则、事件、知识等）并评估重要程度。下次对话时，相关记忆会被注入到系统提示词中，帮助 Bot “记住”之前的交互。

关于记忆系统的详细说明，请参阅本文的”记忆管理”章节。

自建定时任务

开启后，Bot 可以在对话过程中自行创建定时任务。例如，你可以对 Bot 说”每天早上 9 点帮我检查服务器状态”，Bot 会自动创建一个对应的定时任务。

关闭此选项后，定时任务只能由用户在定时任务 Tab 中手动创建。

技能

技能是预定义的指令集，可以为 Bot 注入特定领域的操作知识。

  1. 在技能选择器中勾选要启用的技能
  2. 被选中的技能指令会附加到 Bot 的系统提示词中
  3. 技能来源于技能管理页面（左侧导航栏 技能），支持上传自定义技能包

资源配置 Tab

资源配置 Tab 管理 Bot 与 Resource 之间的绑定关系。Bot 只能使用已绑定的 Resource 提供的工具——未绑定的 Resource 对 Bot 完全不可见。

绑定资源

  1. 点击 绑定资源 按钮
  2. 在下拉框中选择要绑定的 Resource（需要先在 资源管理 页面创建）
  3. 选择凭据（如果 Resource 有多个 Credential，选择一个；如果只有一个，自动选中）
  4. 配置权限：
    • 静态工具类型（SSH、Bot、Web3 等）：选择允许的操作，如 ssh_execute、balance.get 等。留空表示允许所有操作
    • 动态工具类型（MCP、Monstrum Agent）：展示已发现的工具列表，勾选允许 Bot 使用的工具
  5. 点击确认完成绑定

通过角色绑定

除了直接绑定 Resource，你还可以通过 Bot 角色 批量授予权限：

  1. 在资源配置页面的”Bot 角色”区域，点击 分配角色
  2. 选择一个已定义的角色
  3. 角色定义的所有资源绑定会自动生效

角色是一组预定义的资源绑定和权限配置的集合，适合需要为多个 Bot 应用相同权限策略的场景。详见 角色与权限。

编辑权限

绑定完成后，你可以随时点击资源条目上的 编辑权限 修改允许的操作范围。修改即时生效，无需重启 Bot 会话。

解绑资源

点击资源条目上的 解绑 按钮移除绑定。解绑后，Bot 在下次推理时将不再看到该 Resource 的工具。

如果没有可绑定的资源，页面会提示前往 资源管理 页面创建。详见 资源与凭据。

消息渠道 Tab

消息渠道 Tab 管理 Bot 的外部 IM 接入。配置后，Bot 可以在 Slack、飞书、Telegram、Discord 等平台中接收和回复消息。

添加渠道

  1. 点击 添加 Gateway
  2. 选择渠道类型：
    • Webhook — 通用 HTTP 回调，适合自定义集成
    • Slack — 需要 Signing Secret 和 Bot Token
    • 飞书 — 需要 App ID 和 App Secret
    • Telegram — 需要 Bot Token
    • Discord — 需要 Bot Token
  3. 填写对应的认证信息
  4. 配置回调 URL（Bot 的回复会发送到此地址）
  5. 保存

渠道管理

创建后，你可以：

  • 启用/禁用 — 临时停用某个渠道而不删除配置
  • 测试连接 — 验证渠道配置是否正确
  • 查看 Webhook URL — 复制此 URL 到对应平台的 Webhook 配置中
  • 删除 — 永久移除渠道配置

每个渠道绑定到一个 Bot。来自该渠道的消息会自动路由到绑定的 Bot 进行处理。

详见 Gateway。

执行历史 Tab

执行历史 Tab 展示 Bot 的所有任务执行记录。

任务列表

列表中每条记录包含：

  • 任务 ID — 唯一标识
  • 指令 — 触发任务的消息内容
  • 状态 — 等待中 / 运行中 / 已完成 / 失败 / 已取消
  • Token — 本次任务消耗的 Token 数量
  • 创建时间 — 任务创建的时间

筛选与搜索

  • 使用搜索框按指令内容模糊搜索
  • 使用状态筛选器按任务状态过滤

任务操作

  • 详情 — 查看任务的完整执行时间线，包括每一轮 LLM 请求、工具调用、权限检查的详细记录
  • 重试 — 对失败的任务重新执行
  • 取消 — 取消正在运行或等待中的任务

执行时间线

点击”详情”进入任务的执行时间线视图，可以看到完整的执行过程：

  1. 任务开始 — 记录触发来源和初始指令
  2. LLM 请求/响应 — 每一轮推理的输入和输出
  3. 工具调用 — 调用了哪个工具、传入了什么参数
  4. 工具结果 — 工具执行的返回值
  5. 权限检查 — 每次工具调用是否通过了 Guardian 的权限校验，以及被拒绝时的原因
  6. 任务完成/失败 — 最终状态和结果

定时任务 Tab

定时任务 Tab 管理 Bot 的周期性自动执行任务。配置后，Bot 会按计划自动执行指定的操作。

创建定时任务

  1. 点击 添加定时任务
  2. 填写配置：
    • 任务名称 — 如”每日巡检”、“周报生成”
    • 执行计划 — 选择频率（每小时/每天/每周/每月）和具体时间，或切换到高级模式使用 Cron 表达式
    • 时区 — 选择执行时区（如 Asia/Shanghai、UTC 等）
    • 任务指令 — 告诉 Bot 触发后执行什么操作，如”检查服务器状态并生成报告”
    • 目标类型 — 选择”发送任务”（直接给 Bot 执行）或”运行工作流”（触发指定的工作流）
    • 立即启用 — 是否创建后马上生效
  3. 保存

执行计划配置

平台提供两种配置方式：

简易模式：

  • 每小时 — 设置在每小时的第几分钟执行
  • 每天 — 设置执行时间（时:分）
  • 每周 — 选择星期几 + 执行时间
  • 每月 — 选择每月第几天 + 执行时间

高级模式（Cron）：

切换到高级模式后，直接输入标准 Cron 表达式。例如：

  • 0 9 * * * — 每天 9:00
  • 0 9 * * 1-5 — 工作日 9:00
  • */30 * * * * — 每 30 分钟

配置完成后，页面会预览接下来的执行时间。

管理定时任务

  • 启用/禁用 — 临时暂停或恢复定时任务
  • 编辑 — 修改任务名称、执行计划或指令
  • 删除 — 永久移除
  • 执行历史 — 查看该定时任务的历史触发记录和每次执行的状态

每条定时任务记录显示上次执行时间和下次执行时间，方便监控。

工作流 Tab

工作流 Tab 管理与当前 Bot 关联的工作流。工作流是可视化的多步自动化流程，可以编排多个步骤、条件分支和并行执行。

工作流绑定模式

Bot 与工作流的关联通过”绑定模式”控制，决定了工作流如何被触发：

绑定模式说明
AI 自动Bot 在对话中根据用户意图自动判断是否触发该工作流
命令用户通过特定命令名触发，如 /deploy
自动+命令两种方式均可触发
未绑定工作流对 Bot 不可用

配置绑定

  1. 进入工作流 Tab，页面列出所有已激活的工作流
  2. 为每个工作流选择绑定模式
  3. 如果选择”命令”或”自动+命令”模式，需要填写命令名称（如 deploy）
  4. 点击 保存 使绑定生效

如果工作区尚无激活的工作流，页面会提示先前往 工作流 页面创建并激活工作流。

使用方式

  • AI 自动模式： 在对话中正常描述需求，Bot 会自动判断是否适合使用某个工作流
  • 命令模式： 在对话中输入命令触发，如”执行 deploy 工作流”

关于工作流的创建和编辑，请参阅 工作流自动化。

记忆管理

记忆 Tab 管理 Bot 的持久化知识库。记忆跨会话保留，帮助 Bot “记住”重要信息。

记忆的来源

Bot 的记忆有两种来源：

  • 自动提取（source=auto）— 开启”自动记忆提取”后，Bot 在任务完成或会话过期时自动从对话中提取
  • 手动添加（source=user）— 用户在记忆 Tab 手动创建的条目

自动提取的记忆会在下次提取时被全量替换（同一作用域内），而手动添加的记忆始终保留，不会被自动覆盖。

记忆分区

记忆按作用域分区存储：

作用域说明注入时机
全局无特定作用域的通用记忆始终注入
渠道关联到特定 Gateway 渠道的记忆对应渠道会话中注入
任务关联到特定任务的记忆对应任务中注入
资源关联到特定 Resource 的记忆使用对应资源时注入
定时任务 / 工作流关联到特定定时任务或工作流的记忆对应上下文中注入

查看记忆

记忆 Tab 展示所有记忆条目，支持：

  • 搜索 — 按关键词搜索记忆内容
  • 分类浏览 — 按分类（用户偏好、规则、事件、知识）筛选

每个条目显示内容、分类和重要程度（1-10 分）。

手动添加记忆

  1. 点击 添加条目
  2. 选择分类：
    • 用户偏好 — 用户的习惯和偏好设置
    • 学到的规则 — Bot 应遵循的规则和约定
    • 重要事件 — 需要记住的关键事件
    • 知识库 — 特定领域的知识信息
  3. 填写记忆内容
  4. 设置重要程度（1-10，数字越大优先级越高）
  5. 保存

编辑与清空

  • 编辑 — 点击条目进入编辑模式，修改内容后保存
  • 清空 — 清除所有记忆条目（不可恢复，需二次确认）

提示词 Tab

提示词 Tab 允许你自定义 Bot 级别的提示词模板。平台使用多个提示词模板来控制不同场景下的 Bot 行为。

三层优先级

提示词模板有三层优先级，从高到低：

  1. Bot 自定义 — 在此 Tab 中设置的模板
  2. 工作区模板 — 在工作区设置中定义的默认模板
  3. 系统默认 — 平台内置的默认模板

每个模板项旁边会标注当前使用的来源（“Bot 自定义”、“工作区”或”系统默认”）。

可配置的模板

模板用途
默认任务提示词Task 模式下的基础系统提示词
默认会话提示词Session 模式下的基础系统提示词
群聊提示词群聊场景的额外指令
计划式推理提示词计划模式下的框架指令
自适应推理提示词自适应模式下的框架指令
记忆提取提示词控制自动记忆提取的行为
对话摘要提示词控制长对话压缩摘要的行为

自定义模板

  1. 点击要修改的模板项
  2. 编辑内容
  3. 保存

点击 重置为工作区默认 可以清除 Bot 级别的自定义，恢复使用工作区或系统默认模板。

大部分场景下不需要修改提示词模板，默认模板已经过优化。建议只在有明确需求时调整，如需要完全改变 Bot 的推理风格或对话策略。

Bot 克隆

当你需要创建一个配置相似的 Bot 时，可以使用克隆功能。

操作步骤

  1. 在 Bot 列表页面，找到要克隆的 Bot
  2. 点击 Bot 卡片上的 克隆 按钮
  3. 确认克隆操作

克隆范围

克隆会复制以下内容：

  • Bot 名称（自动追加后缀以避免重名）
  • 描述
  • 系统提示词
  • 模型配置（提供商、模型、Temperature）
  • 执行约束（最大迭代次数、超时时间、月度预算）
  • Agent 能力配置（推理模式、自动记忆、自建定时任务）
  • 技能配置
  • 资源绑定及权限

克隆不会复制以下内容：

  • 会话历史
  • 记忆条目
  • 执行历史
  • 定时任务
  • 消息渠道配置

Bot 分组

Bot 分组功能帮助你在 Bot 数量较多时进行分类管理。

创建分组

  1. 在 Bot 管理页面，点击 创建分组
  2. 输入分组名称
  3. 确认

管理分组

  • 将 Bot 拖入或添加到分组中
  • 一个 Bot 可以属于一个分组
  • 未分组的 Bot 显示在默认列表中
  • 分组可以重命名或删除

分组仅用于界面上的组织管理，不影响 Bot 的权限或行为。

Bot 间调用关系图

当工作区中有多个 Bot 通过 Bot 类型的 Resource 进行互相调用时，调用关系图可以帮助你可视化这些关系。

查看方式

在 Bot 管理页面，点击 调用关系图 按钮，会以 DAG（有向无环图）的形式展示工作区内所有 Bot 之间的调用关系。

关系图内容

  • 节点 — 每个 Bot 显示为一个节点，包含名称和描述
  • 连线 — 从调用方指向被调用方，表示一个 Bot 绑定了另一个 Bot 作为资源
  • 当前 Bot — 如果从 Bot 详情页进入，当前 Bot 会被高亮标记

典型场景

调用关系图在以下场景特别有用：

  • 排查 Bot 间委托链路中的权限问题
  • 理解编排 Bot（Orchestrator）的调用拓扑
  • 发现冗余或循环的调用关系

暂停与恢复

你可以临时暂停 Bot 而不删除其任何配置。

暂停 Bot

  1. 在 Bot 列表页面，点击 Bot 卡片上的 暂停 按钮
  2. Bot 状态变为”已暂停”

暂停后的影响：

  • Bot 不再接受新任务
  • Gateway 渠道收到的消息不会被处理
  • 定时任务不会触发
  • 已有的配置、记忆、历史记录全部保留

恢复 Bot

  1. 在 Bot 列表页面，点击已暂停 Bot 卡片上的 恢复 按钮
  2. Bot 状态恢复为”运行中”

恢复后，Bot 立即可以接收新任务和消息。

删除 Bot

删除 Bot 是不可恢复的操作，请谨慎执行。

操作步骤

  1. 进入 Bot 详情页 -> 设置 Tab
  2. 滚动到页面底部的 危险操作 区域
  3. 点击 删除 Bot
  4. 在确认对话框中确认删除

删除的影响

  • Bot 的所有配置被永久删除
  • 资源绑定被移除
  • 记忆被清空
  • 定时任务和消息渠道配置被删除
  • 执行历史记录保留（用于审计追溯）

常见用法

纯对话 Bot

最简单的用法：创建 Bot 后不绑定任何资源，仅利用 LLM 进行对话。

配置要点：

  • 编写清晰的系统提示词，定义 Bot 的角色和知识领域
  • 选择适合对话场景的模型
  • 开启自动记忆以保持跨会话的上下文连贯性

适用场景： 客服助手、知识问答、文案写作。

运维 Bot

绑定 SSH 和 Web 搜索资源，让 Bot 具备服务器操作和信息检索能力。

配置要点：

  • 绑定 SSH 资源，并配置严格的权限约束：
    • 主机白名单 — 只允许访问特定服务器（如 10.0.1.*）
    • 命令白名单 — 只允许执行安全的命令（如 ls *、cat /var/log/*、systemctl status *）
    • 避免允许 rm、dd、mkfs 等危险命令
  • 绑定 Web Access 资源用于查询文档和故障排查
  • 设置月度预算防止异常消耗
  • 使用计划式或自适应推理模式，确保复杂操作先制定计划再执行
  • 配置定时任务实现每日巡检

适用场景： 服务器监控、日志分析、故障诊断、定时巡检。

编排 Bot（Orchestrator）

绑定多个其他 Bot 作为资源，根据用户需求自动委派任务给合适的 Bot。

配置要点：

  • 为每个子 Bot 创建 Bot 类型的 Resource
  • 在编排 Bot 上绑定这些 Resource，并配置委派权限约束（Delegate Scope）
  • 编写系统提示词，说明每个子 Bot 的能力和适用场景
  • 使用自适应推理模式，让编排 Bot 根据子 Bot 的执行结果调整策略
  • 注意权限传播：编排 Bot 对子 Bot 的 Delegate Scope 会限制子 Bot 的有效权限

适用场景： 跨系统任务编排、多人协作模拟、复杂工作流分发。

MCP 工具集成 Bot

通过 MCP 协议接入外部工具服务器，获得丰富的工具能力。

配置要点：

  • 在资源管理中创建 MCP 类型资源，填写工具服务器的 HTTP 地址
  • 如果需要认证，配置 API Key 或 OAuth
  • 平台会自动发现 MCP 服务器上的可用工具
  • 在 Bot 的资源配置中绑定 MCP 资源，勾选允许使用的工具
  • 通过工具权限控制，可以只暴露部分工具给 Bot

适用场景： 接入第三方 SaaS 平台工具、使用社区 MCP 工具服务器。

Agent 桥接 Bot

通过 Monstrum Agent 将本地工具桥接到平台。

配置要点：

  • 在 Agent 页面创建 Agent 并获取 Agent Key
  • 在本地安装 monstrum-agent 并使用 Agent Key 连接
  • Agent 会通过 WebSocket 将本地 MCP 服务器、插件等工具注册到平台
  • 注册的工具以 Resource 形式出现在资源管理中
  • 在 Bot 上绑定 Agent 注册的资源，配置工具权限

适用场景： 接入企业内网工具、使用需要本地运行的 MCP 服务器、桥接自定义脚本。

常见问题

Bot 无法使用工具

可能原因：

  1. 未绑定资源 — 进入 Bot 详情页 -> 资源配置 Tab，检查是否已绑定对应的 Resource
  2. 权限不足 — 绑定时选择的允许操作可能不包含目标工具。编辑权限，确认所需操作已被勾选
  3. 凭据过期 — 检查绑定的 Credential 是否仍然有效
  4. 资源离线 — 对于 Agent 桥接的资源，检查 Agent 是否在线；对于 MCP 资源，检查服务器是否可达

Bot 回复无意义或偏离预期

可能原因：

  1. 系统提示词不清晰 — 进入设置 Tab，检查系统提示词是否明确定义了 Bot 的角色和行为边界
  2. 模型选择不当 — 复杂任务需要较强的模型；简单对话不需要最高端的模型
  3. Temperature 过高 — 降低 Temperature 值可以获得更稳定的输出
  4. 缺少记忆上下文 — 如果 Bot 需要记住之前的交互，确认自动记忆提取已开启

Bot 不回复消息

可能原因：

  1. LLM 提供商未配置 — 进入 LLM Providers 页面，确认至少有一个提供商且连接测试通过
  2. 月度预算耗尽 — 检查概览 Tab 的费用面板，如果预算用完，需要调高预算或等待下月重置
  3. Bot 已暂停 — 检查 Bot 状态是否为”已暂停”，如是则点击”恢复”
  4. 提供商 API Key 失效 — 在 LLM Providers 页面点击”测试连接”验证

工具调用被权限拒绝

可能原因：

  1. 操作未授权 — 在资源配置中编辑权限，确认目标操作已被允许
  2. 参数超出范围 — Guardian 会校验工具调用的参数是否在允许范围内。例如 SSH 的命令白名单、Web3 的地址白名单
  3. 角色权限限制 — 如果通过角色绑定，检查角色定义中的权限范围是否包含目标操作

如何查看 Bot 调用了什么工具

进入 Bot 详情页 -> 执行历史 Tab -> 点击任务的”详情”，在执行时间线中可以看到每一次工具调用的完整信息，包括工具名称、参数、结果和权限校验状态。

如何重置 Bot 状态

  • 清除对话上下文 — 在概览 Tab 的对话界面点击”新对话”
  • 清除所有记忆 — 进入记忆 Tab，点击”清空”
  • 重置提示词 — 进入提示词 Tab，点击”重置为工作区默认”
  • 完全重建 — 删除 Bot 后重新创建（执行历史记录会保留用于审计）

定时任务没有触发

可能原因：

  1. 定时任务被禁用 — 检查定时任务列表中的状态列
  2. 时区错误 — 确认定时任务配置的时区与你的预期一致
  3. Bot 已暂停 — 暂停状态的 Bot 不会执行定时任务
  4. 预算耗尽 — 月度预算用完后，所有执行（包括定时任务）都会被暂停
在 GitHub 上编辑此页