---
title: "工具系统"
description: "了解 resident tools、按需工具、角色权限和运行状态。"
image: "https://kxen.ai/og.png"
---

> Documentation Index
> Fetch the complete documentation index at: https://kxen.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 工具系统

工具让 Agent 读取项目、修改文件、运行命令、访问语言服务和调用外部集成。工具目录不是权限目录，出现在目录中的工具不一定能在当前角色或机器上执行。

## Resident tools

高频工具直接提供给模型:

- `exec`
- `read`
- `edit`
- `write`
- `task`
- `goal`
- `glob`
- `grep`
- `todo`
- `webfetch`
- `websearch`
- `tool_search`
- `workflow`
- `team`

`team` 只对主会话 lead 可见，teammate 使用受限的 `send_message` 和 `team_task`。文件工具受 Workspace 和统一路径边界限制。`exec` 要求显式 Shell dialect，并把长命令转为后台任务。

## 按需工具

低频工具通过 `tool_search` 渐进披露:

- `delete`
- `lsp`
- `agent`
- `worktree`
- `skill`
- `knowledge`
- `schedule`
- `browser`

`Browser` 只有在个人配置中显式启用实验开关后才进入目录。MCP 工具有独立目录和策略，不属于内置 deferred tools 清单。模型先发现契约，再调用具体工具，避免一次性把全部工具说明塞入上下文。

## 权限来源

工具是否可用由以下条件共同决定:

- Agent 角色和 permission profile。
- Workspace 信任。
- 本机运行时和外部服务状态。
- Safety 判定。
- 用户 Approval。

研究和规划角色默认没有写入和命令权限。execution 角色可以获得更完整的工具面，但仍不能覆盖 Safety 的硬拒绝。Shell 在宿主机执行，不是沙盒；每条命令都必须显示完整 command 和 cwd，并获得当次 Approval。

## 可观察性

时间线显示工具名称、关键参数摘要、执行状态和结果。长输出会截断展示，但实际任务状态仍由后端工具运行记录决定。

Source: https://kxen.ai/agent/tools/index.mdx