google-adk 0.0.2__py3-none-any.whl → 0.0.4__py3-none-any.whl

google/adk/tests/integration/test_callback.py

@@ -1,70 +0,0 @@
-# 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.
-
-from pytest import mark
-
-from ..unittests.utils import simplify_events
-from .fixture import callback_agent
-from .utils import assert_agent_says
-from .utils import TestRunner
-
-
-@mark.parametrize(
-    "agent_runner",
-    [{"agent": callback_agent.agent.before_agent_callback_agent}],
-    indirect=True,
-)
-def test_before_agent_call(agent_runner: TestRunner):
-  agent_runner.run("Hi.")
-
-  # Assert the response content
-  assert_agent_says(
-      "End invocation event before agent call.",
-      agent_name="before_agent_callback_agent",
-      agent_runner=agent_runner,
-  )
-
-
-@mark.parametrize(
-    "agent_runner",
-    [{"agent": callback_agent.agent.before_model_callback_agent}],
-    indirect=True,
-)
-def test_before_model_call(agent_runner: TestRunner):
-  agent_runner.run("Hi.")
-
-  # Assert the response content
-  assert_agent_says(
-      "End invocation event before model call.",
-      agent_name="before_model_callback_agent",
-      agent_runner=agent_runner,
-  )
-
-
-# TODO: re-enable vertex by removing below line after fixing.
-@mark.parametrize("llm_backend", ["GOOGLE_AI"], indirect=True)
-@mark.parametrize(
-    "agent_runner",
-    [{"agent": callback_agent.agent.after_model_callback_agent}],
-    indirect=True,
-)
-def test_after_model_call(agent_runner: TestRunner):
-  events = agent_runner.run("Hi.")
-
-  # Assert the response content
-  simplified_events = simplify_events(events)
-  assert simplified_events[0][0] == "after_model_callback_agent"
-  assert simplified_events[0][1].endswith(
-      "Update response event after model call."
-  )

google/adk/tests/integration/test_context_variable.py

@@ -1,67 +0,0 @@
-# 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.
-
-import json
-
-import pytest
-
-# Skip until fixed.
-pytest.skip(allow_module_level=True)
-
-from .fixture import context_variable_agent
-from .utils import TestRunner
-
-
-@pytest.mark.parametrize(
-    "agent_runner",
-    [{"agent": context_variable_agent.agent.state_variable_echo_agent}],
-    indirect=True,
-)
-def test_context_variable_missing(agent_runner: TestRunner):
-  with pytest.raises(KeyError) as e_info:
-    agent_runner.run("Hi echo my customer id.")
-  assert "customerId" in str(e_info.value)
-
-
-@pytest.mark.parametrize(
-    "agent_runner",
-    [{"agent": context_variable_agent.agent.state_variable_update_agent}],
-    indirect=True,
-)
-def test_context_variable_update(agent_runner: TestRunner):
-  _call_function_and_assert(
-      agent_runner,
-      "update_fc",
-      ["RRRR", "3.141529", ["apple", "banana"], [1, 3.14, "hello"]],
-      "successfully",
-  )
-
-
-def _call_function_and_assert(
-    agent_runner: TestRunner, function_name: str, params, expected
-):
-  param_section = (
-      " with params"
-      f" {params if isinstance(params, str) else json.dumps(params)}"
-      if params is not None
-      else ""
-  )
-  agent_runner.run(
-      f"Call {function_name}{param_section} and show me the result"
-  )
-
-  model_response_event = agent_runner.get_events()[-1]
-  assert model_response_event.author == "context_variable_update_agent"
-  assert model_response_event.content.role == "model"
-  assert expected in model_response_event.content.parts[0].text.strip()

google/adk/tests/integration/test_evalute_agent_in_fixture.py

