VSCode中GitHub Copilot的Agent模式工具集深度解析

GitHub Copilot 作为AI驱动软件开发的标杆工具，其核心能力依赖于底层自主Agent系统，而本文所解析的18项工具，正是该Agent系统与IDE（主要为VS Code）、文件系统、Git仓库、终端及外部网络交互的标准化接口。这些工具覆盖需求澄清、文件操作、代码检索、错误诊断、版本控制、终端执行、子任务调度及外部信息获取八大核心场景，支撑Copilot Agent完成从需求理解到代码实现、调试验证的全流程自动化开发任务。

本文将以严谨的技术视角，对每一项工具进行全方位拆解，包括工具描述（description）、API参数详解、功能核心解读及典型使用场景，为开发者理解Copilot Agent的工作机制、优化工具调用逻辑提供参考。

一、工具集整体架构与定位

该18项工具隶属于GitHub Copilot Coding Agent（编码智能体），是Copilot Workspace与VS Code Copilot Chat Agent模式的核心执行层，基于模型上下文协议（Model Context Protocol, MCP）实现大语言模型（LLM）与开发环境的标准化交互。

工具集的设计遵循"最小交互、精准执行、全链路覆盖"原则：仅在LLM无法自主判断时与用户交互，通过标准化参数实现环境操作的精准调用，覆盖开发全生命周期的核心需求，最终支撑Copilot Agent实现"自主理解、自主执行、自主验证"的闭环能力。

二、工具分类型深度解析（含Description、API与场景）

按功能定位，将18项工具分为8大类，逐一解析其核心细节，确保每个参数的含义、约束及使用场景清晰可落地。

（一）用户交互类工具：需求澄清与决策确认

此类工具仅用于LLM与用户的交互，核心目的是澄清需求歧义、验证假设、确认实现方案，避免因信息缺失导致执行偏差，是Copilot Agent实现"用户可控"的关键。

1. 工具名称：ask_questions

1.1 工具描述（Description）

Ask the user questions to clarify intent, validate assumptions, or choose between implementation approaches. Prefer proposing a sensible default so users can confirm quickly.

Only use this tool when the user's answer provides information you cannot determine or reasonably assume yourself. This tool is for gathering information, not for reporting status or problems. If a question has an obvious best answer, take that action instead of asking.

When to use:

Clarify ambiguous requirements before proceeding
Get user preferences on implementation choices
Confirm decisions that meaningfully affect outcome

When NOT to use:

The answer is determinable from code or context
Asking for permission to continue or abort
Confirming something you can reasonably decide yourself
Reporting a problem (instead, attempt to resolve it)

Question guidelines:

NEVER use recommended for quizzes or polls. Recommended options are PRE-SELECTED and visible to users, which would reveal answers
Batch related questions into a single call (max 4 questions, 2-6 options each; omit options for free text input)
Provide brief context explaining what is being decided and why
Only mark an option as recommended to suggest YOUR preferred implementation choice
Keep options mutually exclusive for single-select; use multiSelect: true only when choices are additive and phrase the question accordingly

After receiving answers:

Incorporate decisions and continue without re-asking unless requirements change

An "Other" option is automatically shown to users---do not add your own.

1.2 API参数详解

该工具为函数类型（function），参数为对象类型，核心参数如下（严格遵循工具定义的必填项与约束）：

questions：必选参数，数组类型（1-4个元素），用于存储需要向用户提出的问题列表。每个数组元素为一个对象，包含以下属性：
- header：必选参数，字符串类型，最大长度12字符，作为问题的唯一标识，同时作为IDE快速选择界面的标题，便于用户快速识别问题。
- question：必选参数，字符串类型，完整的问题文本，需清晰说明提问目的、决策影响，让用户理解为何需要回答该问题。
- multiSelect：可选参数，布尔类型，默认值为false，用于指定是否允许用户多选答案。仅当选项为可叠加、非互斥时设置为true。
- options：可选参数，数组类型（0-6个元素），用于提供用户可选择的答案选项。若为空或省略，则显示自由文本输入框，允许用户自定义输入。每个选项为对象类型，包含：
  - label：必选参数，字符串类型，选项的显示文本。
  - description：可选参数，字符串类型，对选项的补充说明，帮助用户理解选项的含义与影响。
  - recommended：可选参数，布尔类型，用于标记该选项为推荐选项（仅作为LLM的建议，用户可选择其他选项），禁止用于测验或投票场景。
