# 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 asyncio from google.adk.agents import Agent from google.adk.runners import Runner from google.adk.sessions import InMemorySessionService from google.adk.tools.google_tool import GoogleTool from google.adk.tools.bigtable import query_tool from google.adk.tools.bigtable.settings import BigtableToolSettings from google.adk.tools.bigtable.bigtable_credentials import BigtableCredentialsConfig from google.adk.tools.bigtable.bigtable_toolset import BigtableToolset from google.genai import types from google.adk.tools.tool_context import ToolContext import google.auth from google.auth.credentials import Credentials # Define constants for this example agent AGENT_NAME = "bigtable_agent" APP_NAME = "bigtable_app" USER_ID = "user1234" SESSION_ID = "1234" GEMINI_MODEL = "gemini-2.5-flash" # Define Bigtable tool config with read capability set to allowed. tool_settings = BigtableToolSettings() # Define a credentials config - in this example we are using application default # credentials # https://cloud.google.com/docs/authentication/provide-credentials-adc application_default_credentials, _ = google.auth.default() credentials_config = BigtableCredentialsConfig( credentials=application_default_credentials ) # Instantiate a Bigtable toolset bigtable_toolset = BigtableToolset( credentials_config=credentials_config, bigtable_tool_settings=tool_settings ) # Optional # Create a wrapped function tool for the agent on top of the built-in # `execute_sql` tool in the bigtable toolset. # For example, this customized tool can perform a dynamically-built query. def count_rows_tool( table_name: str, credentials: Credentials, # GoogleTool handles `credentials` settings: BigtableToolSettings, # GoogleTool handles `settings` tool_context: ToolContext, # GoogleTool handles `tool_context` ): """Counts the total number of rows for a specified table. Args: table_name: The name of the table for which to count rows. Returns: The total number of rows in the table. """ # Replace the following settings for a specific bigtable database. PROJECT_ID = "" INSTANCE_ID = "" query = f""" SELECT count(*) FROM {table_name} """ return query_tool.execute_sql( project_id=PROJECT_ID, instance_id=INSTANCE_ID, query=query, credentials=credentials, settings=settings, tool_context=tool_context, ) # Agent Definition bigtable_agent = Agent( model=GEMINI_MODEL, name=AGENT_NAME, description=( "Agent to answer questions about bigtable database and execute SQL queries." ), instruction="""\ You are a data assistant agent with access to several bigtable tools. Make use of those tools to answer the user's questions. """, tools=[ bigtable_toolset, # Add customized bigtable tool based on the built-in bigtable toolset. GoogleTool( func=count_rows_tool, credentials_config=credentials_config, tool_settings=tool_settings, ), ], ) # Session and Runner session_service = InMemorySessionService() session = asyncio.run( session_service.create_session( app_name=APP_NAME, user_id=USER_ID, session_id=SESSION_ID ) ) runner = Runner( agent=bigtable_agent, app_name=APP_NAME, session_service=session_service ) # Agent Interaction def call_agent(query): """ Helper function to call the agent with a query. """ content = types.Content(role="user", parts=[types.Part(text=query)]) events = runner.run(user_id=USER_ID, session_id=SESSION_ID, new_message=content) print("USER:", query) for event in events: if event.is_final_response(): final_response = event.content.parts[0].text print("AGENT:", final_response) # Replace the bigtable instance and table names below with your own. call_agent("List all tables in projects//instances/") call_agent("List the top 5 rows in ")