wehub/google--adk-python
1
0
Fork 0
Code Issues Pull Requests Actions Deployments Models Agent Notes Packages Projects Releases Wiki Activity

chore: import upstream snapshot with attribution
Continuous Integration / Pre-commit Linter (push) Has been cancelled
Details
Continuous Integration / Mypy Check (Python 3.10) (push) Has been cancelled
Details
Continuous Integration / Mypy Check (Python 3.11) (push) Has been cancelled
Details
Continuous Integration / Mypy Check (Python 3.12) (push) Has been cancelled
Details
Continuous Integration / Mypy Check (Python 3.13) (push) Has been cancelled
Details
Continuous Integration / Unit Tests (Python 3.10) (push) Has been cancelled
Details
Continuous Integration / Unit Tests (Python 3.11) (push) Has been cancelled
Details
Continuous Integration / Unit Tests (Python 3.12) (push) Has been cancelled
Details
Continuous Integration / Unit Tests (Python 3.13) (push) Has been cancelled
Details
Continuous Integration / Unit Tests (Python 3.14) (push) Has been cancelled
Details
Continuous Integration / A2A v0.3 Tests (Python 3.10) (push) Has been cancelled
Details
Continuous Integration / A2A v0.3 Tests (Python 3.11) (push) Has been cancelled
Details
Continuous Integration / A2A v0.3 Tests (Python 3.12) (push) Has been cancelled
Details
Copybara PR Handler / close-imported-pr (push) Has been cancelled
Details
Continuous Integration / A2A v0.3 Tests (Python 3.13) (push) Has been cancelled
Details
Continuous Integration / A2A v0.3 Tests (Python 3.14) (push) Has been cancelled
Details