- allowFreeformInput：可选参数，布尔类型，默认值为false，用于指定是否允许用户在选择选项的同时，输入自定义文本。仅当用户的自定义输入对任务执行有价值时启用。

1.3 功能解读

ask_questions的核心功能是"信息补充"，而非"状态告知"或"权限请求"。其核心约束是：仅当LLM无法通过代码、上下文自主判断信息时调用，若存在明显最优答案，直接执行无需提问。同时支持批量提问（最多4个），减少用户交互次数，提升体验。

1.4 典型使用场景

需求存在歧义时：例如用户提出"优化登录功能"，但未明确是优化登录速度、安全性还是UI，此时调用该工具询问用户具体优化方向。
多实现方案选择时：例如实现文件上传功能，可选择本地存储、OSS存储、FTP存储三种方案，调用该工具让用户选择，同时标记推荐方案（如OSS存储）。
关键决策确认时：例如修改核心函数的参数结构，可能影响全项目调用，此时调用该工具确认用户是否同意该修改方案。

（二）文件与目录操作类工具：工作区资源访问与定位

此类工具是Copilot Agent操作本地工作区的核心接口，负责文件检索、目录遍历、文件内容读取，为代码理解、修改提供基础资源支持，所有工具均基于工作区绝对路径操作，确保定位精准。

2. 工具名称：file_search

2.1 工具描述（Description）

Search for files in the workspace by glob pattern. This only returns the paths of matching files. Use this tool when you know the exact filename pattern of the files you're searching for. Glob patterns match from the root of the workspace folder. Examples:

**/*.{js,ts} to match all js/ts files in the workspace.
src/** to match all files under the top-level src folder.
/foo//*.js to match all js files under any foo folder in the workspace.

2.2 API参数详解

query：必选参数，字符串类型，用于指定Glob匹配模式，从工作区根目录开始匹配，支持通配符（如*、**、{}等），用于定位符合条件的文件路径。
maxResults：可选参数，数字类型，用于指定最大返回结果数。默认情况下仅返回部分匹配结果，非必要不设置，避免影响检索速度；若未找到目标文件，可增大该值或优化query模式。

2.3 功能解读

file_search的核心功能是"文件路径定位"，仅返回匹配文件的路径，不读取文件内容，适用于已知文件类型或路径模式的批量检索场景。其核心优势是基于Glob模式，检索效率高，可快速定位特定类型、特定目录下的文件。

2.4 典型使用场景

批量定位特定类型文件：例如使用**/*.{vue,react}检索工作区所有Vue和React组件文件。
检索指定目录下的文件：例如使用src/utils/**检索src/utils目录下所有文件及子目录文件。
快速获取目标文件绝对路径：例如使用**/config.js检索项目所有配置文件，获取其绝对路径用于后续读取操作。

3. 工具名称：list_dir

3.1 工具描述（Description）

List the contents of a directory. Result will have the name of the child. If the name ends in /, it's a folder, otherwise a file.

3.2 API参数详解

path：必选参数，字符串类型，指定需要列出内容的目录绝对路径，不可为相对路径，否则会导致定位失败。

3.3 功能解读

list_dir的核心功能是"目录内容遍历"，返回指定目录下所有子项（文件和文件夹），通过子项名称是否以"/"结尾区分文件夹（结尾为/）和文件（结尾无/），不返回子项的详细信息（如文件大小、修改时间），仅用于目录结构查看。

3.4 典型使用场景

