本文介绍如何在 Agent 应用中接入并使用火山引擎文档数据库 MongoDB 版 Skill，帮助您快速实现 MongoDB 实例的智能查询与信息获取。 ## 背景信息在传统使用模式下，用户通常需要通过控制台或调用 API 的方式，完成 MongoDB 实例的信息查询与状态监控。在包含多个子场景的复杂使用场景时，往往需要多次点击和页面切换，操作链路较长，存在较多重复性工作，对使用经验和操作效率也有一定要求。通过火山引擎文档数据库 MongoDB 版 Skill，您可以直接以自然语言与 Agent 交互，由 Agent 自动理解您的意图并调用相应能力，协助完成 MongoDB 实例的查询与信息获取，从而降低使用门槛，提升日常信息获取效率。 ## 功能与场景 MongoDB Skill 目前提供 4 项只读查询能力，每项能力对应的使用场景如下。 |**功能** |**说明** |**适用场景** | |---|---|---| |查询实例列表 |获取账号下所有 MongoDB 实例的概要信息，包括实例 ID、运行状态、计费方式等。 |日常巡检，快速了解所有实例的运行状态与计费方式。 | |查询实例详情 |获取指定实例的完整配置信息，包括网络、存储、数据库版本、节点信息等。 |信息核对或问题定位，查看实例的详细配置。

| |查询实例备份

|查询指定实例的备份文件列表，包括备份文件名称、备份策略、备份状态等。 |备份检查，确认最近备份是否成功及备份策略。

| |查询参数配置 |查询指定实例当前的数据库参数设置，如 `maxIncomingConnections` 等。 |参数调优或问题排查，获取当前参数值作为参考依据。 | ## 前提条件已为文档数据库 MongoDB 版 Skill 创建 API 访问密钥（AK/SK）。具体操作，请参见 [Access Key（密钥）管理](https://www.volcengine.com/docs/6291/65568)。 ## 安装配置本文主要以 OpenClaw 和 ArkClaw 为例介绍如何安装 MongoDB Skill。除上述 Agent 外，Trae、Claude Code 等支持 Agent Skills 协议的 Agent 也支持加载该 Skill，具体安装命令请参见 [Find Skill 安装指引](https://findskill.com/volcengine/mongodb/volcengine-mongodb)，或下载 ZIP 压缩包进行手动安装。在 OpenClaw 中安装 MongoDB Skill 1. 安装 Node.js 22+。详细信息，请参见 [Node.js](https://nodejs.org/zh-cn)。 2. 安装 OpenClaw 1. 根据操作系统选择合适的命令安装 OpenClaw * macOS 和 Linux 操作系统： ```Plain Text curl -fsSL https://openclaw.ai/install.sh | bash ``` * Windows 操作系统（使用 PowerShell）： ```Plain Text iwr -useb https://openclaw.ai/install.ps1 | iex ``` 2. 执行以下命令初始化 OpenClaw，并根据提示进行依次配置。 ```Plain Text openclaw onboard --install-daemon ``` 安装成功后您可以执行 `openclaw --version` 命令验证是否成功安装。 3. 安装 MongoDB Skill 执行以下命令安装 MongoDB Skill。 ```Plain Text npx skills add https://skills.volces.com/skills/volcengine/mongodb -s volcengine-mongodb --agent openclaw ``` 4. 配置访问凭证在 Agent 运行环境中配置以下环境变量。 ```Plain Text export VOLCENGINE_ACCESS_KEY="your-access-key" # 必选，填写您在 API 访问密钥页面获得的 Access Key。 export VOLCENGINE_SECRET_KEY="your-secret-key" # 必选，填写您在 API 访问密钥页面获得的 Secret Key。 export VOLCENGINE_REGION="cn-beijing" # 可选，默认 cn-beijing。 ``` 在 ArkClaw 中安装 MongoDB Skill 1. 登录 [ArkClaw 控制台](https://console.volcengine.com/arkclaw/)。 2. 发起 ArkClaw 任务。详细操作，请参见[发起任务](https://www.volcengine.com/docs/87732/2277078?lang=zh)。 3. 安装 MongoDB Skill。 1. 在左侧导航栏，选择**技能中心**。 2. 在**技能广场**页面，找到 volcengine\-mongodb，单击**添加**。 4. 在 ArkClaw 的对话框中，输入以下信息： * **VOLCENGINE_ACCESS_KEY** — 火山引擎 Access Key * **VOLCENGINE_SECRET_KEY** — 火山引擎 Secret Key * **VOLCENGINE_REGION**（可选，默认 cn\-beijing）— 实例所在地域。

注意

每次新建会话时，Agent 需再次验证您的 Access Key 和 Secret Key 方可调用 Skill.

## 使用演示完成配置后，您即可通过自然语言与 Agent 交互，完成 MongoDB 实例的查询与信息获取。以下通过几个典型对话示例，展示 Skill 在实际场景中的使用方式与交互流程。 ### 查询实例列表您可以通过自然语言直接查询账号下所有 MongoDB 实例的运行状态与基础信息。Agent 会调用 MongoDB Skill 获取最新的实例数据，并返回实例 ID、运行状态、计费方式等关键信息。

### 查询实例详情当您需要了解某个具体实例的详细配置时，只需在对话中提供实例 ID 或实例名称，Agent 会调用 MongoDB Skill 获取该实例的完整信息，并返回基本信息、资源使用概况及节点信息等详细数据。

### 查询实例备份当您需要检查实例的备份情况时，只需在对话中提供实例 ID 或实例名称并发出备份查询指令，Agent 会调用 MongoDB Skill 获取最新的备份列表，并返回备份文件名称、备份策略、备份状态等关键信息。

### 查询参数配置当您需要查看实例的数据库参数设置时，只需在对话中提供实例 ID 或实例名称，Agent 会调用 MongoDB Skill 获取该实例当前的完整参数配置，并返回所有参数名及其对应的当前值、默认值等关键信息。您也可以指定具体参数名称进行精确查询。