@@ -1,76 +0,0 @@
-# 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.
-
-"""Evaluate all agents in fixture folder if evaluation test files exist."""
-
-import os
-
-from google.adk.evaluation import AgentEvaluator
-import pytest
-
-def agent_eval_artifacts_in_fixture():
-  """Get all agents from fixture folder."""
-  agent_eval_artifacts = []
-  fixture_dir = os.path.join(os.path.dirname(__file__), 'fixture')
-  for agent_name in os.listdir(fixture_dir):
-    agent_dir = os.path.join(fixture_dir, agent_name)
-    if not os.path.isdir(agent_dir):
-      continue
-    for filename in os.listdir(agent_dir):
-      # Evaluation test files end with test.json
-      if not filename.endswith('test.json'):
-        continue
-      initial_session_file = (
-          f'tests/integration/fixture/{agent_name}/initial.session.json'
-      )
-      agent_eval_artifacts.append((
-          f'tests.integration.fixture.{agent_name}',
-          f'tests/integration/fixture/{agent_name}/{filename}',
-          initial_session_file
-          if os.path.exists(initial_session_file)
-          else None,
-      ))
-
-  # This method gets invoked twice, sorting helps ensure that both the
-  # invocations have the same view.
-  agent_eval_artifacts = sorted(
-      agent_eval_artifacts, key=lambda item: f'{item[0]}|{item[1]}'
-  )
-  return agent_eval_artifacts
-
-
-@pytest.mark.parametrize(
-    'agent_name, evalfile, initial_session_file',
-    agent_eval_artifacts_in_fixture(),
-    ids=[agent_name for agent_name, _, _ in agent_eval_artifacts_in_fixture()],
-)
-def test_evaluate_agents_long_running_4_runs_per_eval_item(
-    agent_name, evalfile, initial_session_file
-):
-  """Test agents evaluation in fixture folder.
-
-  After querying the fixture folder, we have 5 eval items. For each eval item
-  we use 4 runs.
-
-  A single eval item is a session that can have multiple queries in it.
-  """
-  AgentEvaluator.evaluate(
-      agent_module=agent_name,
-      eval_dataset_file_path_or_dir=evalfile,
-      initial_session_file=initial_session_file,
-      # Using a slightly higher value helps us manange the variances that may
-      # happen in each eval.
-      # This, of course, comes at a cost of incrased test run times.
-      num_runs=4,
-  )

google/adk/tests/integration/test_multi_agent.py

@@ -1,28 +0,0 @@
-# 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.
-
-from google.adk.evaluation import AgentEvaluator
-
-
-def test_eval_agent():
-  AgentEvaluator.evaluate(
-      agent_module="tests.integration.fixture.trip_planner_agent",
-      eval_dataset_file_path_or_dir=(
-          "tests/integration/fixture/trip_planner_agent/trip_inquiry.test.json"
-      ),
-      initial_session_file=(
-          "tests/integration/fixture/trip_planner_agent/initial.session.json"
-      ),
-      num_runs=4,
-  )

google/adk/tests/integration/test_multi_turn.py

@@ -1,42 +0,0 @@
-# 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.
-
-from google.adk.evaluation import AgentEvaluator
-
-
-def test_simple_multi_turn_conversation():
-  """Test a simple multi-turn conversation."""
-  AgentEvaluator.evaluate(
-      agent_module="tests.integration.fixture.home_automation_agent",
-      eval_dataset_file_path_or_dir="tests/integration/fixture/home_automation_agent/test_files/simple_multi_turn_conversation.test.json",
-      num_runs=4,
-  )
-
-
-def test_dependent_tool_calls():
-  """Test subsequent tool calls that are dependent on previous tool calls."""
-  AgentEvaluator.evaluate(
-      agent_module="tests.integration.fixture.home_automation_agent",
-      eval_dataset_file_path_or_dir="tests/integration/fixture/home_automation_agent/test_files/dependent_tool_calls.test.json",
-      num_runs=4,
-  )
-
-
-def test_memorizing_past_events():
-  """Test memorizing past events."""
-  AgentEvaluator.evaluate(
-      agent_module="tests.integration.fixture.home_automation_agent",
-      eval_dataset_file_path_or_dir="tests/integration/fixture/home_automation_agent/test_files/memorizing_past_events/eval_data.test.json",
-      num_runs=4,
-  )