遍历项目目录结构：例如调用list_dir查看项目根目录下的子目录（src、dist、node_modules等），构建项目全局结构视图。
确认文件/文件夹是否存在：例如判断src/api目录是否存在，若不存在则提示用户或创建目录。
辅助定位目标文件：例如遍历src目录下的子目录，找到存放接口文件的目录，为后续file_search提供方向。

4. 工具名称：read_file

4.1 工具描述（Description）

Read the contents of a file.

You must specify the line range you're interested in. Line numbers are 1-indexed. If the file contents returned are insufficient for your task, you may call this tool again to retrieve more content. Prefer reading larger ranges over doing many small reads.

4.2 API参数详解

filePath：必选参数，字符串类型，指定需要读取的文件绝对路径，需确保文件存在，否则会返回读取失败。
startLine：必选参数，数字类型，起始读取行号，采用1-indexed（即第一行为1），不可为0或负数。
endLine：必选参数，数字类型，结束读取行号（含该 line），需大于等于startLine，否则会返回空内容。

4.3 功能解读

read_file的核心功能是"文件内容读取"，严格要求指定行范围，目的是控制返回内容的Token数量，避免大文件读取导致的上下文溢出。建议优先读取较大的行范围，减少调用次数，提升效率。

4.4 典型使用场景

读取函数、类定义片段：例如读取src/utils/format.js文件中第10-30行的formatDate函数定义，用于分析函数逻辑。
查看文件局部代码逻辑：例如读取配置文件中数据库连接相关的代码片段，确认连接参数。
逐段解析大文件：例如读取大型日志文件或代码文件，分多次读取不同行范围，避免一次性读取过多内容。

5. 工具名称：grep_search

5.1 工具描述（Description）

Do a fast text search in the workspace. Use this tool when you want to search with an exact string or regex. If you are not sure what words will appear in the workspace, prefer using regex patterns with alternation (|) or character classes to search for multiple potential words at once instead of making separate searches. For example, use 'function|method|procedure' to look for all of those words at once. Use includePattern to search within files matching a specific pattern, or in a specific file, using a relative path. Use 'includeIgnoredFiles' to include files normally ignored by .gitignore, other ignore files, and files.exclude and search.exclude settings. Warning: using this may cause the search to be slower, only set it when you want to search in ignored folders like node_modules or build outputs. Use this tool when you want to see an overview of a particular file, instead of using read_file many times to look for code within a file.

5.2 API参数详解

query：必选参数，字符串类型，用于指定搜索的文本或正则表达式，不区分大小写，支持正则交替（|）、字符类等语法。
isRegexp：必选参数，布尔类型，用于指定query是否为正则表达式。true表示正则模式，false表示纯文本模式。
includePattern：可选参数，字符串类型，用于指定搜索范围的Glob匹配模式，仅搜索符合该模式的文件，支持相对路径，禁止在该参数中使用|符号。
maxResults：可选参数，数字类型，指定最大返回结果数，非必要不设置，避免影响检索速度。
includeIgnoredFiles：可选参数，布尔类型，用于指定是否包含.gitignore、files.exclude等配置忽略的文件。启用后检索速度会变慢，仅在需要搜索node_modules、build等忽略目录时设置为true。

5.3 功能解读

grep_search的核心功能是"工作区文本极速检索"，支持纯文本和正则两种模式，可通过includePattern过滤搜索范围，通过includeIgnoredFiles控制是否搜索忽略文件。其优势是检索速度快，适合批量查找关键字、代码模式，可替代多次read_file操作，提升效率。

5.4 典型使用场景

全文检索关键字、函数名、变量：例如使用query="formatDate"、isRegexp=false，检索工作区所有包含formatDate函数的文件及位置。
批量查找代码模式与注释：例如使用query="// TODO"、isRegexp=false，检索所有待办注释；使用query="function|method"、isRegexp=true，检索所有函数/方法定义。
检索忽略文件中的内容：例如设置includeIgnoredFiles=true，检索node_modules中某个依赖包的源码逻辑。

