bytedance/agentkit-samples is a collection of examples and tutorials for Volcengine AgentKit, an AI-agent development platform for building, deploying, and operating agent applications. Developers use the samples to learn agent creation, multi-agent collaboration, memory, retrieval, MCP integrations, media generation, customer service, and other workflows. The catalogue skills provide agent workflows based on these examples.
Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx skills add bytedance/agentkit-samples --skill byted-volcengine-mongodbgit clone --depth 1 https://github.com/bytedance/agentkit-samplesWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/bytedance/agentkit-samples/byted-volcengine-mongodb)<a href="https://agentmods.dev/skills/bytedance/agentkit-samples/byted-volcengine-mongodb"><img src="https://agentmods.dev/badge/skills/bytedance/agentkit-samples/byted-volcengine-mongodb.svg" alt="Measured on agentmods" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00082 | $0.01759 |
| Opus 5 | $0.00041 | $0.00879 |
| Sonnet 5 | $0.00016 | $0.00352 |
| Haiku 4.5 | $0.00008 | $0.00176 |
Grade A, and why
byted-volcengine-mongodb scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 3d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 220 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Skill 概览
本 Skill 用于在对话中充当 火山引擎 MongoDB 的智能运维代理:
- 理解用户的自然语言需求(中文或英文),识别是否与 MongoDB 相关;
- 直接调用内置脚本
scripts/call_mongodb.py实时查询 MongoDB 并获取结果; - 当获取到结果或用户粘贴错误信息时,进一步解释、诊断并给出后续建议。
工作模式:
- 使用
scripts/call_mongodb.py脚本直接获取 MongoDB 的实时响应
运行方式: 脚本支持两种运行方式:
# 方式 1: 使用 uv (推荐,自动管理依赖)
uv run ./scripts/call_mongodb.py [action] [options]
# 方式 2: 使用 python (需要预先安装依赖)
python ./scripts/call_mongodb.py [action] [options]
标准使用流程
-
确认任务类型与参数
- 判断用户意图:查询实例列表、查看实例详情、管理备份、查看参数配置等。
- 收集必要参数(如未指定则使用默认值):
--region:地域 ID(默认cn-beijing)--action:操作类型(如list-instances、describe-instance、list-backups等)--instance-id:实例 ID(部分操作必需)
-
构造查询并调用脚本
- 示例(以下命令可使用
uv run或python运行):# 查询实例列表 uv run ./scripts/call_mongodb.py list-instances # 查询指定实例详情 uv run ./scripts/call_mongodb.py describe-instance --instance-id mongo-xxx # 查询实例备份 uv run ./scripts/call_mongodb.py list-backups --instance-id mongo-xxx # 查询实例参数 uv run ./scripts/call_mongodb.py list-parameters --instance-id mongo-xxx
- 示例(以下命令可使用
-
解析结果并后续处理
- 将 MongoDB 的响应用自然语言解释给用户;
- 如返回包含敏感操作,评估风险并提醒:
- 避免在生产环境直接执行高风险操作(如删除实例、重启等);
- 建议在测试环境验证或做好备份。
工具脚本使用说明
支持的操作(Actions)
| 操作 | 说明 | 必需参数 |
|---|---|---|
list-instances |
查询 MongoDB 实例列表 | 无 |
describe-instance |
查询指定实例详情 | --instance-id |
list-backups |
查询实例备份 | --instance-id |
list-parameters |
查询实例参数配置 | --instance-id |
命令行参数
| 参数 | 说明 | 默认值 |
|---|---|---|
action |
操作类型(必需) | - |
--region / -r |
火山引擎地域 ID | cn-beijing |
--instance-id / -i |
实例 ID | 无 |
--page-number |
分页页码 | 1 |
--page-size |
每页记录数 | 10 |
--output / -o |
输出格式(json/table) | json |
输出格式
脚本会将查询信息输出到 stderr,将结果输出到 stdout,便于分离日志和结果:
[操作] list-instances
[地域] cn-beijing
============================================================
[查询结果]
<实际结果内容>
What ships with it
3 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 3d ago First seen · 220 lines · 82 tokens per session scan A a6825aa996de
byted-volcengine-mongodb is a skill published in the GitHub repository bytedance/agentkit-samples (449 stars, last pushed 2d ago), licensed Apache-2.0. It adds 82 tokens to every session and 1,759 once invoked, about $0.0004 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.
Other skills, from other repositories
nosqli
NoSQL injection — MongoDB operator injection ($ne, $gt, $where, $regex), CouchDB / Firebase / Redis attack patterns, auth bypass, blind extraction.
database-mongodb
Apply MongoDB data-modeling, indexing, and query rules from access patterns. Use when designing schemas, choosing embed vs reference, or tuning MongoDB query behavior.
azure-documentdb
Expert knowledge for Azure DocumentDB development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when using DocumentDB search (BM25/vector), Data API, MongoDB compatibility, change…
mongodb
Query and modify MongoDB collections via exec, using an operation + collection + JSON query syntax.
extension-backend
Build backend APIs for Chrome extensions. NestJS + MongoDB (Mongoose) recommended stack. Auth, webhooks, license verification, CORS. Use when: backend, API, server, database, license, webhook.
mongodb-natural-language-querying
Generate read-only MongoDB queries (find) or aggregation pipelines using natural language, with collection schema context and sample documents. Use this skill whenever the user asks to write, create, or generate MongoDB queries, wants to filter/query/aggregate data in MongoDB, asks "how do I query...", needs help with…