Custom agents reference: new property + update tool names (#58809)

Author: saritai

content/copilot/reference/custom-agents-configuration.md

@@ -25,6 +25,7 @@ The following table outlines the properties that are supported in repository-lev
 | `description` | **Required** string     | Description of the {% data variables.copilot.copilot_custom_agent_short %}'s purpose and capabilities                                                                                                   | {% octicon "check" aria-label="Supported" %}          | {% octicon "check" aria-label="Supported" %}                         | {% octicon "check" aria-label="Supported" %}                  |
 | `target` | string     | Target environment or context for the {% data variables.copilot.copilot_custom_agent_short %} (`vscode` or `github-copilot`). If unset, defaults to both environments.                                                                                                   | {% octicon "check" aria-label="Supported" %}          | {% octicon "check" aria-label="Supported" %}                         | {% octicon "check" aria-label="Supported" %}                  |
 | `tools`       | list of strings, string | List of tool names the {% data variables.copilot.copilot_custom_agent_short %} can use. Supports both a comma separated string and yaml string array. If unset, defaults to all tools. See [Tools](#tools). | {% octicon "check" aria-label="Supported" %}          | {% octicon "check" aria-label="Supported" %}                         | {% octicon "check" aria-label="Supported" %}                  |
+| `infer`       | boolean | Controls whether {% data variables.copilot.copilot_coding_agent %} can automatically use this {% data variables.copilot.copilot_custom_agent_short %} based on task context. When `false`, the agent must be manually selected. If unset, defaults to `true`. | {% octicon "check" aria-label="Supported" %}          | {% octicon "check" aria-label="Supported" %}                         | {% octicon "check" aria-label="Supported" %}                  |
 | `mcp-servers` | object                  | Additional MCP servers and tools that should be used by the {% data variables.copilot.copilot_custom_agent_short %}.                                                                   | {% octicon "x" aria-label="Not supported" %}            | {% octicon "check" aria-label="Supported" %}                         | {% octicon "x" aria-label="Not supported" %}                    |
 | `metadata`   | object consisting of a name and value pair, both strings | Allows annotation of the agent with useful data | {% octicon "check" aria-label="Supported" %} | {% octicon "check" aria-label="Supported" %} | {% octicon "x" aria-label="Not supported" %} |
 
@@ -56,11 +57,11 @@ The following tool aliases are available for {% data variables.copilot.custom_ag
 
 | Primary alias | Compatible aliases                        | {% data variables.copilot.copilot_coding_agent_short_cap_c %} mapping | Purpose                                                                                          |
 | ------------- | -------------------------------------------- | ---------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
-| `shell`       | `Bash`, `powershell`                         | Shell tools: `bash` or `powershell`                             | Execute a command in the appropriate shell for the operating system.                                     |
+| `execute`       | `shell`, `Bash`, `powershell`                         | Shell tools: `bash` or `powershell`                             | Execute a command in the appropriate shell for the operating system.                                     |
 | `read`        | `Read`, `NotebookRead`                       | `view`                                                           | Read file contents.                                                                                      |
 | `edit`        | `Edit`, `MultiEdit`, `Write`, `NotebookEdit` | Edit tools: e.g. `str_replace`, `str_replace_editor`             | Allow LLM to edit. Exact arguments can vary.                                                            |
 | `search`      | `Grep`, `Glob`                               | `search`                                                         | Search for files or text in files.                                                                       |
-| `custom-agent` | `Task`                                       | "{% data variables.copilot.copilot_custom_agent_caps_short %}" tools                                             | Allows a different {% data variables.copilot.copilot_custom_agent_short %} to be invoked to accomplish a task. |
+| `agent` | `custom-agent`, `Task`                                       | "{% data variables.copilot.copilot_custom_agent_caps_short %}" tools                                             | Allows a different {% data variables.copilot.copilot_custom_agent_short %} to be invoked to accomplish a task. |
 | `web`         | `WebSearch`, `WebFetch`                      | Currently not applicable for {% data variables.copilot.copilot_coding_agent_short %}. | Allows fetching content from URLs and performing a web search                                            |
 | `todo`        | `TodoWrite`                                  | Currently not applicable for {% data variables.copilot.copilot_coding_agent_short %}. | Creates and manages structured task lists. Not supported in {% data variables.copilot.copilot_coding_agent_short %} today, but supported by {% data variables.product.prodname_vscode_shortname %}. |