6. 工具名称：semantic_search

6.1 工具描述（Description）

Run a natural language search for relevant code or documentation comments from the user's current workspace. Returns relevant code snippets from the user's current workspace if it is large, or the full contents of the workspace if it is small.

6.2 API参数详解

query：必选参数，字符串类型，用于指定自然语言搜索指令，需包含所有相关上下文，理想情况下应包含可能出现在代码或注释中的文本（如函数功能、变量含义等）。

6.3 功能解读

semantic_search的核心功能是"语义级代码检索"，区别于grep_search的"文本匹配"，其基于自然语言意图匹配相关代码，无需精确匹配关键字，适合模糊检索、功能意图检索场景。检索结果根据工作区大小返回：大型工作区返回相关代码片段，小型工作区返回完整内容。

6.4 典型使用场景

按功能意图检索代码：例如query="实现用户登录验证的代码"，检索工作区中所有与用户登录验证相关的代码片段。
模糊匹配无明确名称的逻辑模块：例如query="处理文件上传异常的逻辑"，无需知道具体函数名，即可检索相关实现。
大型项目中快速定位相关实现：例如在大型前端项目中，query="路由拦截器实现"，快速找到路由拦截相关的代码。

（三）代码理解与分析类工具：符号检索与笔记本解析

此类工具专注于代码语义理解，负责检索代码符号（函数、类、变量等）的使用情况、解析Jupyter Notebook元信息，为Copilot Agent提供代码逻辑分析能力，支撑代码重构、调试等场景。

7. 工具名称：list_code_usages

7.1 工具描述（Description）

Request to list all usages (references, definitions, implementations etc) of a function, class, method, variable etc. Use this tool when

Looking for a sample implementation of an interface or class
Checking how a function is used throughout the codebase.
Including and updating all usages when changing a function, method, or constructor

7.2 API参数详解

symbolName：必选参数，字符串类型，指定需要检索的符号名称，可为函数名、类名、方法名、变量名等。
filePaths：可选参数，数组类型，指定可能包含该符号定义的一个或多个文件路径。该参数可加速检索速度、提升结果准确性，非必选但建议设置。

7.3 功能解读

list_code_usages的核心功能是"代码符号全量检索"，可返回符号的定义位置、引用位置、实现位置等所有相关信息，支撑代码理解与重构场景。其优势是能快速定位符号在全代码库中的使用情况，避免手动查找遗漏。

7.4 典型使用场景

接口/类的实现样本查找：例如检索接口UserService的所有实现类，找到可参考的实现逻辑。
函数全库调用链路分析：例如检索formatDate函数的所有调用位置，分析该函数的使用场景与依赖关系。
重构时批量定位待修改点：例如修改getUserInfo函数的参数，调用该工具找到所有调用该函数的位置，批量修改参数传递。

8. 工具名称：copilot_getNotebookSummary

8.1 工具描述（Description）

This is a tool returns the list of the Notebook cells along with the id, cell types, line ranges, language, execution information and output mime types for each cell. This is useful to get Cell Ids when executing a notebook or determine what cells have been executed and what order, or what cells have outputs. If required to read contents of a cell use this to determine the line range of a cells, and then use read_file tool to read a specific line range. Requery this tool if the contents of the notebook change.

8.2 API参数详解

filePath ：必选参数，字符串类型，指定Notebook文件的绝对路径，可为已保存的.ipynb文件路径，也可为未命名文件的URI（如untitled:Untitled-1.ipynb）。

8.3 功能解读

copilot_getNotebookSummary的核心功能是"Jupyter Notebook元信息解析"，不返回单元格内容，仅返回单元格的元数据（ID、类型、行范围、语言、执行状态、输出类型等）。其作用是辅助定位Notebook单元格，为后续执行单元格、读取单元格内容提供支撑，当Notebook内容变化时，需重新调用该工具。

8.4 典型使用场景

