工具与扩展类型

按集成提供的功能选择机制，再在配置中选择已安装的键或资源 ID。YAML 可以选择可执行集成，但不会安装其 Python 代码。

提供方原生工具和内置搜索/抓取见原生工具与 Web 提供方。

原生搜索与图像生成复制章节链接

按照原生搜索与图像生成用法配置；这是 Agent 工具选择，与 Host Web 搜索不同。

MCP 服务器复制章节链接

先配置 MCP 服务器，再在 Agent 或默认值中选择其 ID。

MCP 字段参考复制章节链接

完整字段见 MCP 字段参考。

Agent Capability复制章节链接

每个 Agent 选择的形式是 {capability: <catalog-key>, configuration: <JSON mapping>}。Harness UI 提供内置 Capability 以及可配置的已安装/原生 Capability。资源文件没有任意模块导入字段。

常见内置键包括 dynamic_environment、documents、web、skills、working_state、user_interaction、runtime_context、handoff、compaction 和 codeact。普通目录选项有意不包含权限和审查 Capability；请使用根级 security.shell_review。已有原始 Agent 选择仍然兼容。Agent 只使用它选择的 Capability；例外是 Harness UI 默认添加的 file_context 和 working_state，以及根级 tools 开关添加的 user_interaction 和 codeact。

完整的 Capability 专用 schema 由已安装的 Harness/原生实现定义，不会全部展开到 Harness UI YAML 中。请查阅 Harness Capability 参考及与你安装版本匹配的实现。a13n-harness-ui config validate 检查选中的键及其配置。

文件与 shell复制章节链接

capabilities:
  - capability: dynamic_environment
    configuration:
      files_enabled: true
      shell_enabled: true

这会开启原生 Environment 工具，不会创建第二个本地 runner。在 Agent 上使用 tools 进一步精确过滤可见工具，使用 Environment 配置提供执行隔离。

Shell 审查复制章节链接

在选中的根 a13n-harness-ui.yaml 中配置 shell 审查，不要通过 Agent Capability 选择器配置：

security:
  shell_review:
    enable: true
    model: model-review
    risk_threshold: high

model 是已配置的 Model 资源 ID，不是 subagent 引用或隐式提供方路由。此快捷配置将 shell 启动的权限和可选审查合并到一个 ToolPermissionsCapability 中；显式根字段优先，Agent 中无关的规则保留。enable: false 不会修改显式 Agent 策略。默认值、继承、错误和用量见完整 shell 审查用法。审查不提供文件系统或网络隔离，与 code-reviewer 子角色相互独立。

上下文管理复制章节链接

capabilities:
  - capability: runtime_context
    configuration: {}
  - capability: handoff
    configuration: {}
  - capability: compaction
    configuration: {}

通常应在 Model 上配置 model_characteristics，使提醒和压缩默认值保持一致。高级显式设置包括 runtime_context.configuration.context_window_tokens、handoff.configuration.summary_reminder_tokens 和 compaction.configuration.trigger_tokens；显式值优先于派生值。

任务、提问与 CodeAct复制章节链接

默认通过原生工作状态提供任务和笔记工具，包括有上限的笔记上下文注入。working_state 接受 notes_enabled: false 等原生配置以关闭笔记。F2 显示已提交的任务事实，不是单独的 TUI 清单存储。

根级 tools.enable_ask_user_question 控制 ask_user_question；tools.enable_codeact 控制 CodeAct。两项开关也控制显式编写的 Capability 选择。CodeAct 还公开 store、load 和 forget，用于随 Harness 续接保存显式 JSON 值；上下文中只投影已存键名。Agent Capability 配置支持 max_state_bytes 和 max_state_entries 限制状态。其 run_code 和 run_program 执行受限 Python；副作用通过符合条件的工具和现有策略实现，不提供无限制的 Python 文件系统或网络访问。默认值见根配置参考，问题超时见决策指南。

Skill复制章节链接

显式和自动来源优先级、内置离线配置 Skill、文件访问和目录捕获见 Skill 与 Content Plugin。选择 Skill 会增加知识发现能力，不会授予执行权限。

Content Plugin复制章节链接

见 Content Plugin 安装、卸载删除行为和完整仓库格式。它们是可编辑内容包，不是已安装的 Python Harness Plugin。

Harness Plugin 与 Run Extension 文件复制章节链接

Harness Plugin 资源选择已安装 的工厂。请将以下示例键和配置替换为集成文档中的值：

schema_version: "1"
kind: harness_plugin
id: plugin-memory
name: Memory integration
plugin_key: vendor.memory
configuration: {}

保存到 extensions/ 下，再在 Agent 或根默认值中选择 harness_plugins: [plugin-memory]。未知/未安装的键会导致验证失败；写入文件不等于安装。

Run Extension 是 Thread 选择。新 Thread 从 Project 或根级 defaults.environment_run_extensions 获取它们。Provider/adapter 和扩展专用配置属于已安装的实现，凭据应使用引用而非字面密钥字段。选择 provider 前，阅读自定义 Environment 配置。