跳转到主要内容
stirrup Harness 在任务 Environment 中运行 Python agent 库 Stirrup。框架传入准备好的任务提示词,提供代码执行和图片查看工具,并收集答案与轨迹。

配置 Stirrup

通过 version 选择软件包版本。默认安装策略会在软件包缺失或已安装版本不符时安装所选版本。preinstalled 要求 python3 已能加载所选版本,install_always 则在每次会话中执行安装。安装时 Environment 需要 Python 3.12+、pip 和软件包仓库访问权限。 共享参数与对应原生参数控制同一设置。例如,tool_timeout_seconds 和 shell_timeout 都设置代码执行的时限。kwargs 提供原生请求默认值,model.params 中的显式配置优先。

参数

通过 agentcompass config docs harness stirrup 可查看相同的参数结构。
ParameterNative parameterScopeTypeDefaultDescription
-Shared将生效的网络访问限制说明追加到 Harness 输入。
-Shared运行时版本,可指定发布版本或 latest。
-Shared会话初始化时的软件包安装策略。
Shared传给 Stirrup agent 的最大执行轮次,必须为正整数。
Shared单次模型响应的输出 token 上限;优先使用 model.params 中的显式设置。
Shared模型上下文容量,单位为 token,必须为正整数。
Shared单次代码执行的超时秒数。
Shared单次模型请求的超时秒数,必须为正整数。
Shared单次模型调用的尝试总次数,包含首次调用;原生 max_retries 表示首次调用之后的重试次数。
-Harness 专属是否暴露 Stirrup 的 view_image 工具。Benchmark 的 modality 包含 image 时会设为 true,此时显式设为 false 会报错。纯文本模型会拒绝图片输入,此时应关闭。
Harness-specificStirrup 客户端的额外模型请求参数。
Harness-specific触发上下文摘要的已用 token 比例。
Harness-specific剩余轮次不高于此值时发出提醒。
Harness-specific在线程中运行同步工具,避免阻塞异步循环。
Harness-specific将工具结果中的图片移到独立的用户消息。
Harness-specific防止没有工具响应的连续 assistant 消息。
Harness-specific上下文超限时尝试摘要并恢复。