定位可执行单元格：例如获取Notebook中所有代码单元格的ID，用于批量执行单元格。
检查单元格执行顺序与输出：例如查看Notebook中单元格的执行状态（已执行/未执行）、执行顺序，以及是否有输出结果。
辅助读取指定单元格内容：例如通过该工具获取某个单元格的行范围，再调用read_file工具读取该单元格的具体内容。

（四）错误与测试诊断类工具：问题定位与验证

此类工具负责采集开发过程中的错误信息（编译、Lint错误）与测试失败信息，为Copilot Agent提供问题定位能力，支撑错误修复、测试验证等场景。

9. 工具名称：get_errors

9.1 工具描述（Description）

Get any compile or lint errors in a specific file or across all files. If the user mentions errors or problems in a file, they may be referring to these. Use the tool to see the same errors that the user is seeing. If the user asks you to analyze all errors, or does not specify a file, use this tool to gather errors for all files. Also use this tool after editing a file to validate the change.

9.2 API参数详解

filePaths：可选参数，数组类型，指定需要检查错误的文件或文件夹绝对路径。若省略该参数，则检索全工作区的所有错误。

9.3 功能解读

get_errors的核心功能是"错误信息采集"，可获取工作区的编译错误、Lint错误，与用户在IDE中看到的错误信息一致。其使用场景覆盖错误分析、代码修改验证，是Copilot Agent实现错误修复闭环的关键工具。

9.4 典型使用场景

代码修改后语法校验：例如修改某个JavaScript文件后，调用该工具检查是否存在语法错误、Lint警告。
批量定位项目错误：例如用户反馈项目无法运行，调用该工具检索全工作区错误，定位问题根源。
自动化错误修复闭环：例如Copilot Agent修复错误后，调用该工具验证修复效果，确认无残留错误。

10. 工具名称：test_failure

10.1 工具描述（Description）

Includes test failure information in the prompt.

10.2 API参数详解

该工具无入参，调用后自动将当前工作区的测试失败信息注入LLM上下文，无需额外配置。

10.3 功能解读

test_failure的核心功能是"测试失败信息注入"，无需手动采集测试失败详情，调用后即可让LLM获取测试失败的相关信息（如失败用例、错误日志等），辅助LLM分析测试失败原因，支撑测试用例修复场景。

10.4 典型使用场景

测试用例失败原因分析：例如运行单元测试后出现失败，调用该工具将失败信息注入上下文，让LLM分析失败原因。
自动化测试问题修复：例如Copilot Agent修复代码后，运行测试出现失败，调用该工具获取失败信息，进一步优化代码。
结合终端输出定位故障：例如终端运行测试命令后失败，调用test_failure获取失败详情，结合get_terminal_output进一步定位问题。

（五）Git版本控制类工具：变更管理与冲突处理

此类工具负责与Git仓库交互，采集文件变更信息、过滤变更状态，支撑Copilot Agent完成代码提交审查、冲突处理、增量修改分析等场景，与Git命令行功能形成互补。

11. 工具名称：get_changed_files

11.1 工具描述（Description）

Get git diffs of current file changes in a git repository. Don't forget that you can use run_in_terminal to run git commands in a terminal as well.

11.2 API参数详解

repositoryPath：可选参数，字符串类型，指定Git仓库的绝对路径。若未提供，则使用当前活动的Git仓库。
sourceControlState：可选参数，数组类型，用于过滤文件变更状态，允许的值为staged（暂存）、unstaged（未暂存）、merge-conflicts（合并冲突）。若未提供，则返回所有状态的变更文件。

11.3 功能解读

get_changed_files的核心功能是"Git变更信息采集"，返回指定Git仓库中文件的变更diff信息，支持按暂存、未暂存、冲突状态过滤，可替代git diff命令，为Copilot Agent提供变更分析能力。同时提示可结合终端命令（run_in_terminal）执行其他Git操作。

11.4 典型使用场景

