Tool: ask_cloud_assist
The primary interface for Google Cloud Platform assistance. Use this tool to interact with the GCA Root Agent for general troubleshooting, log analysis, or broad cloud inquiries. It acts as the central orchestration agent that directs user requests to expert sub-agents or handles them directly using general-purpose tools.
Capabilities:
- General Inquiries:Answers broad questions about Google Cloud services, concepts, and documentation.
- Estate Queries:Retrieves current resource state and inventory (e.g., "List my active VMs," "Show me the config for this pod").
- Directives:Executes specific, low-complexity directives or status checks.
- Triage & Routing:Handles complex or ambiguous intents (e.g., "Something is wrong with my app") to identify the problem scope before potentially handing off to specialized agents.
- Secure Execution:Orchestrates mutative actions (e.g., "Restart this VM", "Scale this cluster") using a secure Human-in-the-Loop (HITL) workflow. It verifies user consent before executing
gcloudcommands.
Usage Guidelines:
- Default Choice:Select this tool when the user's intent is broad, ambiguous, exploratory, purely informational, or involves planning.
- Triage:Use this tool for initial issue reporting where the specific domain is not yet clear.
- Direct Execution:Use this tool when the user requests a specific, intended change to their environment (e.g., "Restart instance X", "Scale this cluster", "Update the firewall rule").
- Exclusions:
- If the user explicitly asks to design, architect, or deployinfrastructure, use
design_infra. - If the user explicitly asks for deep root cause analysis, debugging, or remediationof a known failure, use
investigate_issue. - If the user explicitly asks about costs, billing, or idle resources, use
optimize_costs.
- If the user explicitly asks to design, architect, or deployinfrastructure, use
Session Management:
- This tool returns a
contextIdin its output. - To continue a conversation (multi-turn), you MUST include this
contextId. - Omit
contextIdto start a new, independent task.
The following sample demonstrate how to use curl
to invoke the ask_cloud_assist
MCP tool.
| Curl Request |
|---|
curl --location 'https://geminicloudassist.googleapis.com/mcp' \ --header 'content-type: application/json' \ --header 'accept: application/json, text/event-stream' \ --data '{ "method": "tools/call", "params": { "name": "ask_cloud_assist", "arguments": { // provide these details according to the tool' s MCP specification } } , "jsonrpc" : "2.0" , "id" : 1 } ' |
Input Schema
Request for AskCloudAssist
AskCloudAssistRequest
| JSON representation |
|---|
{ "project" : string , "userQuery" : string , "contextId" : string } |
| Fields | |
|---|---|
project
|
Required. The project resource name in the format |
userQuery
|
Required. The natural language prompt provided by the user. |
contextId
|
Optional. This is an optional session ID to continue a conversation. |
Output Schema
Represents the response for AskCloudAssist. This message is only used as an output_schema_override.
AskCloudAssistResponse
| JSON representation |
|---|
{ "content" : string , "contextId" : string } |
| Fields | |
|---|---|
content
|
Contains the textual response received from the agent. |
contextId
|
Represents the session ID; clients must persist this. |
Tool Annotations
Destructive Hint: ✅ | Idempotent Hint: ✅ | Read Only Hint: ❌ | Open World Hint: ✅
