Commit Graph

1158 Commits

Author SHA1 Message Date
Yeesian Ng 0f173625ea Update instructions for Agent Engine deployment to use the template in GA (#658)
The GA template is available as of https://github.com/googleapis/python-aiplatform/releases/tag/v1.111.0

Co-authored-by: Sita Lakshmi Sangameswaran <sitalakshmi@google.com>
Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2025-09-04 12:51:30 -07:00
Holt Skinner f6c3d30f02 docs: Change "Fine-Tuning LLM Generation" to "Configuring LLM Generation" (#668)
Fine-tuning means changing the model weights, this step is not doing that.
2025-09-04 12:49:33 -07:00
Joe Fernandez e933512073 fix: AE deploy add asp suggestion tip (#667)
* feat: add agent starter pack tip for deployment

* modifying change to comply with docs style guide

---------

Co-authored-by: Elia Secchi <eliasecchi@google.com>
2025-09-04 19:16:23 +01:00
eliasecchig 0fa1069211 feat: add agent starter pack tip for deployment (#664)
Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2025-09-03 15:44:17 -07:00
Tim Rutana e058e99c00 docs: replaced deprecated method and update syntax to use best practice (#403)
Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2025-09-03 10:51:39 -07:00
Nagaaki Hoshi 1283a89e09 docs: remove redundant sentence for improved clarity (#641)
* docs: fix duplicate sentense

* docs: No longer needs `also`

---------

Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2025-09-03 10:45:59 -07:00
Joe Fernandez f2270c4876 fix: typo in Agent Engine deploy docs (#662)
* docs: Add Deployment Payload details to deployment docs

* fix: typo in Agent Engine deploy docs
2025-08-29 10:30:00 -07:00
Fran e45c8ffeba Fix capital_agent.py example (#528)
* Fix capital_agent.py

* moved comment

* fix: moved comment capital_agent.py

---------

Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2025-08-27 16:59:01 -07:00
Joe Fernandez c01d20d25f docs: Add Deployment Payload details to deployment docs (#657) 2025-08-27 16:30:23 -07:00
Joe Fernandez ca0a2fd0ba fix: Updating Safety PR to comply with style guidelines (#656)
* feat: Update Safety and Security page to include plugins as a method for implement agent-agnostic security

* Add hyperlinks to newly added plugin section

---------

Co-authored-by: sammalik-lgtm <sammalik@google.com>
2025-08-27 15:53:35 -07:00
Andrew Ginns 62148fc1c5 refactor: update MCP examples to use StdioConnectionParams (#457)
* refactor: swap to StdioConnectionParams

  - Fix import path to avoid ImportError
  - Changed from StdioServerParameters to StdioConnectionParams as recommended.

* fix: Re-modify imports for MCP config libraries

---------

Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2025-08-27 13:34:59 -07:00
Vicente Ferrara dd215e6ddb docs: updated prereqs documentation for Agent deployment on GKE (#512)
updated iam permissions

removed coming soon

Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2025-08-27 13:26:12 -07:00
anifort 315ee79307 Update human_in_the_loop.py (#642)
the removed line is not needed -events is never used and the 2 lines below is creating events_async

Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2025-08-27 13:15:35 -07:00
Andrew Larimer 5833b459b7 docs: key templating with keys that may not be present (#646)
Included instruction to handle keys that may not be present.

Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2025-08-27 13:14:10 -07:00
Sita Lakshmi Sangameswaran 5aaafc4e3d docs(agentengine): refactor agent engine docs into a walkthrough style guide (#652)
* docs(agentengine): update agent engine doc

* refactor comments and content

---------

Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2025-08-27 13:11:49 -07:00
sammalik-lgtm 0c5fe99c4c feat: Update Safety and Security page to introduce ADK Plugins as a method for implementing agent-agnostic, global security policies (#648)
* feat: Update Safety and Security page to include plugins as a method for implement agent-agnostic security

* Add hyperlinks to newly added plugin section

---------

Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2025-08-27 12:42:11 -07:00
Joe Fernandez c73e113b7b feat: Add docs for tool parallel execution (#651) 2025-08-26 15:44:02 -07:00
Joe Fernandez c9bfba286c Revert "feat(code_executors): Add GkeCodeExecutor for sandboxed execution on …" (#650)
This reverts commit 050c05156c.
2025-08-26 11:35:03 -07:00
Sampath Kumar d6730fb135 Chore: Cleaned up the (failed) Google Analytics code. (#643)
The CICD tests responsible for generating static pages are failing to add the necessary keys to the site. The current settings proved unhelpful, so they have been cleared.
2025-08-26 09:22:40 -07:00
Steren 5364bc16d9 Fix deploy to Cloud Run from gcloud (#639) 2025-08-21 19:45:53 -07:00
Joe Fernandez 183ba55815 fix: Fixed some issues with Agent Config doc (#638) 2025-08-21 15:13:20 -07:00
니콜라스 e4215bf6d5 Update llm-agents.md (#627)
Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2025-08-21 14:31:53 -07:00
Cameron 42c2faaa3a fix: update broken authenticated tool helper (#599)
* fix: update broken authenticated tool helper

* fix: Update invalid auth config argument reference in helpers

* fix: Incorrect code example for `get_auth_config`

`auth_request_function_call`'s args values are dictionaries, meaning it will never be an instance of AuthConfig by default
2025-08-21 14:29:16 -07:00
Joe Fernandez df6f1d1379 Add Whats new banner for Agent Config feature (#637) 2025-08-21 13:35:23 -07:00
Joe Fernandez 7a0a98607e docs: Agent config docs v2 (#636)
* docs: Add Agent Config docs, v2

* fix: update mkdocs file
2025-08-20 17:11:08 -07:00
Joe Fernandez 2cef018c61 fix: add a stub page for the Agent Config API docs (#633) 2025-08-20 16:06:02 -07:00
Joe Fernandez 90703aae06 docs: add CLI deploy command for Agent Engine instructions (#628) 2025-08-19 16:08:39 -07:00
sfkrieger da6d18fa8c chore: Updated code sample to genericize region in datastore ID (#622)
* Updated code sample to genericize region in datastore ID

* Added licensing information.
2025-08-19 13:56:32 -07:00
Andrew David 7f28b0023d docs(loop-agent): remove redundant wording in usage example (#397)
Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2025-08-19 10:01:37 -07:00
Michael Vorburger c7bb5f1405 fix: https://github.com/google/adk-java/issues/152 (#381)
Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2025-08-19 10:00:32 -07:00
google-labs-jules[bot] 9d918512ac fix: docs clarify temp namespace (#612)
This commit clarifies the behavior of the `temp:` namespace in the documentation.

The following changes were made:
- Updated `docs/sessions/state.md` to provide a more detailed explanation of the `temp:` namespace.
- Updated `docs/context/index.md` to improve the clarity of an example related to passing data between tools.
- Updated `docs/runtime/index.md` to add a note about the scope of `temp:` variables.
- Updated `docs/agents/multi-agents.md` and `docs/agents/workflow-agents/sequential-agents.md` to clarify how the `temp:` namespace is propagated to sub-agents.
- Updated `docs/tools/function-tools.md` to explain how to use the `temp:` namespace to pass data between tool calls.

fixes #160

Co-authored-by: google-labs-jules[bot] <161369871+google-labs-jules[bot]@users.noreply.github.com>
Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2025-08-19 16:53:08 +00:00
Summer 050c05156c feat(code_executors): Add GkeCodeExecutor for sandboxed execution on GKE (#621)
* [8/15] add GKE executor doc

* [8/15] add GKE executor doc

* [8/15] add GKE executor doc

* [8/15] add GKE executor doc

---------

Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2025-08-19 09:42:18 -07:00
nikkie ebbf121fcd fix: Remove redundant trailing quote (#623)
Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2025-08-19 09:40:46 -07:00
Jasmeet Bhatia 4b3ea82bdd fix: correct syntax error and typo in Python examples (#625) 2025-08-19 09:39:30 -07:00
Terrence Ryan 551e563ebd fix: add tip about injecting prompts into adk run (#617)
fixes #616

Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2025-08-15 13:04:28 -07:00
Matt Landers da5ce68cbe fix: code executor examples for python (#377)
* fix: code executor examples for python

* fix: updated snippet for code executor

---------

Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2025-08-15 11:28:52 -07:00
Vikranth Kanumuru 75b6d8ad64 Update llm-agents with built in planner example.md (#200)
Co-authored-by: Lavi Nigam <98014943+lavinigam-gcp@users.noreply.github.com>
Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2025-08-15 11:24:30 -07:00
google-labs-jules[bot] 05376de47f docs: Add documentation for the REST API. (#613)
This commit adds a new page to the documentation for the REST API, with
details about the `/run` and `/run_sse` endpoints.

A new file is created at `docs/api-reference/rest/index.md` and linked
from the main API reference page and the navigation bar.

Joe: Modified navigation ordering, and added information to point to REST API guide in Testing topic.

fixes #126

Co-authored-by: google-labs-jules[bot] <161369871+google-labs-jules[bot]@users.noreply.github.com>
Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2025-08-15 11:00:55 -07:00
Joe Fernandez 35438f324b fix(docs): Add "application-default" option to gcloud auth (#615)
Fixes https://github.com/google/adk-python/issues/943
2025-08-15 17:42:42 +01:00
Mandy Chan 6afd0d37ba fix: Update agent.py (#611)
Fixes #176 

Use AgentTool for subagents
2025-08-14 18:49:53 -07:00
Guillaume Laforge cb1dfad5e0 fix: Update index.md to show 0.2.0 for Java (#572)
Co-authored-by: Terrence Ryan <tpryan@google.com>
2025-08-14 16:44:09 -07:00
Aaron Wanjala 58998675c1 Update mcp-tools.md (#283)
Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2025-08-14 11:43:20 -07:00
Michael Vorburger 7f51ec6f7e fix: Use final static BaseAgent ROOT_AGENT field. (#350)
Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2025-08-14 11:38:12 -07:00
sfkrieger 8e4f503680 fix(mcp-deployment): Add comprehensive MCP deployment documentation (#594)
* Add comprehensive MCP deployment documentation

- Add detailed deployment section for ADK agents with MCP tools
- Document critical synchronous agent definition requirement for deployment
- Cover three deployment patterns: self-contained stdio, remote SSE/HTTP, and sidecar containers
- Include production deployment checklist with security, monitoring, and scalability considerations
- Provide environment-specific configurations for Cloud Run, GKE, and Vertex AI Agent Engine
- Add troubleshooting guide for common MCP deployment issues
- Include quick deployment commands for Agent Engine and Cloud Run

Addresses deployment challenges outlined in issue #327 where async MCP toolset creation
is no longer supported in deployment environments.

Fixes #327

* Replace SSE/HTTP with Streamable HTTP implementation in MCP Pattern 2

- Update Pattern 2 deployment example to use StreamableHTTPSessionManager
- Replace basic SSE server code with comprehensive Streamable HTTP implementation
- Add production-ready features: stateless mode, ASGI compliance, lifecycle management
- Include Starlette application setup with proper error handling
2025-08-14 18:13:42 +00:00
Terrence Ryan 695a9804b5 docs: Clarify tool status field in example (#608)
The `lookup_order_status` example in the tool documentation was using the `status` field to represent both the tool's execution outcome and the business-level order status. This is ambiguous and can be confusing for the LLM.

This change refactors the example to use a dedicated `status` field for the execution outcome (`success`/`error`) and nests the order-specific data in a separate `order` dictionary. This aligns with best practices for tool design and improves clarity.

Fixes #530

Co-authored-by: google-labs-jules[bot] <161369871+google-labs-jules[bot]@users.noreply.github.com>
Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2025-08-14 11:03:23 -07:00
Terrence Ryan 43a58a2a05 fix: Prevent overwriting of function response (#607)
In the human-in-the-loop example, the long_running_function_response
variable could be overwritten with `None` by a subsequent event that
did not contain a function response. This would cause the logic that
depends on the response to fail.

Fixes #375

Co-authored-by: google-labs-jules[bot] <161369871+google-labs-jules[bot]@users.noreply.github.com>
Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2025-08-14 11:01:19 -07:00
Terrence Ryan 8baf946953 fix: adding windows version of command (#609)
Fixes #154

Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2025-08-14 10:59:34 -07:00
Terrence Ryan 77d0e39adf fix: Made references requiring file creation cross platform (#606)
* fix (docs): Made references requiring file creation cross platform

Fixes #44

* fix: correct conventional commit

---------

Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2025-08-14 10:57:10 -07:00
Yuan Teoh f9182f4411 chore: update diagram for MCP Toolbox (#604)
Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2025-08-13 17:08:10 -07:00
Terrence Ryan 59a22da119 fix(docs): adding extra information and context to bidi streaming. (#603)
Fixes #538

Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2025-08-13 17:02:16 -07:00