代码提交前变更审查：例如提交代码前，调用该工具查看所有暂存、未暂存的变更，确认变更内容是否符合需求。
冲突文件自动定位与处理：例如Git合并出现冲突，调用该工具过滤merge-conflicts状态的文件，定位冲突位置并辅助修复。
增量修改分析与修复：例如用户反馈某个功能异常，调用该工具查看近期变更文件，分析是否是变更导致的问题。

（六）终端执行类工具：命令交互与结果采集

此类工具负责与IDE终端交互，获取终端命令输出、历史命令、选中内容，支撑Copilot Agent执行终端命令、分析命令结果、追溯执行历史等场景，是Copilot Agent与终端交互的核心接口。

12. 工具名称：get_terminal_output

12.1 工具描述（Description）

Get the output of a terminal command previously started with run_in_terminal.

12.2 API参数详解

id：必选参数，字符串类型，指定终端会话的ID，用于定位需要获取输出的终端会话，该ID由run_in_terminal命令返回。

12.3 功能解读

get_terminal_output的核心功能是"终端命令输出采集"，仅能获取通过run_in_terminal启动的终端命令的输出，需通过终端ID定位会话，无法获取手动在终端输入的命令输出，是Copilot Agent验证终端命令执行结果的关键工具。

12.4 典型使用场景

构建、运行、测试命令结果采集：例如通过run_in_terminal执行npm run build命令后，调用该工具获取构建输出，判断构建是否成功。
自动化调试与错误捕获：例如执行node app.js命令后，调用该工具获取终端输出的错误日志，定位程序运行异常原因。

13. 工具名称：terminal_last_command

13.1 工具描述（Description）

Get the last command run in the active terminal.

13.2 API参数详解

该工具无入参，调用后自动获取当前活动终端（用户当前正在操作的终端）中最后执行的命令，无论该命令是手动输入还是通过run_in_terminal执行。

13.3 功能解读

terminal_last_command的核心功能是"终端历史命令获取"，仅返回最后一条执行的命令，不返回命令输出，用于追溯终端执行历史，辅助复现命令执行上下文。

13.4 典型使用场景

复现命令执行上下文：例如用户反馈终端命令执行失败，但未告知具体命令，调用该工具获取最后执行的命令，复现执行场景。
命令执行失败原因追溯：例如终端命令执行失败，获取最后执行的命令，结合get_terminal_output获取输出，分析失败原因。

14. 工具名称：terminal_selection

14.1 工具描述（Description）

Get the current selection in the active terminal.

14.2 API参数详解

该工具无入参，调用后自动获取当前活动终端中用户选中的文本内容，若用户未选中任何内容，则返回空。

14.3 功能解读

terminal_selection的核心功能是"终端选中内容获取"，用于提取终端日志中的关键片段，辅助LLM精准分析问题，无需获取完整终端输出，提升效率。

14.4 典型使用场景

提取终端日志关键片段：例如终端输出大量日志，用户选中其中的错误信息片段，调用该工具获取选中内容，精准分析错误原因。
局部错误信息精准分析：例如终端输出中包含多个错误，用户选中某个错误片段，调用该工具获取该片段，针对性分析修复。

（七）外部信息获取类工具：远程资源检索

此类工具负责与外部网络交互，抓取网页内容、检索外部GitHub仓库代码，为Copilot Agent提供外部参考资料，支撑代码实现、文档查阅等场景。

15. 工具名称：fetch_webpage

15.1 工具描述（Description）

Fetches the main content from a web page. This tool is useful for summarizing or analyzing the content of a webpage. You should use this tool when you think the user is looking for information from a specific webpage.

15.2 API参数详解

urls：必选参数，数组类型，指定需要抓取内容的URL列表，支持多个URL同时抓取。
query：必选参数，字符串类型，指定需要在网页内容中提取的目标描述，需清晰、简洁，便于工具精准提取相关内容。

15.3 功能解读

fetch_webpage的核心功能是"网页主体内容抓取与提取"，仅抓取网页的核心内容（过滤广告、导航等无关内容），并根据query提取相关信息，用于外部文档查阅、技术资料获取，支撑Copilot Agent结合外部信息实现代码开发。

