HarmonyOS掌上记账APP开发实践第85篇：DevEco Code AI Agent中工具指令详解

工具管理 LLM 可以使用的工具。工具允许 LLM 在您的代码库中执行操作。DevEco Code 自带一组内置工具您也可以通过自定义工具或 MCP 服务器来扩展它。默认情况下所有工具都是启用的且无需权限即可运行。您可以通过权限来控制工具的行为。配置使用permission字段来控制工具行为。您可以对每个工具设置允许、拒绝或需要审批。{ $schema: https://opencode.ai/config.json, permission: { edit: deny, bash: ask, webfetch: allow } }您还可以使用通配符同时控制多个工具。例如要求某个 MCP 服务器的所有工具都需要审批{ $schema: https://opencode.ai/config.json, permission: { mymcp_*: ask } }了解更多关于配置权限的内容。内置工具以下是 DevEco Code 中所有可用的内置工具。bash在项目环境中执行 shell 命令。{ $schema: https://opencode.ai/config.json, permission: { bash: allow } }该工具允许 LLM 运行终端命令例如npm install、git status或其他任何 shell 命令。edit通过精确的字符串替换来修改现有文件。{ $schema: https://opencode.ai/config.json, permission: { edit: allow } }该工具通过替换精确匹配的文本来对文件进行编辑。这是 LLM 修改代码的主要方式。write创建新文件或覆盖现有文件。{ $schema: https://opencode.ai/config.json, permission: { edit: allow } }使用此工具允许 LLM 创建新文件。如果文件已存在则会覆盖现有文件。Notewrite工具由edit权限控制该权限涵盖所有文件修改操作edit、write、patch。read读取代码库中的文件内容。{ $schema: https://opencode.ai/config.json, permission: { read: allow } }该工具读取文件并返回其内容。它支持对大文件读取指定行范围。grep使用正则表达式搜索文件内容。{ $schema: https://opencode.ai/config.json, permission: { grep: allow } }在代码库中快速搜索内容。支持完整的正则表达式语法和文件模式过滤。glob通过模式匹配查找文件。{ $schema: https://opencode.ai/config.json, permission: { glob: allow } }使用**/*.js或src/**/*.ts等 glob 模式搜索文件。返回按修改时间排序的匹配文件路径。lsp实验性与已配置的 LSP 服务器交互获取代码智能功能如定义跳转、引用查找、悬停信息和调用层次结构。Note该工具仅在设置DEVECO_EXPERIMENTAL_LSP_TOOLtrue或DEVECO_EXPERIMENTALtrue时可用。{ $schema: https://opencode.ai/config.json, permission: { lsp: allow } }支持的操作包括goToDefinition、findReferences、hover、documentSymbol、workspaceSymbol、goToImplementation、prepareCallHierarchy、incomingCalls和outgoingCalls。patch对文件应用补丁。{ $schema: https://opencode.ai/config.json, permission: { edit: allow } }该工具将补丁文件应用到您的代码库中。适用于应用来自各种来源的 diff 和补丁。Notepatch工具由edit权限控制该权限涵盖所有文件修改操作edit、write、patch。skill加载一个技能即SKILL.md文件并在对话中返回其内容。{ $schema: https://opencode.ai/config.json, permission: { skill: allow } }todowrite在编码会话中管理待办事项列表。{ $schema: https://opencode.ai/config.json, permission: { todowrite: allow } }创建和更新任务列表以跟踪复杂操作的进度。LLM 使用此工具来组织多步骤任务。Note该工具默认对子代理禁用但您可以手动启用。了解更多webfetch获取网页内容。{ $schema: https://opencode.ai/config.json, permission: { webfetch: allow } }允许 LLM 获取并读取网页内容。适用于查阅文档或研究在线资源。websearch在网络上搜索信息。Note该工具仅在使用 DevEco Code 提供商时或当DEVECO_ENABLE_EXA环境变量设置为任意真值例如true或1时可用。在启动 DevEco Code 时启用DEVECO_ENABLE_EXA1 deveco{ $schema: https://opencode.ai/config.json, permission: { websearch: allow } }使用 Exa AI 进行网络搜索以查找相关信息。适用于研究主题、了解时事动态或获取超出训练数据截止日期的信息。无需 API 密钥——该工具无需身份验证即可直接连接到 Exa AI 的托管 MCP 服务。Tip当您需要查找信息发现时使用websearch当您需要从特定 URL 获取内容检索时使用webfetch。question在执行过程中向用户提问。{ $schema: https://opencode.ai/config.json, permission: { question: allow } }该工具允许 LLM 在执行任务期间向用户提问。适用于以下场景收集用户偏好或需求澄清模糊的指令获取实现方案的决策提供方向选择的选项每个问题包含标题、问题正文和选项列表。用户可以从提供的选项中选择也可以输入自定义答案。当有多个问题时用户可以在提交所有答案之前在各问题之间切换浏览。自定义工具自定义工具允许您定义 LLM 可以调用的自定义函数。这些函数在您的配置文件中定义可以执行任意代码。了解更多关于创建自定义工具的内容。MCP 服务器MCPModel Context Protocol服务器允许您集成外部工具和服务包括数据库访问、API 集成和第三方服务。了解更多关于配置 MCP 服务器的内容。内部机制在内部grep和glob等工具底层使用 ripgrep。默认情况下ripgrep 遵循.gitignore中的模式这意味着.gitignore中列出的文件和目录将被排除在搜索和列表结果之外。忽略模式要包含通常会被忽略的文件请在项目根目录下创建一个.ignore文件。该文件可以显式允许某些路径。!node_modules/ !dist/ !build/例如这个.ignore文件允许 ripgrep 在node_modules/、dist/和build/目录中进行搜索即使它们已在.gitignore中列出。DevEco Code — A