From 41a868623209be23eb726f519410ebea2702aba3 Mon Sep 17 00:00:00 2001 From: Didier Durand Date: Sat, 17 Jan 2026 08:10:12 +0100 Subject: [PATCH 1/3] doc: fixing various typos --- AGENTS.md | 2 +- .../samples/application_integration_agent/README.md | 2 +- contributing/samples/bigquery_mcp/README.md | 2 +- .../samples/context_offloading_with_artifact/README.md | 2 +- contributing/samples/mcp_stdio_notion_agent/README.md | 2 +- contributing/samples/multi_agent_seq_config/README.md | 2 +- contributing/samples/oauth_calendar_agent/README.md | 2 +- contributing/samples/spanner_rag_agent/README.md | 2 +- src/google/adk/cli/built_in_agents/tools/write_files.py | 2 +- src/google/adk/flows/llm_flows/base_llm_flow.py | 6 +++--- src/google/adk/tools/pubsub/__init__.py | 2 +- src/google/adk/tools/spanner/settings.py | 4 ++-- 12 files changed, 15 insertions(+), 15 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 95ea8ff263..3e8b3543e8 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -24,7 +24,7 @@ agentic architectures that range from simple tasks to complex workflows. interacts with various services like session management, artifact storage, and memory, and integrates with application-wide plugins. The runner provides different execution modes: `run_async` for asynchronous execution - in production, `run_live` for bi-directional streaming interaction, and + in production, `run_live` for bidirectional streaming interaction, and `run` for synchronous execution suitable for local testing and debugging. At the end of each invocation, it can perform event compaction to manage session history size. diff --git a/contributing/samples/application_integration_agent/README.md b/contributing/samples/application_integration_agent/README.md index 0e0a70c17c..961a65eb53 100644 --- a/contributing/samples/application_integration_agent/README.md +++ b/contributing/samples/application_integration_agent/README.md @@ -7,7 +7,7 @@ This sample demonstrates how to use the `ApplicationIntegrationToolset` within a ## Prerequisites 1. **Set up Integration Connection:** - * You need an existing [Integration connection](https://cloud.google.com/integration-connectors/docs/overview) configured to interact with your Jira instance. Follow the [documentation](https://google.github.io/adk-docs/tools/google-cloud-tools/#use-integration-connectors) to provision the Integration Connector in Google Cloud and then use this [documentation](https://cloud.google.com/integration-connectors/docs/connectors/jiracloud/configure) to create an Jira connection. Note the `Connection Name`, `Project ID`, and `Location` of your connection. + * You need an existing [Integration connection](https://cloud.google.com/integration-connectors/docs/overview) configured to interact with your Jira instance. Follow the [documentation](https://google.github.io/adk-docs/tools/google-cloud-tools/#use-integration-connectors) to provision the Integration Connector in Google Cloud and then use this [documentation](https://cloud.google.com/integration-connectors/docs/connectors/jiracloud/configure) to create a Jira connection. Note the `Connection Name`, `Project ID`, and `Location` of your connection. * 2. **Configure Environment Variables:** diff --git a/contributing/samples/bigquery_mcp/README.md b/contributing/samples/bigquery_mcp/README.md index bce19976ca..31fdb59895 100644 --- a/contributing/samples/bigquery_mcp/README.md +++ b/contributing/samples/bigquery_mcp/README.md @@ -4,7 +4,7 @@ This sample agent demonstrates using ADK's `McpToolset` to interact with BigQuery's official MCP endpoint, allowing an agent to access and execute -toole by leveraging the Model Context Protocol (MCP). These tools include: +tools by leveraging the Model Context Protocol (MCP). These tools include: 1. `list_dataset_ids` diff --git a/contributing/samples/context_offloading_with_artifact/README.md b/contributing/samples/context_offloading_with_artifact/README.md index 93f391107e..7ed94ec007 100644 --- a/contributing/samples/context_offloading_with_artifact/README.md +++ b/contributing/samples/context_offloading_with_artifact/README.md @@ -32,7 +32,7 @@ response. This keeps the turn events small, saving context space. the *next* request to the LLM. This makes the report data available immediately, allowing the agent to summarize it or answer questions in the same turn, as seen in the logs. This artifact is only appended for that - round and not saved to session. For furtuer rounds of conversation, it will + round and not saved to session. For further rounds of conversation, it will be removed from context. 3. **Loading on Demand**: The `CustomLoadArtifactsTool` enhances the default `load_artifacts` behavior. diff --git a/contributing/samples/mcp_stdio_notion_agent/README.md b/contributing/samples/mcp_stdio_notion_agent/README.md index d40df313f2..9d8a8922f2 100644 --- a/contributing/samples/mcp_stdio_notion_agent/README.md +++ b/contributing/samples/mcp_stdio_notion_agent/README.md @@ -1,6 +1,6 @@ # Notion MCP Agent -This is an agent that is using Notion MCP tool to call Notion API. And it demonstrate how to pass in the Notion API key. +This is an agent that is using Notion MCP tool to call Notion API. And it demonstrates how to pass in the Notion API key. Follow below instruction to use it: diff --git a/contributing/samples/multi_agent_seq_config/README.md b/contributing/samples/multi_agent_seq_config/README.md index a2cd462465..af0dcee2fc 100644 --- a/contributing/samples/multi_agent_seq_config/README.md +++ b/contributing/samples/multi_agent_seq_config/README.md @@ -6,7 +6,7 @@ The whole process is: 1. An agent backed by a cheap and fast model to write initial version. 2. An agent backed by a smarter and a little more expensive to review the code. -3. An final agent backed by the smartest and slowest model to write the final revision. +3. A final agent backed by the smartest and slowest model to write the final revision. Sample queries: diff --git a/contributing/samples/oauth_calendar_agent/README.md b/contributing/samples/oauth_calendar_agent/README.md index 381bb7902b..8fc2ba1028 100644 --- a/contributing/samples/oauth_calendar_agent/README.md +++ b/contributing/samples/oauth_calendar_agent/README.md @@ -7,7 +7,7 @@ This sample tests and demos the OAuth support in ADK via two tools: * 1. list_calendar_events This is a customized tool that calls Google Calendar API to list calendar - events. It pass in the client id and client secrete to ADK and then get back + events. It passes in the client id and client secrete to ADK and then get back the access token from ADK. And then it uses the access token to call calendar api. diff --git a/contributing/samples/spanner_rag_agent/README.md b/contributing/samples/spanner_rag_agent/README.md index 99b60794fe..08d134b990 100644 --- a/contributing/samples/spanner_rag_agent/README.md +++ b/contributing/samples/spanner_rag_agent/README.md @@ -181,7 +181,7 @@ type. ## 💬 Sample prompts -* I'd like to buy a starter bike for my 3 year old child, can you show me the recommendation? +* I'd like to buy a starter bike for my 3-year-old child, can you show me the recommendation? ![Spanner RAG Sample Agent](Spanner_RAG_Sample_Agent.png) diff --git a/src/google/adk/cli/built_in_agents/tools/write_files.py b/src/google/adk/cli/built_in_agents/tools/write_files.py index 8ade17c536..3b2fa74ba2 100644 --- a/src/google/adk/cli/built_in_agents/tools/write_files.py +++ b/src/google/adk/cli/built_in_agents/tools/write_files.py @@ -51,7 +51,7 @@ async def write_files( - file_size: size of written file in bytes - existed_before: bool indicating if file existed before write - backup_created: bool indicating if backup was created - - backup_path: path to backup file if created + - backup_path: path to back up file if created - error: error message if write failed for this file - successful_writes: number of files written successfully - total_files: total number of files requested diff --git a/src/google/adk/flows/llm_flows/base_llm_flow.py b/src/google/adk/flows/llm_flows/base_llm_flow.py index 91b57cb873..6d9bdc5788 100644 --- a/src/google/adk/flows/llm_flows/base_llm_flow.py +++ b/src/google/adk/flows/llm_flows/base_llm_flow.py @@ -73,7 +73,7 @@ class BaseLlmFlow(ABC): """A basic flow that calls the LLM in a loop until a final response is generated. - This flow ends when it transfer to another agent. + This flow ends when it transfers to another agent. """ def __init__(self): @@ -393,8 +393,8 @@ async def _run_one_step_async( current_invocation=True, current_branch=True ) - # Long running tool calls should have been handled before this point. - # If there are still long running tool calls, it means the agent is paused + # Long-running tool calls should have been handled before this point. + # If there are still long-running tool calls, it means the agent is paused # before, and its branch hasn't been resumed yet. if ( invocation_context.is_resumable diff --git a/src/google/adk/tools/pubsub/__init__.py b/src/google/adk/tools/pubsub/__init__.py index 9625155f06..eaac694621 100644 --- a/src/google/adk/tools/pubsub/__init__.py +++ b/src/google/adk/tools/pubsub/__init__.py @@ -14,7 +14,7 @@ """Pub/Sub Tools (Experimental). -Pub/Sub Tools under this module are hand crafted and customized while the tools +Pub/Sub Tools under this module are handcrafted and customized while the tools under google.adk.tools.google_api_tool are auto generated based on API definition. The rationales to have customized tool are: diff --git a/src/google/adk/tools/spanner/settings.py b/src/google/adk/tools/spanner/settings.py index 6ca693b235..9d8dea7904 100644 --- a/src/google/adk/tools/spanner/settings.py +++ b/src/google/adk/tools/spanner/settings.py @@ -115,7 +115,7 @@ class VectorSearchIndexSettings(BaseModel): """ num_branches: Optional[int] = None - """Optional. The number of branches to further parititon the vector data. + """Optional. The number of branches to further partition the vector data. You can only designate num_branches for trees with 3 levels. The number of branches must be fewer than the number of leaves @@ -165,7 +165,7 @@ class SpannerVectorStoreSettings(BaseModel): """Required. The vector store table columns to return in the vector similarity search result. By default, only the `content_column` value and the distance value are returned. - If sepecified, the list of selected columns and the distance value are returned. + If specified, the list of selected columns and the distance value are returned. For example, if `selected_columns` is ['col1', 'col2'], then the result will contain the values of 'col1' and 'col2' columns and the distance value. """ From 6131e8e4819d17922477bdb0341e25edfe78ee33 Mon Sep 17 00:00:00 2001 From: Didier Durand <2927957+didier-durand@users.noreply.github.com> Date: Sat, 17 Jan 2026 08:33:27 +0100 Subject: [PATCH 2/3] Update contributing/samples/oauth_calendar_agent/README.md Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com> --- contributing/samples/oauth_calendar_agent/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/contributing/samples/oauth_calendar_agent/README.md b/contributing/samples/oauth_calendar_agent/README.md index 8fc2ba1028..1a580ec8ff 100644 --- a/contributing/samples/oauth_calendar_agent/README.md +++ b/contributing/samples/oauth_calendar_agent/README.md @@ -7,7 +7,7 @@ This sample tests and demos the OAuth support in ADK via two tools: * 1. list_calendar_events This is a customized tool that calls Google Calendar API to list calendar - events. It passes in the client id and client secrete to ADK and then get back + events. It passes in the client id and client secret to ADK and then get back the access token from ADK. And then it uses the access token to call calendar api. From a617ce69eade143dcdcb396ffd2083f6ac793d40 Mon Sep 17 00:00:00 2001 From: Didier Durand <2927957+didier-durand@users.noreply.github.com> Date: Sat, 17 Jan 2026 08:33:51 +0100 Subject: [PATCH 3/3] Update src/google/adk/cli/built_in_agents/tools/write_files.py Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com> --- src/google/adk/cli/built_in_agents/tools/write_files.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/google/adk/cli/built_in_agents/tools/write_files.py b/src/google/adk/cli/built_in_agents/tools/write_files.py index 3b2fa74ba2..8ade17c536 100644 --- a/src/google/adk/cli/built_in_agents/tools/write_files.py +++ b/src/google/adk/cli/built_in_agents/tools/write_files.py @@ -51,7 +51,7 @@ async def write_files( - file_size: size of written file in bytes - existed_before: bool indicating if file existed before write - backup_created: bool indicating if backup was created - - backup_path: path to back up file if created + - backup_path: path to backup file if created - error: error message if write failed for this file - successful_writes: number of files written successfully - total_files: total number of files requested