15.4 典型使用场景

官方文档、技术文章内容获取：例如抓取Node.js官方文档中"fs模块使用方法"的相关内容，辅助代码实现。
接口说明、版本信息远程检索：例如抓取第三方API的接口文档，获取接口参数、请求方式等信息，用于接口调用代码开发。
辅助代码实现的外部资料解析：例如用户需要实现某个功能，调用该工具抓取相关技术博客的实现教程，参考实现逻辑。

16. 工具名称：github_repo

16.1 工具描述（Description）

Searches a GitHub repository for relevant source code snippets. Only use this tool if the user is very clearly asking for code snippets from a specific GitHub repository. Do not use this tool for Github repos that the user has open in their workspace.

16.2 API参数详解

repo：必选参数，字符串类型，指定需要检索的GitHub仓库名称，格式必须为"owner/repo"（如"octocat/hello-world"）。
query：必选参数，字符串类型，指定检索关键词，需包含所有相关上下文，用于定位仓库中的相关代码片段。

16.3 功能解读

github_repo的核心功能是"外部GitHub仓库代码检索"，仅用于检索用户未在工作区打开的GitHub仓库，返回相关代码片段，不支持检索本地工作区已打开的GitHub仓库（此类仓库可通过file_search、grep_search等工具检索）。其核心作用是为Copilot Agent提供开源项目参考。

16.4 典型使用场景

参考开源项目实现：例如用户需要实现一个分页组件，调用该工具检索"vuejs/vue"仓库中分页相关的代码片段，参考实现逻辑。
检索依赖库源码逻辑：例如使用某个第三方依赖包，调用该工具检索其GitHub仓库源码，理解底层实现逻辑，便于调试。
跨仓库代码样本查找：例如检索"facebook/react"仓库中"hooks使用示例"的代码片段，辅助React hooks开发。

（八）Agent调度与内部辅助类工具：复杂任务解耦与效率提升

此类工具负责Copilot Agent的内部调度与辅助，支持启动子Agent处理复杂任务、复用IDE搜索结果，提升Agent执行效率，支撑复杂多步开发任务的完成。

17. 工具名称：runSubagent

17.1 工具描述（Description）

Launch a new agent to handle complex, multi-step tasks autonomously. This tool is good at researching complex questions, searching for code, and executing multi-step tasks. When you are searching for a keyword or file and are not confident that you will find the right match in the first few tries, use this agent to perform the search for you.

Agents do not run async or in the background, you will wait for the agent's result.
When the agent is done, it will return a single message back to you. The result returned by the agent is not visible to the user. To show the user the result, you should send a text message back to the user with a concise summary of the result.
Each agent invocation is stateless. You will not be able to send additional messages to the agent, nor will the agent be able to communicate with you outside of its final report. Therefore, your prompt should contain a highly detailed task description for the agent to perform autonomously and you should specify exactly what information the agent should return back to you in its final and only message to you.
The agent's outputs should generally be trusted
Clearly tell the agent whether you expect it to write code or just to do research (search, file reads, web fetches, etc.), since it is not aware of the user's intent

17.2 API参数详解

prompt：必选参数，字符串类型，用于指定子Agent的任务指令，需详细、具体，包含所有任务细节、执行要求、返回结果要求，确保子Agent能自主完成任务。
description：必选参数，字符串类型，3-5个词的任务简述，用于标识子Agent的任务类型（如"代码检索""错误修复"）。

17.3 功能解读

runSubagent的核心功能是"子Agent启动与调度"，用于将复杂、多步的任务解耦，由子Agent自主完成，主Agent同步阻塞等待结果。子Agent的执行结果仅返回给主Agent，不直接展示给用户，需主Agent整理后反馈。子Agent为无状态，无法与主Agent进行多轮交互，因此prompt需足够详细。

17.4 典型使用场景

