設定文件位置
全部開啟Kiro CLI 會把代理的設定文件保存在 ~/.kiro/agents/*.json 路徑中，您可以創建不同的 JSON 設定文件，從而創建自定義的代理出來。
在自定義代理的設定文件中，可以設置 resource 屬性，設置一些文件路徑，這些路徑的文件會被自動包含在聊天中。
{
"resources": [
"file://README.md",
"file://AGENTS.md",
"file://AmazonQ.md",
"file://.amazonq/rules/**/*.md",
"file://.kiro/steering/**/*.md",
"file://~/.kiro/steering/**/*.md"
]
}
所以每次和 CLI 聊天時，它都會自動包含 README 文件，對已有的項目有所瞭解。
自定義代理的設定文件中，可以設置 tools 屬性，包含了啓用哪些 tools。如果您有不想使用的 tools，可以從列表中刪除。
{
"tools": [
"fs_read",
"fs_write",
"execute_bash",
"@git",
"@rust-analyzer/check_code"
]
}
比如，如果不希望 AI 修改本地文件，可以禁用 fs_write 工具和 execute_bash 工具。
詳見官方文件
自定義代理的設定文件中，可以設置 allowedTools 屬性，包含了信任哪些 tools
{
"allowedTools": [
"fs_read",
"fs_*",
"@git/git_status",
"@server/read_*",
"@fetch"
]
}
如果您希望預設信任一些內置工具或 MCP 工具，可以在這裏設定。
詳見官方文件
限制文件路徑的訪問
內置的工具可以設定一些功能細節，比如 fs_read/fs_write 可以限制文件路徑的訪問。
這些可以在自定義代理的設定文件中設置 ToolsSettings 屬性來實現
{
"toolsSettings": {
"fs_write": {
"allowedPaths": ["~/**"]
}
}
}
詳見官方文件
- 在 ~/.kiro/agents/ 目錄下創建新的 JSON 文件
- 設定所需的屬性（resources、tools、allowedTools 等）
- 使用 /agent set-default --name 設置爲預設代理
- 查看當前代理：/agent list
- 切換代理：/agent switch
- 重置爲預設代理：kiro-cli settings --delete chat.defaultAgent
最佳實踐
全部開啟爲不同類型的項目創建專門的代理：
- 前端項目：包含 package.json、tsconfig.json 等前端相關文件
- 後端項目：包含 API 文檔、數據庫設定等後端相關文件
- 運維項目：限制寫權限，專注於查詢和診斷
- 對於生產環境，建議禁用 fs_write 和 execute_bash 工具
- 使用 allowedPaths 限制文件訪問範圍
- 定期審查和更新代理設定