mirror of
https://github.com/encounter/adk-python.git
synced 2026-07-09 18:19:28 -07:00
Josh SorefandCopybara-Service
aa1233608a
Merge https://github.com/google/adk-python/pull/2447 This PR corrects misspellings identified by the [check-spelling action](https://github.com/marketplace/actions/check-spelling) The misspellings have been reported at https://github.com/jsoref/adk-python/actions/runs/16840838898/attempts/1#summary-47711379253 The action reports that the changes in this PR would make it happy: https://github.com/jsoref/adk-python/actions/runs/16840839269/attempts/1#summary-47711380479 Note: while I use tooling to identify errors, the tooling doesn't _actually_ provide the corrections, I'm picking them on my own. I'm a human, and I may make mistakes. I've included a couple of changes to make CI happy. Personally, I object to CI being in a state of "random drive by person who adds a blank line in the middle of a file must fix all the preexisting bugs in the file", but that appears to be the state for this repository. COPYBARA_INTEGRATE_REVIEW=https://github.com/google/adk-python/pull/2447 from jsoref:spelling d85398e7fd154d124d477c6af6181481a01f34e0 PiperOrigin-RevId: 827629615
304 lines
10 KiB
Python
304 lines
10 KiB
Python
# Copyright 2025 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.
|
|
|
|
"""Tests for UrlContextTool."""
|
|
|
|
from google.adk.agents.invocation_context import InvocationContext
|
|
from google.adk.agents.sequential_agent import SequentialAgent
|
|
from google.adk.models.llm_request import LlmRequest
|
|
from google.adk.sessions.in_memory_session_service import InMemorySessionService
|
|
from google.adk.tools.tool_context import ToolContext
|
|
from google.adk.tools.url_context_tool import url_context
|
|
from google.adk.tools.url_context_tool import UrlContextTool
|
|
from google.genai import types
|
|
import pytest
|
|
|
|
|
|
async def _create_tool_context() -> ToolContext:
|
|
session_service = InMemorySessionService()
|
|
session = await session_service.create_session(
|
|
app_name='test_app', user_id='test_user'
|
|
)
|
|
agent = SequentialAgent(name='test_agent')
|
|
invocation_context = InvocationContext(
|
|
invocation_id='invocation_id',
|
|
agent=agent,
|
|
session=session,
|
|
session_service=session_service,
|
|
)
|
|
return ToolContext(invocation_context=invocation_context)
|
|
|
|
|
|
class TestUrlContextTool:
|
|
"""Test the UrlContextTool class."""
|
|
|
|
def test_init(self):
|
|
"""Test initialization of UrlContextTool."""
|
|
tool = UrlContextTool()
|
|
assert tool.name == 'url_context'
|
|
assert tool.description == 'url_context'
|
|
|
|
def test_url_context_singleton(self):
|
|
"""Test that url_context is a singleton instance."""
|
|
assert isinstance(url_context, UrlContextTool)
|
|
assert url_context.name == 'url_context'
|
|
|
|
@pytest.mark.asyncio
|
|
async def test_process_llm_request_with_gemini_2_model(self):
|
|
"""Test processing LLM request with Gemini 2.x model."""
|
|
tool = UrlContextTool()
|
|
tool_context = await _create_tool_context()
|
|
|
|
llm_request = LlmRequest(
|
|
model='gemini-2.0-flash', config=types.GenerateContentConfig()
|
|
)
|
|
|
|
await tool.process_llm_request(
|
|
tool_context=tool_context, llm_request=llm_request
|
|
)
|
|
|
|
assert llm_request.config.tools is not None
|
|
assert len(llm_request.config.tools) == 1
|
|
assert llm_request.config.tools[0].url_context is not None
|
|
|
|
@pytest.mark.asyncio
|
|
async def test_process_llm_request_with_path_based_gemini_2_model(self):
|
|
"""Test processing LLM request with path-based Gemini 2.x model."""
|
|
tool = UrlContextTool()
|
|
tool_context = await _create_tool_context()
|
|
|
|
llm_request = LlmRequest(
|
|
model='projects/265104255505/locations/us-central1/publishers/google/models/gemini-2.0-flash-001',
|
|
config=types.GenerateContentConfig(),
|
|
)
|
|
|
|
await tool.process_llm_request(
|
|
tool_context=tool_context, llm_request=llm_request
|
|
)
|
|
|
|
assert llm_request.config.tools is not None
|
|
assert len(llm_request.config.tools) == 1
|
|
assert llm_request.config.tools[0].url_context is not None
|
|
|
|
@pytest.mark.asyncio
|
|
async def test_process_llm_request_with_gemini_2_5_model(self):
|
|
"""Test processing LLM request with Gemini 2.5 model."""
|
|
tool = UrlContextTool()
|
|
tool_context = await _create_tool_context()
|
|
|
|
llm_request = LlmRequest(
|
|
model='gemini-2.5-pro', config=types.GenerateContentConfig()
|
|
)
|
|
|
|
await tool.process_llm_request(
|
|
tool_context=tool_context, llm_request=llm_request
|
|
)
|
|
|
|
assert llm_request.config.tools is not None
|
|
assert len(llm_request.config.tools) == 1
|
|
assert llm_request.config.tools[0].url_context is not None
|
|
|
|
@pytest.mark.asyncio
|
|
async def test_process_llm_request_with_existing_tools(self):
|
|
"""Test processing LLM request with existing tools."""
|
|
tool = UrlContextTool()
|
|
tool_context = await _create_tool_context()
|
|
|
|
existing_tool = types.Tool(
|
|
function_declarations=[
|
|
types.FunctionDeclaration(name='test_function', description='test')
|
|
]
|
|
)
|
|
|
|
llm_request = LlmRequest(
|
|
model='gemini-2.0-flash',
|
|
config=types.GenerateContentConfig(tools=[existing_tool]),
|
|
)
|
|
|
|
await tool.process_llm_request(
|
|
tool_context=tool_context, llm_request=llm_request
|
|
)
|
|
|
|
assert llm_request.config.tools is not None
|
|
assert len(llm_request.config.tools) == 2
|
|
assert llm_request.config.tools[0] == existing_tool
|
|
assert llm_request.config.tools[1].url_context is not None
|
|
|
|
@pytest.mark.asyncio
|
|
async def test_process_llm_request_with_gemini_1_model_raises_error(self):
|
|
"""Test that Gemini 1.x model raises ValueError."""
|
|
tool = UrlContextTool()
|
|
tool_context = await _create_tool_context()
|
|
|
|
llm_request = LlmRequest(
|
|
model='gemini-1.5-flash', config=types.GenerateContentConfig()
|
|
)
|
|
|
|
with pytest.raises(
|
|
ValueError, match='Url context tool cannot be used in Gemini 1.x'
|
|
):
|
|
await tool.process_llm_request(
|
|
tool_context=tool_context, llm_request=llm_request
|
|
)
|
|
|
|
@pytest.mark.asyncio
|
|
async def test_process_llm_request_with_path_based_gemini_1_model_raises_error(
|
|
self,
|
|
):
|
|
"""Test that path-based Gemini 1.x model raises ValueError."""
|
|
tool = UrlContextTool()
|
|
tool_context = await _create_tool_context()
|
|
|
|
llm_request = LlmRequest(
|
|
model='projects/265104255505/locations/us-central1/publishers/google/models/gemini-1.5-flash-001',
|
|
config=types.GenerateContentConfig(),
|
|
)
|
|
|
|
with pytest.raises(
|
|
ValueError, match='Url context tool cannot be used in Gemini 1.x'
|
|
):
|
|
await tool.process_llm_request(
|
|
tool_context=tool_context, llm_request=llm_request
|
|
)
|
|
|
|
@pytest.mark.asyncio
|
|
async def test_process_llm_request_with_non_gemini_model_raises_error(self):
|
|
"""Test that non-Gemini model raises ValueError."""
|
|
tool = UrlContextTool()
|
|
tool_context = await _create_tool_context()
|
|
|
|
llm_request = LlmRequest(
|
|
model='claude-3-sonnet', config=types.GenerateContentConfig()
|
|
)
|
|
|
|
with pytest.raises(
|
|
ValueError,
|
|
match='Url context tool is not supported for model claude-3-sonnet',
|
|
):
|
|
await tool.process_llm_request(
|
|
tool_context=tool_context, llm_request=llm_request
|
|
)
|
|
|
|
@pytest.mark.asyncio
|
|
async def test_process_llm_request_with_path_based_non_gemini_model_raises_error(
|
|
self,
|
|
):
|
|
"""Test that path-based non-Gemini model raises ValueError."""
|
|
tool = UrlContextTool()
|
|
tool_context = await _create_tool_context()
|
|
|
|
non_gemini_path = 'projects/265104255505/locations/us-central1/publishers/google/models/claude-3-sonnet'
|
|
llm_request = LlmRequest(
|
|
model=non_gemini_path, config=types.GenerateContentConfig()
|
|
)
|
|
|
|
with pytest.raises(
|
|
ValueError,
|
|
match=f'Url context tool is not supported for model {non_gemini_path}',
|
|
):
|
|
await tool.process_llm_request(
|
|
tool_context=tool_context, llm_request=llm_request
|
|
)
|
|
|
|
@pytest.mark.asyncio
|
|
async def test_process_llm_request_with_none_model_raises_error(self):
|
|
"""Test that None model raises ValueError."""
|
|
tool = UrlContextTool()
|
|
tool_context = await _create_tool_context()
|
|
|
|
llm_request = LlmRequest(model=None, config=types.GenerateContentConfig())
|
|
|
|
with pytest.raises(
|
|
ValueError, match='Url context tool is not supported for model None'
|
|
):
|
|
await tool.process_llm_request(
|
|
tool_context=tool_context, llm_request=llm_request
|
|
)
|
|
|
|
@pytest.mark.asyncio
|
|
async def test_process_llm_request_with_empty_model_raises_error(self):
|
|
"""Test that empty model raises ValueError."""
|
|
tool = UrlContextTool()
|
|
tool_context = await _create_tool_context()
|
|
|
|
llm_request = LlmRequest(model='', config=types.GenerateContentConfig())
|
|
|
|
with pytest.raises(
|
|
ValueError, match='Url context tool is not supported for model '
|
|
):
|
|
await tool.process_llm_request(
|
|
tool_context=tool_context, llm_request=llm_request
|
|
)
|
|
|
|
@pytest.mark.asyncio
|
|
async def test_process_llm_request_with_no_config(self):
|
|
"""Test processing LLM request with None config."""
|
|
tool = UrlContextTool()
|
|
tool_context = await _create_tool_context()
|
|
|
|
llm_request = LlmRequest(model='gemini-2.0-flash')
|
|
|
|
await tool.process_llm_request(
|
|
tool_context=tool_context, llm_request=llm_request
|
|
)
|
|
|
|
assert llm_request.config is not None
|
|
assert llm_request.config.tools is not None
|
|
assert len(llm_request.config.tools) == 1
|
|
assert llm_request.config.tools[0].url_context is not None
|
|
|
|
@pytest.mark.asyncio
|
|
async def test_process_llm_request_with_none_tools(self):
|
|
"""Test processing LLM request with None tools."""
|
|
tool = UrlContextTool()
|
|
tool_context = await _create_tool_context()
|
|
|
|
llm_request = LlmRequest(
|
|
model='gemini-2.0-flash', config=types.GenerateContentConfig(tools=None)
|
|
)
|
|
|
|
await tool.process_llm_request(
|
|
tool_context=tool_context, llm_request=llm_request
|
|
)
|
|
|
|
assert llm_request.config.tools is not None
|
|
assert len(llm_request.config.tools) == 1
|
|
assert llm_request.config.tools[0].url_context is not None
|
|
|
|
@pytest.mark.asyncio
|
|
async def test_process_llm_request_edge_cases(self):
|
|
"""Test edge cases for model name validation."""
|
|
tool = UrlContextTool()
|
|
tool_context = await _create_tool_context()
|
|
|
|
# Test with model names that contain gemini but don't start with it
|
|
edge_cases = [
|
|
'my-gemini-2.0-model',
|
|
'custom-gemini-2.5-flash',
|
|
'projects/265104255505/locations/us-central1/publishers/gemini/models/claude-3-sonnet',
|
|
]
|
|
|
|
for model in edge_cases:
|
|
llm_request = LlmRequest(
|
|
model=model, config=types.GenerateContentConfig()
|
|
)
|
|
|
|
with pytest.raises(
|
|
ValueError,
|
|
match=f'Url context tool is not supported for model {model}',
|
|
):
|
|
await tool.process_llm_request(
|
|
tool_context=tool_context, llm_request=llm_request
|
|
)
|