文档中心

火山方舟

配置 Harness

豆包搜索

豆包搜索是面向大模型构建的搜索服务，通过灵活 API 形式提供多垂类、多信源搜索能力，用于补充模型训练数据截止后的最新事实、核验信息出处、获取时效性内容，提升大模型回答的知识面和可信度。

注意

2026年6月22日，Agent Plan 产品中的联网搜索（Beta版）服务正式升级为豆包搜索服务。建议已接入联网搜索（Beta版）的企业用户迁移至豆包搜索。

能力介绍

豆包搜索支持的核心能力如下，详情参见豆包搜索 API 文档。

网页搜索：返回标题、来源站点、URL、摘要、正文等结构化字段，单次最多 50 条。

多模态搜索：对文本 query 返回图片内容（包括图片标题、URL、尺寸与形状）。

权威来源过滤：可限定返回可信度高的各类官方站点内容。

时间范围筛选：支持近一天/周/月/年的快捷枚举，或自定义日期区间。

Query 改写：对口语化长问题自动改写为搜索式 query，提升召回。

使用豆包搜索

注意

使用联网搜索（Beta版）的用户：可继续使用原 API Key 进行接入鉴权，但无法使用套餐内 AFP 进行抵扣。建议迁移至豆包搜索。

使用豆包搜索的用户：使用 Agent Plan 企业版专属 API Key 调用搜索服务，支持使用套餐内 AFP 进行抵扣。

步骤一：订阅套餐并开通豆包搜索

管理员在 Agent Plan 企业版购买套餐并为用户分配席位。套餐说明参见套餐概览。

管理员需要在Harness 管理页签，开启豆包搜索的允许抵扣开关。

席位用户在Harness区域，打开开启抵扣的开关。

席位用户获取用于接入豆包搜索的专属 API Key，用于在工具中完成 Skill 或 MCP 的配置。

步骤二：在工具中使用豆包搜索

目前支持通过 MCP Server 或 Skill 两种方式在工具中使用豆包搜索。具体接入方式参见 AI 工具接入指南。

前置准备：已安装 Python 3.12+、uv。其中 uv 安装命令如下：

macOS / Linux

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Skill 接入方式

通过 Skill 方式为 AI 工具快速安装并接入豆包搜索能力。以下为常用 AI 工具的配置方案，其他工具可按需选择通过命令安装或通过对话安装方式完成豆包搜索 Skill 的安装并使用。

Claude Code

OpenCode

OpenClaw

Hermes Agent

安装并配置 Claude Code，具体步骤见 Claude Code。

在终端执行以下命令为 Claude Code 安装并接入豆包搜索 Skill byted-web-search。

npx skills add https://skills.volces.com/skills/bytedance/agentkit-samples -s byted-web-search --agent claude-code

安装完成后，执行claude命令启动 Claude Code。

通过对话方式提供 Agent Plan 企业版的专属 API Key 完成 Skill 的配置。

配置完成后，可以在 Claude Code 中使用豆包搜索能力。

MCP 接入方式

以下为常用 AI 工具的 MCP 接入方案，其他工具可通过对话方式让模型完成 MCP 的接入。将配置中的 <AGENT_PLAN_API_KEY> 替换为 Agent Plan 企业版的专属 API Key。

Claude Code

OpenCode

OpenClaw

安装并配置 Claude Code，具体步骤见 Claude Code。

编辑配置文件~/.claude.json，添加 MCP 配置。其中<AGENT_PLAN_API_KEY>需替换为 Agent Plan 企业版的专属 API Key。

{
...
"mcpServers": {
"mcp-server-askecho-search-infinity": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/volcengine/mcp-server#subdirectory=server/mcp_server_askecho_search_infinity",
"mcp-server-askecho-search-infinity"
],
"env": {
"ASK_ECHO_SEARCH_INFINITY_API_KEY": "<AGENT_PLAN_API_KEY>"
}
}
}
...
}