复杂代码库深度检索：例如需要在大型代码库中检索"用户权限管理相关的所有代码"，调用子Agent自主完成检索、整理，主Agent等待结果并反馈给用户。
多文件跨模块修改：例如需要修改项目中所有与用户头像上传相关的代码（涉及前端组件、后端接口、数据库模型），调用子Agent自主完成多文件修改，主Agent验证修改结果。
长流程自动化任务解耦执行：例如"从GitHub仓库拉取代码→安装依赖→运行测试→修复测试失败→提交代码"，将该长流程交给子Agent自主完成，主Agent仅等待最终结果。

18. 工具名称：get_search_view_results

18.1 工具描述（Description）

The results from the search view.

18.2 API参数详解

该工具无入参，调用后自动获取VS Code搜索视图中已有的搜索结果，无需重新执行检索。

18.3 功能解读

get_search_view_results的核心功能是"IDE搜索结果复用"，属于Copilot Agent的内部辅助工具，用于获取用户在VS Code搜索视图中已执行的搜索结果，减少重复检索，提升Agent执行效率，无需用户额外操作。

18.4 典型使用场景

复用IDE已有搜索结果：例如用户已在VS Code搜索视图中检索"login"相关内容，Copilot Agent调用该工具获取搜索结果，无需重新执行grep_search或semantic_search。
减少重复检索提升效率：例如Agent需要多次使用同一搜索结果，调用该工具复用结果，避免重复检索消耗资源。

三、工具调用策略与工程最佳实践

Copilot Agent工具集的调用需遵循"效率优先、精准执行、最小交互"的原则，结合工具特性与使用场景，优化调用逻辑，提升任务执行效率与准确性，以下为核心调用策略与最佳实践：

3.1 文件操作调用优先级

遵循"目录遍历→文件定位→内容读取"的顺序：先通过list_dir遍历目录结构，明确目标文件所在位置；再通过file_search定位具体文件路径；最后通过read_file读取指定行范围内容，避免盲目读取文件，降低资源消耗。

3.2 搜索策略分层

精准文本匹配：使用grep_search，适用于已知关键字、正则模式的检索场景，效率最高。
意图模糊匹配：使用semantic_search，适用于不知道具体关键字、仅明确功能意图的检索场景。
文件路径定位：使用file_search，适用于已知文件类型、路径模式的批量检索场景。

3.3 执行闭环流程

针对代码开发、调试类任务，遵循"执行→验证→修复"的闭环：

代码修改 → get_errors 语法校验 → run_in_terminal 执行命令 → get_terminal_output 验证结果 → test_failure 测试校验 → （若有错误）启动子Agent修复 → 重新验证。

3.4 交互最小化原则

仅在以下场景调用ask_questions：需求存在歧义、多实现方案无法自主判断、关键决策影响任务结果；若存在明显最优答案，直接执行无需提问；批量提问（最多4个），减少用户交互次数。

3.5 子Agent使用场景

仅在任务复杂、多步骤、需自主决策时调用runSubagent，例如复杂代码检索、多文件修改、长流程自动化任务；prompt需详细明确，指定任务细节与返回要求，避免子Agent执行偏差。

四、总结

本文解析的18项工具，构成了GitHub Copilot自主编码Agent的完整能力底盘，以标准化函数调用的形式，实现了LLM与开发环境（IDE、文件系统、Git、终端、外部网络）的无缝交互，覆盖了软件开发全生命周期的核心需求。

这些工具的设计既兼顾了精准性与效率，又实现了用户可控性与Agent自主性的平衡：通过标准化参数确保操作精准，通过分层工具覆盖不同场景，通过最小交互原则提升用户体验，通过子Agent调度支撑复杂任务执行。

对于开发者而言，理解这些工具的功能、API与使用场景，不仅能深入掌握GitHub Copilot的工作机制，还能为自定义Agent开发、工具调用优化提供参考，助力AI驱动软件开发效率的进一步提升。未来，随着Copilot Agent能力的迭代，该工具集也将不断丰富，进一步拓展AI在软件开发中的应用边界。