20 Commits

Author SHA1 Message Date
George Weale 839e898fcf docs(tutorials): fix ToolContext, output_key and persistence claims (#2032)
* docs(tutorials): fix ToolContext, output_key and persistence claims

* Update agent-team.md

* docs: address review — revert get-started changes, move streaming note

Reverts docs/get-started/python.md entirely and drops the edit to the
retired quickstart-streaming.md page. The corrected streaming caveat now
lands on docs/live/get-started/streaming-python.md, scoped to the
run_async path and naming SequentialAgent as the only workflow agent
with live support.

---------

Co-authored-by: Joe Fernandez <931947+joefernandez@users.noreply.github.com>
2026-08-07 13:15:39 -07:00
Serena 534d39895e Fix ValueError for Python agent_team ADK tutorial (#1957)
* fix directory names

* Update links and dir name in README and notebook

---------

Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-07-13 11:45:57 -05:00
jayjayakumar a57b9ea2c9 Docs: update output_key behavior description (#1878)
* Docs: update output_key behavior description

* Docs: update additional output_key references per review

* Minor formatting edit

---------

Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-07-06 18:29:34 -05:00
Haran Rajkumar d802044831 docs: update GenAI auth env var and Client parameter (#1832)
* docs: update GOOGLE_GENAI_USE_VERTEXAI to GOOGLE_GENAI_USE_ENTERPRISE in configs and models

* docs: update GOOGLE_GENAI_USE_VERTEXAI in deployment and setup guides

* docs: update GOOGLE_GENAI_USE_VERTEXAI and Client parameter in integrations and streaming docs

* docs: update GOOGLE_GENAI_USE_VERTEXAI in tutorials and examples

---------

Co-authored-by: Joe Fernandez <931947+joefernandez@users.noreply.github.com>
2026-06-30 08:51:51 -07:00
Kristopher Overholt 50f7df7f46 Add Kotlin language support to ADK docs (#1768)
* Add Kotlin to hero / front page

* Add quickstart page for Kotlin

* Complete Kotlin quickstart guide and fix hero code sample (#2)

* Replace GitHub repo links with language icons in header (#3)

* Fix header icon FOUC and homepage font weight regression (#4)

* Testing staging pipeline

* Revert test edit (for staging pipeline)

* Update language icon tooltips to indicate GitHub destination (#5)

* Add link to ADK Kotlin release notes (#7)

* Initial commit of ADK Kotlin API reference docs (#6)

* Add script to generate ADK Kotlin API reference docs (#8)

* Update links and link checker ignore list (temporarily) (#9)

* Add ADK Kotlin for Android getting started guide to Advanced setup page (#10)

* Add advanced setup page with steps to "Use ADK Kotlin in Android projects"

* Update temp link checker rules

* Add placeholder folder for adk-samples (#13)

* adding linter/compilation checks for kotlin snippets (#12)

* adding linter/compilation checks for kotlin snippets

* Add Kotlin validation scripts

* Initial commit of Kotlin sample agents for adk-samples (#15)

* Adding kotlin snippet for llm agents (#16)

* Adding kotlin snippets to  Events (#17)

* Pull changes to docs/events/index.md from glaforge-kotlin-snippets

* fixing kotlin event timestamp and longRunningToolIds

* Fix language tags (#19)

* Fix language tags

* Update

* Fix wrapping

* Fix wrapping (again)

* Fix wrapping/format

* Fix language tag on integration page

* Enable check_paths in PyMdown Snippets Extension to make the build fail if a snippet can't be found (#20)

* Update mkdocs config (#21)

* Fix broken links, update URLs to adk.dev, and improve (temp) lychee config (#22)

* Add Kotlin/maven badge to README (#23)

* Adding Kotlin snippets for artifacts  (#18)

* Pull Kotlin snippets for artifacts from glaforge-kotlin-snippets

* Add comprehensive Kotlin snippets for artifacts

* Refactor artifacts documentation to use external Kotlin snippets

* Update Kotlin model to gemini-flash-latest

* Fix GCS initialization in Kotlin artifact snippet

* afixi failing test with capital-agent added to files_to_check

* Fix snippet label syntax for MkDocs build

* Configure proper Gradle project for Kotlin snippets and fix dependencies

* Add KSP support and generated sources to Kotlin snippets build

* fixing capital_agent turnComplete

* Fix syntax error in build.gradle.kts by removing invalid placeholders (#25)

* Adding Kotlin snippets to google-gemini.md (#27)

Pulling kotlin changes to google-gemini.md from glaforge-kotlin-snippets

* Add a warning about not adding an api key to production code. (#28)

* Add a warning about not adding an api key to production code.

* Update note

---------

Co-authored-by: Kristopher Overholt <koverholt@google.com>

* Add ADK Demo App sample showcasing Gemini-powered agents (#29)

This sample demonstrates how to use the Google ADK (Agent Development Kit) in an Android application to create a chat interface powered by a Gemini-based "Fun Facts" agent. The implementation features:
*   Integration with the Kotlin ADK core and processor libraries.
*   A `FunFactsAgent` defined using `LlmAgent` and the Gemini model.
*   A `ChatViewModel` utilizing `InMemoryRunner` for asynchronous message streaming.
*   A modern UI built with Jetpack Compose and Material 3.
*   Build configuration logic for secure API key management via environment variables or `local.properties`.

* Update Kotlin docs and samples to align with adk-kotlin API changes (#30)

Rename GeminiModel to Gemini, @AdkTool/@AdkParam to @Tool/@Param,
adkTools() to generatedTools(), replace DebugRunner with InMemoryRunner,
fix AgentLoader import path, use SingleAgentLoader, bump Kotlin to
2.3.21 and KSP to 2.3.7, and update Android minSdk from 24 to 26.

* adding kotlin info to READMEs (#14)

* Reorganize Android sample agent and add READMEs (#31)

* Move Android sample agent

* Update repo README, add Android README, update sample agent README

* Minor edit to language support tags (#32)

* Remove blog post link (#33)

Will re-add after it's published

* Remove examples link (#34)

* Adding Kotlin snippets for Sessions docs (#26)

* initial kotlins snippets additions to sessions docs

* Updating memory docs with kotlin snippets

* Adding kotlin snippets to session state docs.

* update model to gemini-flash-latest

* sessions examples clean-up

* fixing sessions snippet markers

* adding kotlin session snippets to files to test

* adding callback to memory_example

* Fixing capital agent snippet  (#35)

Fixing file name
Updating adkTool > Tool
Updating GeminiModel > Gemini

* Adding kotlin snippets for tools docs (#36)

* adding function tool kotlin snippets

* adding function_tools snippets to files to test

* Adding kotlin snippets to observability docs (#37)

* initial kotlin observability updates

* adding observability snippets to file check (#38)

* Adding Kotlin snippets to Callbacks docs (#39)

*  kotlin callbacks snippets

* adding callbacks snippets to file check

* Align Kotlin and KSP versions with published 0.1.0 artifacts (#40)

* switch CLI entry points from InMemoryRunner to ReplRunner (#41)

* Switch CLI entry points from InMemoryRunner to ReplRunner

* Fix wording

* Update API reference docs for Kotlin, 2026-05-18 (#42)

* Remove ADK on Android note until published (#43)

* Update Kotlin code samples (#44)

* Rename GeminiModel to Gemini in Kotlin snippets and docs

* Remove broken SessionKey call and use sessionId directly in AgentTool snippet

* Rewrite Go hero snippet to use llmagent API

* Use isFinalResponse with safe access in CapitalAgent snippet

* Use Role.USER constant instead of raw string in SetupExample

* Use full semver v0.1.0 in Kotlin language support tags

* Remove Android setup steps, moving to new property (#45)

* Tutorial Kotlin agent (#46)

* Adding multi-tool-agent snippet and updating tutorial
* Fixing Go language order on tutorial page
* adding multi tool agent example to files to test

* Inline Kotlin get-started code sample

* Kotlin Multi agents snippets (#47)

* Multi-agent kotlin snippets

* Fixing docs tags in multiagent example

* Fix Kotlin language support tags, code samples, and google-gemini.md cleanup (#48)

* Add Kotlin v0.1.0 to language support tags across docs

* Fix MultiToolAgent.kt model string and argument style

* Update MultiAgentExample.kt to use gemini-flash-latest model string

* Fix google-gemini.md: add Kotlin sample, remove unsupported Java tabs

* Remove explicit apiKey from CallbackBasic.kt for consistency

* Standardize Gemini() constructor to use named args in all snippets

* Remove adk-samples directory (moved to google/adk-samples#1969)

* Remove adk-samples directory (moved to google/adk-samples#1969) (#49)

* Update API reference docs for ADK Kotlin 0.1.0 (#50)

* Remove adk-samples directory (moved to google/adk-samples#1969)

* Update API reference docs for ADK Kotlin 0.1.0

* Remove kotlin lycheeignore config (#51)

* Remove adk-samples directory (moved to google/adk-samples#1969)

* Remove Kotlin .lycheeignore config links

---------

Co-authored-by: Toni Klopfenstein <2359976+ToniCorinne@users.noreply.github.com>
Co-authored-by: Jolanda Verhoef <JolandaVerhoef@users.noreply.github.com>
2026-05-19 11:43:42 -05:00
Kristopher Overholt 1214ad915a Update product names in docs (#1673)
* Update names in docs

* Update names in docs

* Code formatting

* Format notebooks

* Update names in docs

* Update names in docs

* Update names in code samples

* Update names in docs

* Update names in docs

* Update names in docs

* Update names in docs

* Update names in docs

* Update names in docs

* Update names in docs

* Update names in docs

* Update icon

* Update names in docs

* Update names in docs
2026-04-22 05:10:38 -07:00
Joe Fernandez f7ed80bbc6 docs: Update Gemini flash names (#1594)
* docs: home page

* updates based on feedback

* respond to review feedback

* docs: update gemini selector strings to "flash-latest"

* Update homepage.css
2026-04-09 16:14:27 -05:00
Joe Fernandez 7567175816 docs: move multi-tool agent and redirect links (#1557)
* docs: move multi-tool agent and redirect links

* update based on comments and testing
2026-04-03 17:55:27 -07:00
Kristopher Overholt 58f3aaebca Replace documentation URLs and paths for adk.dev migration (#1536)
* Replace google.github.io/adk-docs URLs and /adk-docs/ paths with adk.dev

Migrate all hardcoded documentation references to use the new custom
domain. Update root-relative links to remove the /adk-docs/ subpath
prefix since the site will be served from the root of adk.dev.

* Additional fixes
2026-04-01 12:48:27 -05:00
Shahin Saadati 83bf302734 Upgraded the Claude model to claude-sonnet-4-6 evrywhere in the docs. (#1390)
* Upgraded the Claude model to claude-sonnet-4-6 evrywhere in the docs.

* Added the missing java samples for vertex.md

* Undid changes in the wrong branch

---------

Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2026-03-04 09:27:36 -08:00
Dinesh Thumma 3dec3397e6 Changes model MODEL_2_0_FLASH to MODEL_2_5_FLASH as gemini-2.0 is deprecating (#1131)
* Update model constants to use GEMINI 2.5

* Corrected model name

---------

Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2026-01-12 11:44:21 -08:00
cl3m3nt e327ba7abc Add async session initialization example when running in .py script (#976)
* Add async session initialization example when running in .py script

Added example code for initializing a session asynchronously when running in .py script

* Update docs/tutorials/agent-team.md

---------

Co-authored-by: Kristopher Overholt <koverholt@google.com>
2025-11-21 15:34:32 -06:00
earlzero fa9c0603b2 Update agent-team.md Step 5 typo (#571)
Wrong method is used for getting weather. Instead of `get_weather` it should be `get_weather_stateful`

Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2025-08-13 15:33:58 -07:00
Utkarsh Vijayvergia 3037fe8b4e docs: specify ADK version requirement for tutorial compatibility (#369)
Co-authored-by: Lavi Nigam <98014943+lavinigam-gcp@users.noreply.github.com>
2025-06-06 11:25:54 +05:30
Utkarsh Vijayvergia 005d3ca985 fix: remove .as_dict() usage from final session state logging (#345)
* fix: remove as_dict() usage from final session state logging

The code incorrectly called `.as_dict()` on a plain `dict` object, causing an AttributeError.

This commit removes the invalid `.as_dict()` call.

* fix: remove .as_dict() usage from final session state logging

The code incorrectly called `.as_dict()` on a plain `dict` object, causing an AttributeError.

This commit like the previous one removes another occurence of the `.as_dict()` call.

---------

Co-authored-by: Lavi Nigam <98014943+lavinigam-gcp@users.noreply.github.com>
2025-05-31 17:06:39 +05:30
Utkarsh Vijayvergia dd85d2ac9a fix: remove invalid as_dict() usage from final session state logging (#307)
The code incorrectly called `.as_dict()` on a plain `dict` object, causing an AttributeError.

This commit replaces it with direct usage of the dictionary and adds a comment.

Co-authored-by: Lavi Nigam <98014943+lavinigam-gcp@users.noreply.github.com>
2025-05-29 21:49:29 +05:30
Lavi Nigam ce11a0ffc0 fix(tutorial): Fixing multiple reported issues (#334)
* fix(tutorial): Correct say_hello tool logic, update LLM models, and ensure async session creation

This commit addresses several issues and updates within the ADK agent team tutorial (adk_tutorial.ipynb) and its corresponding documentation (agent-team.md).

Notebook Updates (adk-tutorial.ipynb):
- Ensured all `SessionService.create_session` calls are `await`ed for proper asynchronous operation throughout the notebook.
- Updated Anthropic model to `claude-sonnet-4-20250514` and OpenAI model to `gpt-4.1`, with commented alternatives for flexibility.
- Added LiteLLM documentation links for model references.
- Resolved the 'Hello None' issue in Step 3 by modifying the `say_hello` tool to correctly handle optional name arguments and prevent the `Default value is not supported` warning with Gemini models.
- Tested and confirmed notebook compatibility with `google-adk==1.0.0`.

Page Update (agent-team.md):
- Synchronized `agent-team.md` with all notebook changes to ensure documentation accuracy and reflect the latest updates.

* fix(tutorial): Refine CLI/Web UI agent team tutorial and update content

This commit introduces several fixes and improvements to the Python file-based version of the ADK agent team tutorial, aligning it for use with `adk web`, `adk run`, and `adk api_server`.

Key changes to the `adk-tutorial` Python files:
- Validated and ensured all tutorial steps are compatible with `google-adk==1.0.0`.
- Synchronized Python file content with the latest changes from the main Colab notebook version.
- Corrected `step2_anthropic.py`: agent name, description, and instruction strings now accurately reflect Anthropic context (previously used GPT-related strings).
- Updated model identifiers: `anthropic/claude-sonnet-4-20250514` in `step2_anthropic.py` and `openai/gpt-4.1` in `step2_gpt4.py`.
- Performed general cleanup and refactoring in `step3_agent_team.py`.
- Added example queries directly within the agent Python files for Steps 1, 2, 3, 5, and 6 to facilitate easier testing by users.
- Removed `step4_state_personalization.py` as its demonstration of session state manipulation (especially direct InMemorySessionService updates) is better suited for an interactive notebook environment.

README.md Updates:
- Added a note explaining the removal of Step 4 and directing users to the interactive notebook version for that specific content.
- Included references to the newly added sample queries in the agent Python files, guiding users on how to test the agent's functionalities.
2025-05-29 21:03:20 +05:30
Andrew Larimer 79eb0685ce docs: add line break to render bullet points in agent-team.md (#326)
Co-authored-by: Kristopher Overholt <koverholt@gmail.com>
2025-05-29 05:57:23 -05:00
Megan O'Keefe 0887973bed feat: Initializes Java documentation (#277) 2025-05-20 12:10:27 -04:00
Lavi Nigam a4057576ea fix: tutorial section overhaul and bug fixes (#143)
* fix: tutorial section overhaul and bug fixes
- Tutorial section is moved out of getting started and is a seperate section
- Fixed a sentence in getting-started page that still showed “google search”
- Given we will have more tutorials as part of docs, now we have sub-sections with the tutorial name
- For weather agent team - fixed issues pointed out in #118 #135
    - It now includes code for asynio in the notebook
    - It also now has .py file to run it through adk web
    - Step 2 is now optional and not connected to other steps. So user can follow other steps if they choose to
    - There is disclaimer at the top - for different method to run the code
    - The text on the page is now synced with notebook
    - Collab and social link are updated with new changes in folder.

* added a redirect in the redirect_maps

* adding license headers in the code for tutorial for .py files
2025-04-23 09:43:32 +05:30