Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions s02_tool_use/README.ja.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,6 +17,14 @@ s01 の Agent には bash 一つのツールしかない。ファイルを読む

---

## Bash だけでできるのに、なぜツールを追加するのか?

これらのツールは Agent の素の能力を増やすものではない。同じ操作は Bash でも実行できる。改善するのは、モデルと Harness の間のインターフェースだ。`path` 引数を持つ `read_file` 呼び出しなら、モデルは意図を shell 構文へ変換する必要がなく、引用符やエスケープのミスを減らせる。

Harness が受け取るのも、不透明な command string ではなく、名前付きの操作と構造化された input になる。そのため後の policy をより正確に適用できる。s03 では tool と path ごとに許可・拒否を判断し、s04 では共通の hook point で操作を log できる。s02 は、これらの章が利用する dispatch structure を先に用意している。

---

## 概要:ツールディスパッチ

![Tool Dispatch](images/tool-dispatch.ja.svg)
Expand Down
8 changes: 8 additions & 0 deletions s02_tool_use/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,6 +17,14 @@ The model thinks "read this file" but has to spell out `cat path/to/file`. An ex

---

## Why Add Tools If Bash Can Already Do It?

These tools do not give the Agent new raw capabilities — Bash can perform the same operations. They improve the interface between the model and the Harness. A `read_file` call with a `path` argument avoids translating intent into shell syntax, reducing quoting and escaping mistakes.

The Harness also sees a named operation and structured inputs instead of an opaque command string. That makes later policies more precise: s03 can approve or reject operations per tool and path, while s04 can log them at a shared hook point. s02 establishes the dispatch structure those chapters build on.

---

## Overview: Tool Dispatch

![Tool Dispatch](images/tool-dispatch.en.svg)
Expand Down
8 changes: 8 additions & 0 deletions s02_tool_use/README.zh.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,6 +17,14 @@ s01 的 Agent 只有一个 bash 工具。读文件要 `cat`,写文件要 `echo

---

## Bash 已经能做这些事,为什么还要加工具?

这些工具没有给 Agent 增加新的原始能力——同样的操作 Bash 都能完成。它们改善的是模型与 Harness 之间的接口。调用带有 `path` 参数的 `read_file` 时,模型不必把意图翻译成 shell 语法,因此能减少引号和转义错误。

Harness 看到的也不再是一整条不透明的命令字符串,而是具名操作和结构化参数。这样后续策略可以更精确:s03 能按工具和路径决定放行或拒绝,s04 能在统一 hook 点记录操作。s02 先搭好这些章节依赖的分发结构。

---

## 全局视角:工具分发

![Tool Dispatch](images/tool-dispatch.svg)
Expand Down
Loading