mirror of
https://github.com/google/adk-docs.git
synced 2026-09-14 16:16:59 +08:00
Kamal Aboul-Hosn
b38ec7602b
* docs: Add documentation for the new Pub/Sub tool * Update pubsub.md --------- Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
95 lines
3.1 KiB
Python
95 lines
3.1 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.
|
|
|
|
import asyncio
|
|
import os
|
|
|
|
from google.adk.agents import Agent
|
|
from google.adk.runners import Runner
|
|
from google.adk.sessions import InMemorySessionService
|
|
from google.adk.tools.pubsub.config import PubSubToolConfig
|
|
from google.adk.tools.pubsub.pubsub_credentials import PubSubCredentialsConfig
|
|
from google.adk.tools.pubsub.pubsub_toolset import PubSubToolset
|
|
from google.genai import types
|
|
import google.auth
|
|
|
|
# Define constants for this example agent
|
|
AGENT_NAME = "pubsub_agent"
|
|
APP_NAME = "pubsub_app"
|
|
USER_ID = "user1234"
|
|
SESSION_ID = "1234"
|
|
GEMINI_MODEL = "gemini-2.0-flash"
|
|
|
|
# Define Pub/Sub tool config.
|
|
# You can optionally set the project_id here, or let the agent infer it from context/user input.
|
|
tool_config = PubSubToolConfig(project_id=os.getenv("GOOGLE_CLOUD_PROJECT"))
|
|
|
|
# Uses externally-managed Application Default Credentials (ADC) by default.
|
|
# This decouples authentication from the agent / tool lifecycle.
|
|
# https://cloud.google.com/docs/authentication/provide-credentials-adc
|
|
application_default_credentials, _ = google.auth.default()
|
|
credentials_config = PubSubCredentialsConfig(
|
|
credentials=application_default_credentials
|
|
)
|
|
|
|
# Instantiate a Pub/Sub toolset
|
|
pubsub_toolset = PubSubToolset(
|
|
credentials_config=credentials_config, pubsub_tool_config=tool_config
|
|
)
|
|
|
|
# Agent Definition
|
|
pubsub_agent = Agent(
|
|
model=GEMINI_MODEL,
|
|
name=AGENT_NAME,
|
|
description=(
|
|
"Agent to publish, pull, and acknowledge messages from Google Cloud"
|
|
" Pub/Sub."
|
|
),
|
|
instruction="""\
|
|
You are a cloud engineer agent with access to Google Cloud Pub/Sub tools.
|
|
You can publish messages to topics, pull messages from subscriptions, and acknowledge messages.
|
|
""",
|
|
tools=[pubsub_toolset],
|
|
)
|
|
|
|
# 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=pubsub_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)
|
|
|
|
|
|
call_agent("publish 'Hello World' to 'my-topic'")
|
|
call_agent("pull messages from 'my-subscription'")
|