test: add integration tests for ADK's A2A client-server interaction

PiperOrigin-RevId: 888114589
This commit is contained in:
Google Team Member
2026-03-23 08:43:15 -07:00
committed by Copybara-Service
parent 4b677e73b9
commit 4cbc3dcb45
4 changed files with 764 additions and 0 deletions
@@ -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.
"""A2A integration tests package."""
+88
View File
@@ -0,0 +1,88 @@
# 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.
"""A2A Client for integration tests."""
from a2a.client.client import ClientConfig as A2AClientConfig
from a2a.client.client_factory import ClientFactory as A2AClientFactory
from a2a.extensions.common import HTTP_EXTENSION_HEADER
from a2a.types import TransportProtocol as A2ATransport
from google.adk.a2a.agent.interceptors.new_integration_extension import _NEW_A2A_ADK_INTEGRATION_EXTENSION
from google.adk.agents.remote_a2a_agent import RemoteA2aAgent
import httpx
from .server import agent_card
def create_client(app, streaming: bool = False) -> RemoteA2aAgent:
"""Creates a RemoteA2aAgent connected to the provided FastAPI app.
Args:
app: The FastAPI application (server) to connect to.
streaming: Whether to enable streaming mode in the client.
Returns:
A RemoteA2aAgent instance.
"""
client = httpx.AsyncClient(
transport=httpx.ASGITransport(app=app), base_url="http://test"
)
client_config = A2AClientConfig(
httpx_client=client,
streaming=streaming,
polling=False,
supported_transports=[A2ATransport.jsonrpc],
)
factory = A2AClientFactory(config=client_config)
# use_legacy=False forces the new implementation
agent = RemoteA2aAgent(
name="remote_agent",
agent_card=agent_card,
a2a_client_factory=factory,
use_legacy=False,
)
return agent
def create_a2a_client(app, streaming: bool = False):
"""Creates a bare A2A Client connected to the provided FastAPI app.
This is in contrast to create_client, which wraps the a2a_client into a
RemoteA2aAgent for the standard runner framework ecosystem execution.
Args:
app: The FastAPI application (server) to connect to.
streaming: Whether to enable streaming mode in the client.
Returns:
An A2A Client instance.
"""
client = httpx.AsyncClient(
transport=httpx.ASGITransport(app=app),
base_url="http://test",
headers={HTTP_EXTENSION_HEADER: _NEW_A2A_ADK_INTEGRATION_EXTENSION},
)
client_config = A2AClientConfig(
httpx_client=client,
streaming=streaming,
polling=False,
supported_transports=[A2ATransport.jsonrpc],
)
factory = A2AClientFactory(config=client_config)
return factory.create(agent_card)
+84
View File
@@ -0,0 +1,84 @@
# 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.
"""A2A Server for integration tests."""
from unittest.mock import Mock
from a2a.server.apps.jsonrpc.fastapi_app import A2AFastAPIApplication
from a2a.server.request_handlers.default_request_handler import DefaultRequestHandler
from a2a.server.tasks.inmemory_task_store import InMemoryTaskStore
from a2a.types import AgentCapabilities
from a2a.types import AgentCard
from a2a.types import AgentSkill
from google.adk.a2a.executor.a2a_agent_executor import A2aAgentExecutor
from google.adk.agents.base_agent import BaseAgent
from google.adk.runners import Runner
from google.adk.sessions.in_memory_session_service import InMemorySessionService
class FakeRunner(Runner):
"""A Fake Runner that delegates run_async to a provided function."""
def __init__(self, run_async_fn):
agent = Mock(spec=BaseAgent)
agent.name = "FakeAgent"
session_service = InMemorySessionService()
super().__init__(
app_name="FakeApp",
agent=agent,
session_service=session_service,
)
self.run_async_fn = run_async_fn
async def run_async(self, **kwargs):
async for event in self.run_async_fn(**kwargs):
yield event
agent_card = AgentCard(
name="remote_agent",
url="http://test",
description="A fun fact generator agent",
capabilities=AgentCapabilities(
streaming=True,
extensions=[{"uri": "https://a2a-adk/a2a-extension/new-integration"}],
),
version="0.0.1",
default_input_modes=["text/plain"],
default_output_modes=["text/plain"],
skills=[],
)
def create_server_app(run_async_fn):
"""Creates an A2A FastAPI application with a mocked runner.
Args:
run_async_fn: A generator function that takes **kwargs and yields Event
objects.
Returns:
A FastAPI application instance.
"""
runner = FakeRunner(run_async_fn)
executor = A2aAgentExecutor(runner=runner)
task_store = InMemoryTaskStore()
handler = DefaultRequestHandler(
agent_executor=executor, task_store=task_store
)
app = A2AFastAPIApplication(agent_card=agent_card, http_handler=handler)
return app.build()
@@ -0,0 +1,577 @@
# 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.
"""Integration tests for A2A client-server interaction."""
from a2a.types import Message as A2AMessage
from a2a.types import Part as A2APart
from a2a.types import Task
from a2a.types import TaskState
from a2a.types import TextPart
from google.adk.agents.remote_a2a_agent import A2A_METADATA_PREFIX
from google.adk.events.event import Event
from google.adk.platform import uuid as platform_uuid
from google.adk.runners import Runner
from google.adk.sessions.in_memory_session_service import InMemorySessionService
from google.genai import types
import pytest
from .client import create_a2a_client
from .client import create_client
from .server import create_server_app
def create_streaming_mock_run_async(received_requests: list):
"""Creates a mock_run_async that streams multiple chunks."""
async def mock_run_async(**kwargs):
received_requests.append(kwargs)
yield Event(
author="FakeAgent",
content=types.Content(parts=[types.Part(text="Hello")]),
partial=True,
)
yield Event(
author="FakeAgent",
content=types.Content(parts=[types.Part(text=" world")]),
partial=True,
)
yield Event(
author="FakeAgent",
content=types.Content(parts=[types.Part(text="Hello world")]),
partial=False,
)
return mock_run_async
def create_non_streaming_mock_run_async(received_requests: list):
"""Creates a mock_run_async that returns a single non-streaming event."""
async def mock_run_async(**kwargs):
received_requests.append(kwargs)
yield Event(
author="FakeAgent",
content=types.Content(parts=[types.Part(text="Hello world")]),
partial=False,
)
return mock_run_async
@pytest.mark.asyncio
async def test_streaming_adk_to_streaming_a2a():
"""Test streaming of normal text chunks."""
received_requests = []
mock_run_async = create_streaming_mock_run_async(received_requests)
app = create_server_app(mock_run_async)
agent = create_client(app, streaming=True)
session_service = InMemorySessionService()
await session_service.create_session(
app_name="ClientApp", user_id="test_user", session_id="test_session"
)
client_runner = Runner(
app_name="ClientApp",
agent=agent,
session_service=session_service,
)
new_message = types.Content(parts=[types.Part(text="Hi")], role="user")
texts = []
async for event in client_runner.run_async(
user_id="test_user", session_id="test_session", new_message=new_message
):
if event.content and event.content.parts:
for p in event.content.parts:
if p.text:
texts.append(p.text)
assert len(received_requests) == 1
assert received_requests[0]["session_id"] is not None
assert texts == ["Hello", " world", "Hello world"]
@pytest.mark.asyncio
async def test_streaming_adk_to_non_streaming_a2a():
"""Test ADK streaming into A2A Non-Streaming."""
received_requests = []
mock_run_async = create_streaming_mock_run_async(received_requests)
app = create_server_app(mock_run_async)
agent = create_client(app, streaming=False)
session_service = InMemorySessionService()
await session_service.create_session(
app_name="ClientApp", user_id="test_user", session_id="test_session"
)
client_runner = Runner(
app_name="ClientApp", agent=agent, session_service=session_service
)
new_message = types.Content(parts=[types.Part(text="Hi")], role="user")
texts = []
async for event in client_runner.run_async(
user_id="test_user", session_id="test_session", new_message=new_message
):
if event.content and event.content.parts:
for p in event.content.parts:
if p.text:
texts.append(p.text)
assert len(received_requests) == 1
assert texts == ["Hello world"]
@pytest.mark.asyncio
async def test_non_streaming_adk_to_streaming_a2a():
"""Test ADK Non-Streaming into A2A Streaming."""
received_requests = []
mock_run_async = create_non_streaming_mock_run_async(received_requests)
app = create_server_app(mock_run_async)
agent = create_client(app, streaming=True)
session_service = InMemorySessionService()
await session_service.create_session(
app_name="ClientApp", user_id="test_user", session_id="test_session"
)
client_runner = Runner(
app_name="ClientApp", agent=agent, session_service=session_service
)
new_message = types.Content(parts=[types.Part(text="Hi")], role="user")
texts = []
async for event in client_runner.run_async(
user_id="test_user", session_id="test_session", new_message=new_message
):
if event.content and event.content.parts:
for p in event.content.parts:
if p.text:
texts.append(p.text)
assert len(received_requests) == 1
assert texts == ["Hello world"]
@pytest.mark.asyncio
async def test_non_streaming_adk_to_non_streaming_a2a():
"""Test ADK Non-Streaming into A2A Non-Streaming."""
received_requests = []
mock_run_async = create_non_streaming_mock_run_async(received_requests)
app = create_server_app(mock_run_async)
agent = create_client(app, streaming=False)
session_service = InMemorySessionService()
await session_service.create_session(
app_name="ClientApp", user_id="test_user", session_id="test_session"
)
client_runner = Runner(
app_name="ClientApp", agent=agent, session_service=session_service
)
new_message = types.Content(parts=[types.Part(text="Hi")], role="user")
texts = []
async for event in client_runner.run_async(
user_id="test_user", session_id="test_session", new_message=new_message
):
if event.content and event.content.parts:
for p in event.content.parts:
if p.text:
texts.append(p.text)
assert len(received_requests) == 1
assert texts == ["Hello world"]
def create_streaming_mock_run_async_with_multiple_agents(
received_requests: list,
):
"""Creates a mock_run_async that streams multiple chunks."""
async def mock_run_async(**kwargs):
received_requests.append(kwargs)
yield Event(
author="FakeAgent1",
content=types.Content(parts=[types.Part(text="Hello")]),
partial=True,
)
yield Event(
author="FakeAgent2",
content=types.Content(parts=[types.Part(text=" Hi")]),
partial=True,
)
yield Event(
author="FakeAgent1",
content=types.Content(parts=[types.Part(text=" world")]),
partial=True,
)
yield Event(
author="FakeAgent2",
content=types.Content(parts=[types.Part(text=" human")]),
partial=True,
)
yield Event(
author="FakeAgent1",
content=types.Content(parts=[types.Part(text="Hello world")]),
partial=False,
)
yield Event(
author="FakeAgent2",
content=types.Content(parts=[types.Part(text="Hi human")]),
partial=False,
)
return mock_run_async
@pytest.mark.asyncio
async def test_multiple_agents_streaming_adk_to_streaming_a2a():
"""Test streaming multiple agents chunks into A2A Streaming."""
received_requests = []
mock_run_async = create_streaming_mock_run_async_with_multiple_agents(
received_requests
)
app = create_server_app(mock_run_async)
agent = create_client(app, streaming=True)
session_service = InMemorySessionService()
await session_service.create_session(
app_name="ClientApp", user_id="test_user", session_id="test_session"
)
client_runner = Runner(
app_name="ClientApp", agent=agent, session_service=session_service
)
new_message = types.Content(parts=[types.Part(text="Hi")], role="user")
texts = []
async for event in client_runner.run_async(
user_id="test_user", session_id="test_session", new_message=new_message
):
if event.content and event.content.parts:
for p in event.content.parts:
if p.text:
texts.append(p.text)
assert len(received_requests) == 1
assert texts == [
"Hello",
" Hi",
" world",
" human",
"Hello world",
"Hi human",
]
@pytest.mark.asyncio
async def test_function_calls():
"""Test function call execution from agent."""
received_requests = []
async def mock_run_async(**kwargs):
received_requests.append(kwargs)
yield Event(
author="FakeAgent",
content=types.Content(
parts=[
types.Part(
function_call=types.FunctionCall(
name="get_weather",
args={"location": "San Francisco"},
id="call_1",
)
),
types.Part(
function_response=types.FunctionResponse(
name="get_weather",
response={"temperature": "22C"},
id="call_1",
)
),
],
role="model",
),
)
app = create_server_app(mock_run_async)
agent = create_client(app)
session_service = InMemorySessionService()
await session_service.create_session(
app_name="ClientApp", user_id="test_user", session_id="test_session"
)
client_runner = Runner(
app_name="ClientApp",
agent=agent,
session_service=session_service,
)
new_message = types.Content(parts=[types.Part(text="Hi")], role="user")
func_calls = []
func_responses = []
async for event in client_runner.run_async(
user_id="test_user", session_id="test_session", new_message=new_message
):
func_calls.extend(event.get_function_calls())
if event.content and event.content.parts:
for p in event.content.parts:
if p.function_response:
func_responses.append(p.function_response)
assert len(func_calls) == 1
assert func_calls[0].name == "get_weather"
assert func_calls[0].args == {"location": "San Francisco"}
assert len(func_responses) == 1
assert func_responses[0].name == "get_weather"
assert func_responses[0].response == {"temperature": "22C"}
def create_long_running_mock_run_async(received_requests: list):
"""Creates a mock_run_async for long running function tests."""
async def mock_run_async(**kwargs):
received_requests.append(kwargs)
if len(received_requests) == 1:
yield Event(
author="FakeAgent",
content=types.Content(
parts=[
types.Part(
function_call=types.FunctionCall(
name="long_task", args={}, id="call_long"
)
)
],
role="model",
),
long_running_tool_ids={"call_long"},
)
yield Event(
author="FakeAgent",
content=types.Content(
parts=[
types.Part(
function_response=types.FunctionResponse(
name="long_task",
response={"status": "pending"},
id="call_long",
)
)
],
role="model",
),
)
else:
yield Event(
author="FakeAgent",
content=types.Content(
parts=[types.Part(text="Task completed well")], role="model"
),
)
return mock_run_async
@pytest.mark.asyncio
async def test_long_running_function_calls_success():
"""Test long running function calls flow success with user response."""
received_requests = []
mock_run_async = create_long_running_mock_run_async(received_requests)
app = create_server_app(mock_run_async)
agent = create_client(app, streaming=True)
session_service = InMemorySessionService()
await session_service.create_session(
app_name="ClientApp", user_id="test_user", session_id="test_session"
)
client_runner = Runner(
app_name="ClientApp",
agent=agent,
session_service=session_service,
)
new_message_1 = types.Content(parts=[types.Part(text="Hi")], role="user")
func_calls_1 = []
func_responses_1 = []
task_id_1 = ""
has_long_running_id = False
async for event in client_runner.run_async(
user_id="test_user", session_id="test_session", new_message=new_message_1
):
if event.custom_metadata:
task_id_1 = event.custom_metadata.get(
A2A_METADATA_PREFIX + "task_id", task_id_1
)
if (
event.long_running_tool_ids
and "call_long" in event.long_running_tool_ids
):
has_long_running_id = True
func_calls_1.extend(event.get_function_calls())
if event.content and event.content.parts:
for p in event.content.parts:
if p.function_response:
func_responses_1.append(p.function_response)
assert has_long_running_id
assert len(func_calls_1) == 1
assert func_calls_1[0].name == "long_task"
assert len(func_responses_1) == 1
assert func_responses_1[0].name == "long_task"
assert func_responses_1[0].response == {"status": "pending"}
new_message_2 = types.Content(
parts=[
types.Part(
function_response=types.FunctionResponse(
name="long_task", response={"result": "done"}, id="call_long"
)
)
],
role="user",
)
texts = []
task_id_2 = ""
async for event in client_runner.run_async(
user_id="test_user", session_id="test_session", new_message=new_message_2
):
if event.custom_metadata:
task_id_2 = event.custom_metadata.get(
A2A_METADATA_PREFIX + "task_id", task_id_2
)
if event.content and event.content.parts:
for p in event.content.parts:
if p.text:
texts.append(p.text)
assert task_id_1 == task_id_2
assert "Task completed well" in texts
@pytest.mark.asyncio
async def test_long_running_function_calls_error():
"""Test long running function calls returns error on missing response."""
received_requests = []
mock_run_async = create_long_running_mock_run_async(received_requests)
app = create_server_app(mock_run_async)
a2a_client = create_a2a_client(app, streaming=False)
request_1 = A2AMessage(
message_id=platform_uuid.new_uuid(),
parts=[A2APart(root=TextPart(text="Hi"))],
role="user",
)
response_1_events = []
async for event in a2a_client.send_message(request=request_1):
response_1_events.append(event)
assert len(response_1_events) == 1
# Extract task_id from Turn 1 responses
assert response_1_events[0][1] is None
task = response_1_events[0][0]
assert isinstance(task, Task)
assert task.status.state == TaskState.input_required
extracted_task_id = task.id
assert extracted_task_id is not None
request_2 = A2AMessage(
message_id=platform_uuid.new_uuid(),
parts=[A2APart(root=TextPart(text="Any update?"))],
role="user",
task_id=extracted_task_id,
context_id=task.context_id if hasattr(task, "context_id") else None,
)
response_2_events = []
async for event in a2a_client.send_message(request=request_2):
response_2_events.append(event)
# Verify that we get an error response for the second request due to missing function response
assert len(response_2_events) == 1
assert response_2_events[0][1] is None
error_response = response_2_events[0][0]
assert isinstance(error_response, Task)
assert error_response.status.message.parts[0].root.text == (
"It was not provided a function response for the function call."
)
@pytest.mark.asyncio
async def test_user_follow_up():
"""Test multi-turn interaction or follow up with state."""
received_requests = []
async def mock_run_async(**kwargs):
received_requests.append(kwargs)
# Yield response with custom metadata to test passing back
yield Event(
author="FakeAgent",
content=types.Content(
parts=[types.Part(text="Follow up response")], role="model"
),
custom_metadata={"server_state": "active"},
)
app = create_server_app(mock_run_async)
agent = create_client(app)
session_service = InMemorySessionService()
await session_service.create_session(
app_name="ClientApp", user_id="test_user", session_id="test_session"
)
client_runner = Runner(
app_name="ClientApp",
agent=agent,
session_service=session_service,
)
# First Turn
new_message_1 = types.Content(parts=[types.Part(text="Turn 1")], role="user")
async for _ in client_runner.run_async(
user_id="test_user", session_id="test_session", new_message=new_message_1
):
pass
# Second Turn
new_message_2 = types.Content(parts=[types.Part(text="Turn 2")], role="user")
last_event = None
async for event in client_runner.run_async(
user_id="test_user", session_id="test_session", new_message=new_message_2
):
last_event = event
assert len(received_requests) == 2
# The second request should carry the same session ID as the first
assert (
received_requests[1]["session_id"] == received_requests[0]["session_id"]
)
assert last_event is not None