AgentKit
AgentKit
文档指南
请输入
- 文档首页
AgentKitAgentKit开发者指南API参考MCPListMCPToolsetTools - 查询MCP工具集中的工具
复制全文
下载 pdfListMCPToolsetTools - 查询MCP工具集中的工具
文档反馈
问问助手查询MCP工具集中的工具。
请求参数
Action string 必选 示例值：ListMCPToolsetTools
要执行的操作，取值：ListMCPToolsetTools。
Version string 必选 示例值：2025-10-30
API的版本，取值：2025-10-30。
MCPToolsetId string 必选 示例值：m-ye7f6gd7nktv3gi6c***
MCP工具集服务ID。
返回参数
MCPService object[] 示例值：--
MCP工具集详情。
IsAllTool boolean 示例值：true
是否全量返回工具。
MCPServiceId string 示例值：m-ye7f6gd7nktv3gi6c****
MCP服务ID。
MCPTools object[] 示例值：-
工具的标签。
Description string 示例值：add comments
MCP服务的工具描述。
Name string 示例值：add-comments
MCP工具的名称。
Tags string[] 示例值：Version1
工具的标签。
Name string 示例值：add-comments
MCP工具的名称。
MCPToolsetId string 示例值：mt-yefjsz5s0054ppxu****
MCP工具集的ID。
请求示例
POST https://agentkit.cn-beijing.volcengineapi.com?Action=ListMCPToolsetTools&Version=2025-10-30 HTTP/1.1
Content-Type: application/json
{
"MCPToolsetId":"mt-ye7d4hlbswq7oi5c****"
}
返回示例
{
"ResponseMetadata": {
"RequestId": "20260212221805CB3871ABF16839****",
"Action": "ListMCPToolsetTools",
"Version": "2025-10-30",
"Service": "agentkit",
"Region": "cn-beijing"
},
"Result": {
"MCPToolsetId": "mt-yefjsz5s0054ppxu****",
"MCPService": [
{
"MCPServiceId": "m-yefgecdo8wntl8dn****",
"Name": "mcp_service_test_liutao",
"IsAllTool": true,
"MCPTools": [
{
"Name": "update-doc",
"Description": "更新飞书云文档内容。支持 7 种模式：overwrite(覆盖)、append(追加)、replace_range(定位替换)、replace_all(全文替换)、insert_before(前插入)、insert_after(后插入)、delete_range(删除内容)。\n\n# 概述\n\n更新飞书云文档内容，支持 7 种模式。优先使用局部更新（append/replace_range/insert），慎用 overwrite。支持异步：大文档超时返回 task_id。\n\n# 定位方式\n\n定位模式支持两种方式，二选一。replace_range/insert 要求匹配唯一，replace_all 允许多处。\n\n## selection_with_ellipsis - 内容定位\n\n- **范围匹配**：`开头内容...结尾内容`（匹配中间所有内容，建议 10-20 字符确保唯一）\n- **精确匹配**：`完整内容`（不含 `...`，适合短文本/关键词）\n- **转义**：内容本身含 `...` 时用 `\\.\\.\\.`\n\n示例：\n- `你好...世界` → 匹配从\"你好\"到\"世界\"之间的任意内容\n- `你好\\.\\.\\.世界` → 匹配字面量 \"你好...世界\"\n\n\n## selection_by_title - 标题定位\n\n格式：`## 章节标题`（可带或不带 # 前缀）\n\n自动定位整个章节（从该标题到下一个同级或更高级标题之前）。\n\n# 返回值\n\n- **成功**：doc_id, mode, message, warnings(可选), replace_count(replace_all 模式)\n- **异步**：task_id（用于查询状态，再次调用 update-doc 仅传 task_id）\n- **错误**：error + Suggestion + Context\n\n# 示例\n\n## append - 追加到末尾\n\n```json\n{\n \"doc_id\": \"文档ID或URL\",\n \"mode\": \"append\",\n \"markdown\": \"## 新章节\\n\\n追加的内容...\"\n}\n```\n\n## replace_range - 按标题替换章节\n\n```json\n{\n \"doc_id\": \"文档ID或URL\",\n \"mode\": \"replace_range\",\n \"selection_by_title\": \"## 功能说明\",\n \"markdown\": \"## 功能说明\\n\\n更新后的内容...\"\n}\n```\n\n## insert_before / insert_after - 插入内容\n\n```json\n{\n \"doc_id\": \"文档ID或URL\",\n \"mode\": \"insert_after\",\n \"selection_with_ellipsis\": \"```python...```\",\n \"markdown\": \"**输出示例**：\\n```\\nresult = 42\\n```\"\n}\n```\n\n## overwrite - 完全覆盖\n\n⚠️ 会清空文档后重写，可能丢失图片、评论等，仅在需要完全重建文档时使用。\n\n```json\n{\n \"doc_id\": \"文档ID或URL\",\n \"mode\": \"overwrite\",\n \"markdown\": \"# 新文档\\n\\n全新的内容...\"\n}\n```\n\n# 最佳实践\n\n## 小粒度精确替换\n\n修改文档内容时，**定位范围越小越安全**。尤其是表格、分栏等嵌套块，应精确定位到需要修改的文本。图片/画板/电子表格等 token 内容无法重建，替换时应避开。\n\n**示例**：表格单元格中有图片和文字，只需修改文字\n- ❌ 替换整个表格或整行 → 可能破坏图片引用\n- ✅ 只定位需要修改的文本 → 图片等其他内容不受影响\n\n不确定定位时，先用 fetch-doc 确认内容。\n\n修改多处内容时，优先使用多次小范围更新（replace_range/insert），而非 overwrite 重写整篇。分步更新保留原有媒体内容、评论、协作历史，更安全可靠。\n\n## insert 模式注意插入位置\n\n扩大定位范围来唯一定位时，插入位置基于匹配范围的**边界**：\n- `insert_after` → 插入在匹配范围的**结尾**之后\n- `insert_before` → 插入在匹配范围的**开头**之前\n\n扩大范围时，确保边界仍然是期望的插入点。\n\n## 修复画板语法错误\n\n当 create-doc 或 update-doc 返回画板写入失败的 warning 时：\n1. warning 中包含 whiteboard 标签（如 `<whiteboard token=\"xxx\"/>`）\n2. 分析错误信息，修正 Mermaid/PlantUML 语法\n3. 用 `replace_range` 替换：`selection_with_ellipsis` 使用 warning 中的 whiteboard 标签，`markdown` 提供修正后的代码块\n4. 重新提交验证\n\n## 注意事项\n\n- ** Markdown 语法**：支持飞书扩展语法，详见 create-doc 工具描述\n",
"Tags": [
"22"
]
}
]
}
]
}
}
错误码
状态码 | 错误码 | 错误信息 | 说明 |
400 | MissingParameter.MCPToolsetId | The required parameter MCPToolsetId is not supplied. | 参数MCPToolsetId不能为空。 |
最近更新时间：2026.02.14 10:10:28
这个页面对您有帮助吗？
有用
有用
无用
无用