google/adk/tests/integration/test_single_agent.py

@@ -1,23 +0,0 @@
-# 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.
-
-from google.adk.evaluation import AgentEvaluator
-
-
-def test_eval_agent():
-  AgentEvaluator.evaluate(
-      agent_module="tests.integration.fixture.home_automation_agent",
-      eval_dataset_file_path_or_dir="tests/integration/fixture/home_automation_agent/simple_test.test.json",
-      num_runs=4,
-  )

google/adk/tests/integration/test_sub_agent.py

@@ -1,26 +0,0 @@
-# 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.
-
-from google.adk.evaluation import AgentEvaluator
-
-
-def test_eval_agent():
-  """Test hotel sub agent in a multi-agent system."""
-  AgentEvaluator.evaluate(
-      agent_module="tests.integration.fixture.trip_planner_agent",
-      eval_dataset_file_path_or_dir="tests/integration/fixture/trip_planner_agent/test_files/trip_inquiry_sub_agent.test.json",
-      initial_session_file="tests/integration/fixture/trip_planner_agent/test_files/initial.session.json",
-      agent_name="identify_agent",
-      num_runs=4,
-  )

google/adk/tests/integration/test_system_instruction.py

@@ -1,177 +0,0 @@
-# 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.
-
-import pytest
-
-# Skip until fixed.
-pytest.skip(allow_module_level=True)
-
-from google.adk.agents import InvocationContext
-from google.adk.sessions import Session
-from google.genai import types
-
-from .fixture import context_variable_agent
-from .utils import TestRunner
-
-nl_planner_si = """
-You are an intelligent tool use agent built upon the Gemini large language model. When answering the question, try to leverage the available tools to gather the information instead of your memorized knowledge.
-
-Follow this process when answering the question: (1) first come up with a plan in natural language text format; (2) Then use tools to execute the plan and provide reasoning between tool code snippets to make a summary of current state and next step. Tool code snippets and reasoning should be interleaved with each other. (3) In the end, return one final answer.
-
-Follow this format when answering the question: (1) The planning part should be under /*PLANNING*/. (2) The tool code snippets should be under /*ACTION*/, and the reasoning parts should be under /*REASONING*/. (3) The final answer part should be under /*FINAL_ANSWER*/.
-
-
-Below are the requirements for the planning:
-The plan is made to answer the user query if following the plan. The plan is coherent and covers all aspects of information from user query, and only involves the tools that are accessible by the agent. The plan contains the decomposed steps as a numbered list where each step should use one or multiple available tools. By reading the plan, you can intuitively know which tools to trigger or what actions to take.
-If the initial plan cannot be successfully executed, you should learn from previous execution results and revise your plan. The revised plan should be be under /*REPLANNING*/. Then use tools to follow the new plan.
-
-Below are the requirements for the reasoning:
-The reasoning makes a summary of the current trajectory based on the user query and tool outputs. Based on the tool outputs and plan, the reasoning also comes up with instructions to the next steps, making the trajectory closer to the final answer.
-
-
-
-Below are the requirements for the final answer:
-The final answer should be precise and follow query formatting requirements. Some queries may not be answerable with the available tools and information. In those cases, inform the user why you cannot process their query and ask for more information.
-
-
-
-Below are the requirements for the tool code:
-
-**Custom Tools:** The available tools are described in the context and can be directly used.
-- Code must be valid self-contained Python snippets with no imports and no references to tools or Python libraries that are not in the context.
-- You cannot use any parameters or fields that are not explicitly defined in the APIs in the context.
-- Use "print" to output execution results for the next step or final answer that you need for responding to the user. Never generate ```tool_outputs yourself.
-- The code snippets should be readable, efficient, and directly relevant to the user query and reasoning steps.
-- When using the tools, you should use the library name together with the function name, e.g., vertex_search.search().
-- If Python libraries are not provided in the context, NEVER write your own code other than the function calls using the provided tools.
-
-
-
-VERY IMPORTANT instruction that you MUST follow in addition to the above instructions:
-
-You should ask for clarification if you need more information to answer the question.
-You should prefer using the information available in the context instead of repeated tool use.
-
-You should ONLY generate code snippets prefixed with "```tool_code" if you need to use the tools to answer the question.
-
-If you are asked to write code by user specifically,
-- you should ALWAYS use "```python" to format the code.
-- you should NEVER put "tool_code" to format the code.
-- Good example:
-```python
-print('hello')
-```
-- Bad example:
-```tool_code
-print('hello')
-```
-"""
-
-
-@pytest.mark.parametrize(
-    "agent_runner",
-    [{"agent": context_variable_agent.agent.state_variable_echo_agent}],
-    indirect=True,
-)
-def test_context_variable(agent_runner: TestRunner):
-  session = Session(
-      context={
-          "customerId": "1234567890",
-          "customerInt": 30,
-          "customerFloat": 12.34,
-          "customerJson": {"name": "John Doe", "age": 30, "count": 11.1},
-      }
-  )
-  si = UnitFlow()._build_system_instruction(
-      InvocationContext(
-          invocation_id="1234567890", agent=agent_runner.agent, session=session
-      )
-  )
-
-  assert (
-      "Use the echo_info tool to echo 1234567890, 30, 12.34, and {'name': 'John"
-      " Doe', 'age': 30, 'count': 11.1}. Ask for it if you need to."
-      in si
-  )
-
-
-@pytest.mark.parametrize(
-    "agent_runner",
-    [{
-        "agent": (
-            context_variable_agent.agent.state_variable_with_complicated_format_agent
-        )
-    }],
-    indirect=True,
-)
-def test_context_variable_with_complicated_format(agent_runner: TestRunner):
-  session = Session(
-      context={"customerId": "1234567890", "customer_int": 30},
-      artifacts={"fileName": [types.Part(text="test artifact")]},
-  )
-  si = _context_formatter.populate_context_and_artifact_variable_values(
-      agent_runner.agent.instruction,
-      session.get_state(),
-      session.get_artifact_dict(),
-  )
-
-  assert (
-      si
-      == "Use the echo_info tool to echo 1234567890, 30, { "
-      " non-identifier-float}}, test artifact, {'key1': 'value1'} and"
-      " {{'key2': 'value2'}}. Ask for it if you need to."
-  )
-
-
-@pytest.mark.parametrize(
-    "agent_runner",
-    [{
-        "agent": (
-            context_variable_agent.agent.state_variable_with_nl_planner_agent
-        )
-    }],
-    indirect=True,
-)
-def test_nl_planner(agent_runner: TestRunner):
-  session = Session(context={"customerId": "1234567890"})
-  si = UnitFlow()._build_system_instruction(
-      InvocationContext(
-          invocation_id="1234567890",
-          agent=agent_runner.agent,
-          session=session,
-      )
-  )
-
-  for line in nl_planner_si.splitlines():
-    assert line in si
-
-
-@pytest.mark.parametrize(
-    "agent_runner",
-    [{
-        "agent": (
-            context_variable_agent.agent.state_variable_with_function_instruction_agent
-        )
-    }],
-    indirect=True,
-)
-def test_function_instruction(agent_runner: TestRunner):
-  session = Session(context={"customerId": "1234567890"})
-  si = UnitFlow()._build_system_instruction(
-      InvocationContext(
-          invocation_id="1234567890", agent=agent_runner.agent, session=session
-      )
-  )
-
-  assert "This is the plain text sub agent instruction." in si