Browse Source
This commit is contained in:
wehub-resource-sync
2026-07-13 13:25:13 +08:00
commit ec2b666284
2231 changed files with 491535 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
contributing/samples/hitl/tool_confirmation/README.md
+64
View File
@@ -0,0 +1,64 @@
# Tool Confirmation Sample
## Overview
This sample demonstrates how to use the Tool Confirmation feature in ADK to implement Human-in-the-Loop (HITL) flows. It shows how a tool can dynamically request confirmation from the user before proceeding with a sensitive action (e.g., transferring funds).
## Sample Inputs
- `Transfer $50 to Alice`
- `Transfer $200 to Bob`
- `Close account ACC123`
- `Transfer $500 to Charlie and close account ACC123`
*This will cause parallel tools being called in a single step*
## How To
### 1. Requesting Confirmation
In your tool function, you can access the `ToolContext` and check if `tool_confirmation` is present. If not, you can call `tool_context.request_confirmation()` to request approval from the user.
```python
def transfer_funds(amount: float, recipient: str, tool_context: ToolContext):
# Only request confirmation for amounts >= 100
if amount >= 100:
if not tool_context.tool_confirmation:
tool_context.request_confirmation(
hint=f"Confirm transfer of ${amount} to {recipient}.",
)
return {"error": "This tool call requires confirmation, please approve or reject."}
```
### 2. Handling the Response
When the user responds to the confirmation request, the tool will be called again. This time, `tool_context.tool_confirmation` will be populated with the user's decision (`confirmed` boolean).
```python
elif not tool_context.tool_confirmation.confirmed:
return {"error": "Transfer rejected by user."}
return {"result": f"Successfully transferred ${amount} to {recipient}."}
```
### 3. Using `FunctionTool` for Automatic Confirmation
Alternatively, you can specify that a tool always requires confirmation by wrapping it in a `FunctionTool` and setting `require_confirmation=True` when defining the agent's tools. In this case, the runner will automatically handle the confirmation request before calling your function.
```python
from google.adk.tools.function_tool import FunctionTool
def close_account(account_id: str, tool_context: ToolContext):
# This code only runs if the user approves the confirmation
return {"result": f"Account {account_id} closed."}
root_agent = Agent(
...
tools=[
FunctionTool(func=close_account, require_confirmation=True),
],
)
```
contributing/samples/hitl/tool_confirmation/__init__.py
+15
View File
@@ -0,0 +1,15 @@
# Copyright 2026 Google LLC
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
from . import agent
contributing/samples/hitl/tool_confirmation/agent.py
+57
View File
@@ -0,0 +1,57 @@
# Copyright 2026 Google LLC
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
from __future__ import annotations
from google.adk.agents import Agent
from google.adk.tools.function_tool import FunctionTool
from google.adk.tools.tool_context import ToolContext
def transfer_funds(
amount: float, recipient: str, tool_context: ToolContext
) -> dict[str, str]:
"""Transfers funds to a recipient."""
# Only request confirmation for amounts >= 100
if amount >= 100:
if not tool_context.tool_confirmation:
tool_context.request_confirmation(
hint=f"Confirm transfer of ${amount} to {recipient}.",
)
return {
"error": (
"This tool call requires confirmation, please approve or reject."
)
}
elif not tool_context.tool_confirmation.confirmed:
return {"error": "Transfer rejected by user."}
# Proceed with transfer for amounts < 100 or if confirmed
return {"result": f"Successfully transferred ${amount} to {recipient}."}
def close_account(account_id: str) -> dict[str, str]:
"""Closes a user account. This is a destructive action."""
# With require_confirmation=True, this function is only called if the user
# approves.
return {"result": f"Account {account_id} closed successfully."}
root_agent = Agent(
name="money_transfer_assistant",
tools=[
transfer_funds,
FunctionTool(func=close_account, require_confirmation=True),
],
)
contributing/samples/hitl/tool_confirmation/tests/Transfer_500_and_close_account_ACC123.json
+276
View File
@@ -0,0 +1,276 @@
{
"events": [
{
"author": "user",
"content": {
"parts": [
{
"text": "Transfer $500 to Charlie and close account ACC123"
}
],
"role": "user"
},
"id": "e-1",
"invocationId": "i-1",
"nodeInfo": {
"path": ""
}
},
{
"author": "money_transfer_assistant",
"content": {
"parts": [
{
"functionCall": {
"args": {
"amount": 500,
"recipient": "Charlie"
},
"id": "fc-1",
"name": "transfer_funds"
}
},
{
"functionCall": {
"args": {
"account_id": "ACC123"
},
"id": "fc-2",
"name": "close_account"
}
}
],
"role": "model"
},
"finishReason": "STOP",
"id": "e-2",
"invocationId": "i-1",
"longRunningToolIds": [],
"nodeInfo": {
"path": "money_transfer_assistant@1"
}
},
{
"author": "money_transfer_assistant",
"content": {
"parts": [
{
"functionCall": {
"args": {
"originalFunctionCall": {
"args": {
"amount": 500,
"recipient": "Charlie"
},
"id": "fc-1",
"name": "transfer_funds"
},
"toolConfirmation": {
"confirmed": false,
"hint": "Confirm transfer of $500 to Charlie."
}
},
"id": "fc-3",
"name": "adk_request_confirmation"
}
},
{
"functionCall": {
"args": {
"originalFunctionCall": {
"args": {
"account_id": "ACC123"
},
"id": "fc-2",
"name": "close_account"
},
"toolConfirmation": {
"confirmed": false,
"hint": "Please approve or reject the tool call close_account() by responding with a FunctionResponse with an expected ToolConfirmation payload."
}
},
"id": "fc-4",
"name": "adk_request_confirmation"
}
}
],
"role": "model"
},
"id": "e-3",
"invocationId": "i-1",
"longRunningToolIds": [
"fc-4",
"fc-3"
],
"nodeInfo": {
"path": "money_transfer_assistant@1"
}
},
{
"actions": {
"requestedToolConfirmations": {
"fc-1": {
"confirmed": false,
"hint": "Confirm transfer of $500 to Charlie."
},
"fc-2": {
"confirmed": false,
"hint": "Please approve or reject the tool call close_account() by responding with a FunctionResponse with an expected ToolConfirmation payload."
}
},
"skipSummarization": true
},
"author": "money_transfer_assistant",
"content": {
"parts": [
{
"functionResponse": {
"id": "fc-1",
"name": "transfer_funds",
"response": {
"error": "This tool call requires confirmation, please approve or reject."
}
}
},
{
"functionResponse": {
"id": "fc-2",
"name": "close_account",
"response": {
"error": "This tool call requires confirmation, please approve or reject."
}
}
}
],
"role": "user"
},
"id": "e-4",
"invocationId": "i-1",
"nodeInfo": {
"path": "money_transfer_assistant@1"
}
},
{
"author": "user",
"content": {
"parts": [
{
"functionResponse": {
"id": "fc-3",
"name": "adk_request_confirmation",
"response": {
"confirmed": true
}
}
}
],
"role": "user"
},
"id": "e-5",
"invocationId": "i-1",
"nodeInfo": {
"path": ""
}
},
{
"author": "money_transfer_assistant",
"content": {
"parts": [
{
"functionResponse": {
"id": "fc-1",
"name": "transfer_funds",
"response": {
"result": "Successfully transferred $500 to Charlie."
}
}
}
],
"role": "user"
},
"id": "e-6",
"invocationId": "i-1",
"nodeInfo": {
"path": "money_transfer_assistant@1"
}
},
{
"author": "money_transfer_assistant",
"content": {
"parts": [
{
"text": "I transferred $500 to Charlie. I can close account ACC123, but it is a destructive action that requires confirmation. Do you want me to go ahead and close it?"
}
],
"role": "model"
},
"finishReason": "STOP",
"id": "e-7",
"invocationId": "i-1",
"nodeInfo": {
"path": "money_transfer_assistant@1"
}
},
{
"author": "user",
"content": {
"parts": [
{
"functionResponse": {
"id": "fc-4",
"name": "adk_request_confirmation",
"response": {
"confirmed": true
}
}
}
],
"role": "user"
},
"id": "e-8",
"invocationId": "i-1",
"nodeInfo": {
"path": ""
}
},
{
"author": "money_transfer_assistant",
"content": {
"parts": [
{
"functionResponse": {
"id": "fc-2",
"name": "close_account",
"response": {
"result": "Account ACC123 closed successfully."
}
}
}
],
"role": "user"
},
"id": "e-9",
"invocationId": "i-1",
"nodeInfo": {
"path": "money_transfer_assistant@1"
}
},
{
"author": "money_transfer_assistant",
"content": {
"parts": [
{
"text": "I have transferred $500 to Charlie and closed account ACC123.\n"
}
],
"role": "model"
},
"finishReason": "STOP",
"id": "e-10",
"invocationId": "i-1",
"nodeInfo": {
"path": "money_transfer_assistant@1"
}
}
]
}
contributing/samples/hitl/tool_confirmation/tests/close_account_acc123.json
+171
View File
@@ -0,0 +1,171 @@
{
"events": [
{
"author": "user",
"content": {
"parts": [
{
"text": "Close account ACC123\n"
}
],
"role": "user"
},
"id": "e-1",
"invocationId": "i-1",
"nodeInfo": {
"path": ""
}
},
{
"author": "money_transfer_assistant",
"content": {
"parts": [
{
"functionCall": {
"args": {
"account_id": "ACC123"
},
"id": "fc-1",
"name": "close_account"
}
}
],
"role": "model"
},
"finishReason": "STOP",
"id": "e-2",
"invocationId": "i-1",
"longRunningToolIds": [],
"nodeInfo": {
"path": "money_transfer_assistant@1"
}
},
{
"author": "money_transfer_assistant",
"content": {
"parts": [
{
"functionCall": {
"args": {
"originalFunctionCall": {
"args": {
"account_id": "ACC123"
},
"id": "fc-1",
"name": "close_account"
},
"toolConfirmation": {
"confirmed": false,
"hint": "Please approve or reject the tool call close_account() by responding with a FunctionResponse with an expected ToolConfirmation payload."
}
},
"id": "fc-2",
"name": "adk_request_confirmation"
}
}
],
"role": "model"
},
"id": "e-3",
"invocationId": "i-1",
"longRunningToolIds": [
"fc-2"
],
"nodeInfo": {
"path": "money_transfer_assistant@1"
}
},
{
"actions": {
"requestedToolConfirmations": {
"fc-1": {
"confirmed": false,
"hint": "Please approve or reject the tool call close_account() by responding with a FunctionResponse with an expected ToolConfirmation payload."
}
},
"skipSummarization": true
},
"author": "money_transfer_assistant",
"content": {
"parts": [
{
"functionResponse": {
"id": "fc-1",
"name": "close_account",
"response": {
"error": "This tool call requires confirmation, please approve or reject."
}
}
}
],
"role": "user"
},
"id": "e-4",
"invocationId": "i-1",
"nodeInfo": {
"path": "money_transfer_assistant@1"
}
},
{
"author": "user",
"content": {
"parts": [
{
"functionResponse": {
"id": "fc-2",
"name": "adk_request_confirmation",
"response": {
"confirmed": true
}
}
}
],
"role": "user"
},
"id": "e-5",
"invocationId": "i-1",
"nodeInfo": {
"path": ""
}
},
{
"author": "money_transfer_assistant",
"content": {
"parts": [
{
"functionResponse": {
"id": "fc-1",
"name": "close_account",
"response": {
"result": "Account ACC123 closed successfully."
}
}
}
],
"role": "user"
},
"id": "e-6",
"invocationId": "i-1",
"nodeInfo": {
"path": "money_transfer_assistant@1"
}
},
{
"author": "money_transfer_assistant",
"content": {
"parts": [
{
"text": "I have closed the account ACC123."
}
],
"role": "model"
},
"finishReason": "STOP",
"id": "e-7",
"invocationId": "i-1",
"nodeInfo": {
"path": "money_transfer_assistant@1"
}
}
]
}
contributing/samples/hitl/tool_confirmation/tests/transfer_200_confirmed.json
+189
View File
@@ -0,0 +1,189 @@
{
"events": [
{
"author": "user",
"content": {
"parts": [
{
"text": "Transfer $200 to Bob"
}
],
"role": "user"
},
"id": "e-1",
"invocationId": "i-1",
"nodeInfo": {
"path": ""
}
},
{
"author": "money_transfer_assistant",
"content": {
"parts": [
{
"functionCall": {
"args": {
"amount": 200,
"recipient": "Bob"
},
"id": "fc-1",
"name": "transfer_funds"
}
}
],
"role": "model"
},
"finishReason": "STOP",
"id": "e-2",
"invocationId": "i-1",
"longRunningToolIds": [],
"nodeInfo": {
"path": "money_transfer_assistant@1"
}
},
{
"author": "money_transfer_assistant",
"content": {
"parts": [
{
"functionCall": {
"args": {
"originalFunctionCall": {
"args": {
"amount": 200,
"recipient": "Bob"
},
"id": "fc-1",
"name": "transfer_funds"
},
"toolConfirmation": {
"confirmed": false,
"hint": "Confirm transfer of $200 to Bob."
}
},
"id": "fc-2",
"name": "adk_request_confirmation"
}
}
],
"role": "model"
},
"id": "e-3",
"invocationId": "i-1",
"longRunningToolIds": [
"fc-2"
],
"nodeInfo": {
"path": "money_transfer_assistant@1"
}
},
{
"actions": {
"requestedToolConfirmations": {
"fc-1": {
"confirmed": false,
"hint": "Confirm transfer of $200 to Bob."
}
}
},
"author": "money_transfer_assistant",
"content": {
"parts": [
{
"functionResponse": {
"id": "fc-1",
"name": "transfer_funds",
"response": {
"error": "This tool call requires confirmation, please approve or reject."
}
}
}
],
"role": "user"
},
"id": "e-4",
"invocationId": "i-1",
"nodeInfo": {
"path": "money_transfer_assistant@1"
}
},
{
"author": "money_transfer_assistant",
"content": {
"parts": [
{
"text": "I need to confirm this transfer with you. Please approve or reject."
}
],
"role": "model"
},
"finishReason": "STOP",
"id": "e-5",
"invocationId": "i-1",
"nodeInfo": {
"path": "money_transfer_assistant@1"
}
},
{
"author": "user",
"content": {
"parts": [
{
"functionResponse": {
"id": "fc-2",
"name": "adk_request_confirmation",
"response": {
"confirmed": true
}
}
}
],
"role": "user"
},
"id": "e-6",
"invocationId": "i-1",
"nodeInfo": {
"path": ""
}
},
{
"author": "money_transfer_assistant",
"content": {
"parts": [
{
"functionResponse": {
"id": "fc-1",
"name": "transfer_funds",
"response": {
"result": "Successfully transferred $200 to Bob."
}
}
}
],
"role": "user"
},
"id": "e-7",
"invocationId": "i-1",
"nodeInfo": {
"path": "money_transfer_assistant@1"
}
},
{
"author": "money_transfer_assistant",
"content": {
"parts": [
{
"text": "Successfully transferred $200 to Bob."
}
],
"role": "model"
},
"finishReason": "STOP",
"id": "e-8",
"invocationId": "i-1",
"nodeInfo": {
"path": "money_transfer_assistant@1"
}
}
]
}
contributing/samples/hitl/tool_confirmation/tests/transfer_200_declined.json
+189
View File
@@ -0,0 +1,189 @@
{
"events": [
{
"author": "user",
"content": {
"parts": [
{
"text": "Transfer $200 to Bob"
}
],
"role": "user"
},
"id": "e-1",
"invocationId": "i-1",
"nodeInfo": {
"path": ""
}
},
{
"author": "money_transfer_assistant",
"content": {
"parts": [
{
"functionCall": {
"args": {
"amount": 200,
"recipient": "Bob"
},
"id": "fc-1",
"name": "transfer_funds"
}
}
],
"role": "model"
},
"finishReason": "STOP",
"id": "e-2",
"invocationId": "i-1",
"longRunningToolIds": [],
"nodeInfo": {
"path": "money_transfer_assistant@1"
}
},
{
"author": "money_transfer_assistant",
"content": {
"parts": [
{
"functionCall": {
"args": {
"originalFunctionCall": {
"args": {
"amount": 200,
"recipient": "Bob"
},
"id": "fc-1",
"name": "transfer_funds"
},
"toolConfirmation": {
"confirmed": false,
"hint": "Confirm transfer of $200 to Bob."
}
},
"id": "fc-2",
"name": "adk_request_confirmation"
}
}
],
"role": "model"
},
"id": "e-3",
"invocationId": "i-1",
"longRunningToolIds": [
"fc-2"
],
"nodeInfo": {
"path": "money_transfer_assistant@1"
}
},
{
"actions": {
"requestedToolConfirmations": {
"fc-1": {
"confirmed": false,
"hint": "Confirm transfer of $200 to Bob."
}
}
},
"author": "money_transfer_assistant",
"content": {
"parts": [
{
"functionResponse": {
"id": "fc-1",
"name": "transfer_funds",
"response": {
"error": "This tool call requires confirmation, please approve or reject."
}
}
}
],
"role": "user"
},
"id": "e-4",
"invocationId": "i-1",
"nodeInfo": {
"path": "money_transfer_assistant@1"
}
},
{
"author": "money_transfer_assistant",
"content": {
"parts": [
{
"text": "Your transfer of $200 to Bob requires confirmation."
}
],
"role": "model"
},
"finishReason": "STOP",
"id": "e-5",
"invocationId": "i-1",
"nodeInfo": {
"path": "money_transfer_assistant@1"
}
},
{
"author": "user",
"content": {
"parts": [
{
"functionResponse": {
"id": "fc-2",
"name": "adk_request_confirmation",
"response": {
"confirmed": false
}
}
}
],
"role": "user"
},
"id": "e-6",
"invocationId": "i-1",
"nodeInfo": {
"path": ""
}
},
{
"author": "money_transfer_assistant",
"content": {
"parts": [
{
"functionResponse": {
"id": "fc-1",
"name": "transfer_funds",
"response": {
"error": "Transfer rejected by user."
}
}
}
],
"role": "user"
},
"id": "e-7",
"invocationId": "i-1",
"nodeInfo": {
"path": "money_transfer_assistant@1"
}
},
{
"author": "money_transfer_assistant",
"content": {
"parts": [
{
"text": "I'm sorry, your transfer could not be completed. It was rejected by the user."
}
],
"role": "model"
},
"finishReason": "STOP",
"id": "e-8",
"invocationId": "i-1",
"nodeInfo": {
"path": "money_transfer_assistant@1"
}
}
]
}
contributing/samples/hitl/tool_confirmation/tests/transfer_50.json
+84
View File
@@ -0,0 +1,84 @@
{
"events": [
{
"author": "user",
"content": {
"parts": [
{
"text": "Transfer $50 to Alice\n"
}
],
"role": "user"
},
"id": "e-1",
"invocationId": "i-1",
"nodeInfo": {
"path": ""
}
},
{
"author": "money_transfer_assistant",
"content": {
"parts": [
{
"functionCall": {
"args": {
"amount": 50,
"recipient": "Alice"
},
"id": "fc-1",
"name": "transfer_funds"
}
}
],
"role": "model"
},
"finishReason": "STOP",
"id": "e-2",
"invocationId": "i-1",
"longRunningToolIds": [],
"nodeInfo": {
"path": "money_transfer_assistant@1"
}
},
{
"author": "money_transfer_assistant",
"content": {
"parts": [
{
"functionResponse": {
"id": "fc-1",
"name": "transfer_funds",
"response": {
"result": "Successfully transferred $50 to Alice."
}
}
}
],
"role": "user"
},
"id": "e-3",
"invocationId": "i-1",
"nodeInfo": {
"path": "money_transfer_assistant@1"
}
},
{
"author": "money_transfer_assistant",
"content": {
"parts": [
{
"text": "Successfully transferred $50 to Alice."
}
],
"role": "model"
},
"finishReason": "STOP",
"id": "e-4",
"invocationId": "i-1",
"nodeInfo": {
"path": "money_transfer_assistant@1"
}
}
]
}