naive_search_agent Harness 运行 AgentCompass 内置的 深度搜索 agent，由被测 model 通过单 agent 或协调 agent 与并行子 agent 完成 GAIA、SealQA、DeepSearchQA、FrontierScience、WideSearch 等研究类 Benchmark。
Harness 仅支持 host_process，在 AgentCompass 的 Python 进程内直接运行 agent 及其工具，驱动多轮检索并收集最终答案与检索轨迹。通过 --model-base-url / --model-api-key 提供 Model 凭据，并为所选网页工具配置 API 密钥。--model-api-protocol 支持 openai-chat 与 openai-responses 两种协议。
工作原理
- 工具与循环：
tools指定启用的网页工具（search/browse/visit）；引擎按函数调用协议与 model 多轮交互。max_iterations限制单 agent 或协调 agent 的迭代数，sub_agent_max_iterations限制每个子 agent 的迭代数。max_tool_calls_per_turn限制单条助手消息中的工具调用数，max_tool_response_length对过长的单个网页工具响应进行截断（保留首尾）。当 model 不再发起工具调用时视为作答完成，取最后一条助手消息内容作为最终答案。 - agent 模式：默认
mode: single。mode: multi向协调 agent 提供create_sub_agents，用于委派研究任务并汇总子 agent 结果生成最终答案。子 agent 使用相同的 Model 配置和所选网页工具，拥有独立对话上下文，不能递归委派。每次委派调用默认最多并发运行 4 个子 agent，不设累计创建数量上限。任务有执行截止时间时，子 agent 会提前停止，为协调 agent 生成最终答案留出时间。 - 外部服务：
search依赖 Serper，browse/visit依赖 Jina Reader；密钥由serper_api_key/jina_api_key提供（默认取同名环境变量）。tool_model_name可为visit指定专用的网页摘要 model，留空时复用被测 model。
内置工具
agent 在检索循环中可调用以下三个网页工具。通过tools 参数选择启用哪些（默认 ["search", "visit"]），三者可按需组合。
| 工具 | 入参 | 作用 | 依赖服务 |
|---|---|---|---|
search | query（检索词） | 执行一次 Google 搜索，返回结果列表（标题、摘要、链接等）。用于发现与问题相关的网页，是检索的入口。 | Serper |
visit | url（单个链接或链接数组）、goal（本次访问要获取的信息） | 抓取一个或多个网页，并围绕 goal 对内容做 摘要 后返回（而非全文）。摘要由 tool_model_name 指定的 model 生成，缺省复用被测 model。适合从长网页中定向提取所需信息。 | Jina Reader + 摘要 model |
browse | url（单个链接） | 抓取单个网页的 完整内容（标题、摘要、正文）并原样返回，不经 LLM 摘要。适合需要保留页面原文细节的场景。 | Jina Reader |
search + visit 对应典型的深度检索流程：先用 search 找到候选网页，再用 visit 带着明确的 goal 精读并提取信息。若需要网页原文而非摘要（例如逐字比对表格、代码或条款），可改用或加上 browse。visit 与 browse 的区别在于前者返回面向目标的摘要，后者返回完整正文。
create_sub_agents 是独立的 Model 可调用委派工具，由 mode: multi 自动向协调 agent 启用，不应填入 tools。批量响应完整保留每个子 agent 的结果，不受 max_tool_response_length 截断。子 agent 只继承所选网页工具。Model 按需调用工具，没有固定执行顺序。
参数
通过--harness-params '{...}' 传入一段 JSON；也可写进 --config 指定的 YAML 的 harnesses.naive_search_agent 块，同名项以命令行为准（深度合并覆盖）。
参数总览
| 参数 | 类型 | 默认值 | 可选值 / 取值 | 说明 |
|---|---|---|---|---|
tools | 列表 | [“search”, “visit”] | search / browse / visit | 启用的网页工具列表。 |
max_iterations | 整数 | 50 | ≥ 1 | 单个 agent 的最大迭代数。 |
max_retry | 整数 | 10 | ≥ 1 | 单次调用的最大尝试次数（含首次调用）。 |
retry_interval | 整数 | 5 | ≥ 1 | 重试等待的基础间隔（秒）。 |
max_tool_calls_per_turn | 整数 | 5 | ≥ 1 | 单条助手消息最大工具调用数。 |
max_tool_response_length | 整数 | 8192 | ≥ 1 | 单个网页工具响应保留的最大可打印单元数（超出截断，保留头尾）。不截断 create_sub_agents 的批量结果。 |
request_timeout | 整数 | 2000 | ≥ 1 | 单次 Model HTTP 请求超时（秒）。 |
tool_model_name | 字符串 | "" | — | visit 工具专用的网页摘要 model；留空复用被测 model。 |
serper_api_key | 字符串 | — | Serper 搜索 API 密钥。 | |
jina_api_key | 字符串 | — | Jina Reader API 密钥。 | |
mode | 字符串 | ”single” | single / multi | single 运行单 agent；multi 向协调 agent 提供 create_sub_agents 委派工具。 |
sub_agent_max_iterations | 整数 | 50 | ≥ 1 | 每个子 agent 的最大迭代数。 |
sub_agent_concurrency | 整数 | 4 | ≥ 1 | 仅在 multi 模式下生效，限制每次 create_sub_agents 调用内的子 agent 并发数，超出的排队执行。 |
max_retry 控制 Model 和工具调用的应用层尝试次数，retry_interval 为每次重试前固定等待的秒数。页面摘要 Model 复用这两项设置；工具内部的 HTTP 重试规则由各工具实现决定。
sub_agent_max_iterations 和 sub_agent_concurrency 在 multi 模式下生效。并行的委派调用各自独立限制子 agent 并发数，任务级工作量还会随 --task-concurrency 叠加。
多 agent 任务有总时限时，协调 agent 取 request_timeout 与总时限的 10% 中较小者，预留给不再调用工具的最终作答，并在 max_iterations 内保留一轮用于汇总。子 agent 的研究会在这段预留时间开始前停止。委派批次返回已完成结果和可用的部分结果，并为超时子 agent 标记错误状态。研究时间或轮数预算耗尽后，协调 agent 汇总已有证据。这一行为无需新增配置，不改变 single 模式。
搜索与解析 API 密钥
serper_api_key / jina_api_key 默认为环境变量引用（${SERPER_API_KEY} / ${JINA_API_KEY}）：在终端中设置同名变量即可自动注入，也可在 --harness-params 中直接内联传入密钥。仅启用 search 时可省略 Jina 密钥，仅启用 visit / browse 时可省略 Serper 密钥——按实际启用的 tools 提供对应密钥即可。
运行示例
在以下命令中，将naive_search_agent 作为第二个位置参数：
--harness-params 传入。GAIA、DeepSearchQA 等均为由评委评分 Benchmark，须通过 --benchmark-params 提供评委 model judge_model，否则任务无法判分（详见对应 Benchmark 文档）。
未配置 mode 时使用 single；测试子 agent 委派时设为 multi。快速开始中的 WideSearch 推荐配置显式使用 multi，与下方“多 agent”示例一致。
- 默认配置
- 自定义参数
- 多 agent
通过
--harness-params 直接传入 Serper / Jina 密钥，默认模式为 single。输出
Harness 为每个任务返回RunResult：包含最终答案（final_answer）、轨迹、执行状态，以及迭代数和引擎状态等 telemetry。执行失败通过 issues 报告：模型鉴权、配额或服务端故障、搜索与 Jina 服务故障（包括 Jina 凭证或额度被拒）属于 FATAL，会按 execution.max_retries 重跑该 attempt；模型超时或没有有效输出属于 ERROR。multi 模式下，子 agent 未解决的 FATAL 问题会上报到任务结果；子 agent 的超时等 ERROR 只记录在该子 agent 的记录中，协调 agent 仍可基于部分结果作答。单任务详情与聚合指标由 Benchmark 写入运行目录（详见结果）。
multi 模式下，主轨迹只包含协调 agent。artifacts 中的 sub_agents 保存各子 agent 的完整响应、消息、ACTF 轨迹与用量，sub_agent_runtime 记录子 agent 运行计数。失败或取消后仍保留已获得的子 agent 部分结果。telemetry 字段 agent_prompt_tokens 和 agent_completion_tokens 统计协调 agent 与子 agent 循环的用量，不包含 visit 内部生成页面摘要的 Model 调用。
任务执行 deadline 统一通过 --execution-params 中的 run_timeout_seconds 和 run_timeout_multiplier 设置。详见阶段超时。