快速上手

本指南带你从注册到完成第一次 Bot 对话，大约需要 10 分钟。

概述

Monstrum 是一个 AI Agent 管控平台。你可以在上面创建 Bot，给它绑定工具和资源，然后通过对话或 API 让它执行任务。平台负责权限管控、凭据隔离和操作审计，确保 Bot 只做被授权的事。

本指南覆盖以下步骤：

  1. 注册账号并创建工作区
  2. 配置 LLM 提供商
  3. 创建第一个 Bot
  4. 与 Bot 对话
  5. （可选）给 Bot 绑定资源

第一步：注册与登录

访问 Monstrum 平台，点击”注册”创建账号。你需要提供：

  • 邮箱：用于登录和接收验证邮件
  • 用户名：3-20 个字符，支持字母、数字、下划线和连字符
  • 密码：至少 8 个字符
  • 邀请码：如果平台开启了邀请制注册

注册成功后，平台会自动创建一个以你用户名命名的个人工作区。

如果需要邮箱验证，请查收邮件并点击验证链接。

第二步：配置 LLM 提供商

Bot 需要一个 LLM 来进行推理。登录后，你需要先配置至少一个 LLM 提供商。

  1. 在左侧导航栏点击 LLM Providers
  2. 点击 添加提供商
  3. 选择提供商类型（如 OpenAI、Anthropic、Azure 等）
  4. 填写 API Key
  5. 如果需要自定义 API 地址，填写 Base URL（如使用 API 代理）
  6. 点击 测试连接 确认配置正确
  7. 保存

保存后，平台会自动获取该提供商支持的模型列表。你可以点击 设为默认 将某个提供商设为工作区默认。

如果是第一个提供商，平台会自动将其设为默认。

第三步：创建第一个 Bot

  1. 在左侧导航栏点击 Bot 管理
  2. 点击 创建 Bot
  3. 填写基本信息：
    • Bot 名称：给 Bot 起个名字，如”助手”
    • 描述（可选）：描述 Bot 的职责
  4. 点击 创建

创建成功后，你会进入 Bot 详情页。此时 Bot 使用工作区默认的 LLM 提供商和模型。

基本配置

在 Bot 详情页的 设置 Tab 中，你可以调整：

  • LLM 提供商：选择特定的提供商和模型，或使用工作区默认
  • 系统提示词：自定义 Bot 的身份和行为指令（留空使用默认模板）
  • Temperature：控制输出的随机性（0 = 确定性，1 = 创造性）
  • 最大迭代次数：每次对话中 Bot 的最大推理轮次
  • 超时时间：单次任务的超时秒数
  • 月度预算：Token 消耗的月度上限（USD）

暂时使用默认配置即可。

第四步：与 Bot 对话

  1. 在 Bot 详情页，切换到 概览 Tab
  2. 在底部的对话框中输入消息，如”你好，介绍一下你自己”
  3. 按回车发送

Bot 会使用配置的 LLM 进行推理并回复你。对话支持流式输出，你可以看到 Bot 逐字生成回复。

对话界面功能

  • 新对话：开始一个新的会话，清除之前的上下文
  • 结束会话：主动结束当前会话，触发记忆提取
  • 工具调用展示：如果 Bot 调用了工具，界面会展示工具名称和执行结果

此时 Bot 还没有绑定任何资源，所以它只能进行纯文本对话。接下来可以给它绑定资源，让它具备操作外部系统的能力。

第五步（可选）：绑定资源

给 Bot 绑定资源后，它就可以调用对应的工具。以下是最常见的场景。

场景一：让 Bot 搜索网页

  1. 在左侧导航栏点击 资源管理
  2. 在”可添加的资源”区域找到 Web Access，点击进入
  3. 填写资源名称（如”Web 搜索”）
  4. 选择搜索引擎——DuckDuckGo 无需 API Key，直接可用
  5. 保存资源
  6. 回到 Bot 详情页 → 资源配置 Tab
  7. 点击 绑定资源 → 选择刚创建的 Web Access 资源
  8. 配置权限（可以选择允许所有操作，或仅允许搜索/仅允许抓取）
  9. 保存绑定

现在回到对话界面，试着问 Bot”帮我搜索今天的新闻”——你会看到它调用 web_search 工具获取搜索结果。

场景二：让 Bot 访问远程服务器

  1. 在 资源管理 中添加 SSH 类型资源
  2. 配置主机地址、端口和用户名
  3. 添加凭据（SSH Key 或密码）
  4. 在 Bot 详情页绑定该资源，并设置权限约束：
    • 主机白名单：限制可访问的主机（如 10.0.1.*）
    • 命令白名单：限制可执行的命令（如 ls *、cat *）
  5. 保存绑定

Bot 现在可以通过 SSH 在远程服务器上执行被授权的命令了。

场景三：连接 MCP 工具服务器

  1. 在 资源管理 中添加 MCP 端点 类型资源
  2. 填写 MCP 服务器地址（Streamable HTTP endpoint）
  3. 如需认证，配置 API Key 或 OAuth
  4. 保存后，平台会自动发现 MCP 服务器上的可用工具
  5. 在 Bot 详情页绑定该资源，选择允许 Bot 使用哪些已发现的工具

下一步

恭喜！你已经完成了基本的平台设置和第一次 Bot 对话。接下来可以：

常见问题

Bot 回复”未配置 LLM 提供商”

你还没有配置 LLM 提供商。进入 LLM Providers 页面添加至少一个提供商。

Bot 不调用任何工具

Bot 没有绑定资源，或者绑定的资源权限不包含该操作。检查 Bot 详情页的 资源配置 Tab。

对话没有响应

检查以下几点：

  • LLM 提供商的 API Key 是否有效（在提供商页面点击”测试连接”）
  • Bot 是否处于”已暂停”状态
  • 月度预算是否已用完

如何重置 Bot 状态

在 Bot 详情页点击 新对话 开始全新会话。如果需要清空 Bot 的所有记忆，进入 记忆 Tab 操作。

在 GitHub 上编辑此页