Commit Graph

43 Commits

Author SHA1 Message Date
Shahin Saadati e705f84906 Add Kotlin snippet for DebugLoggingPlugin (#2105)
* Add Kotlin snippet for DebugLoggingPlugin

The Kotlin logging page covered LoggingPlugin's console output but not
DebugLoggingPlugin, available since adk-kotlin 0.6.0, which records the same
activity in full to a YAML file instead of truncated console summaries. Both
plugins override the same twelve callbacks, so the difference really is only
fidelity and destination.

Transcluded from the existing LoggingExamples.kt rather than written inline,
matching the rest of the page and keeping it in the compile regression suite --
the file is already registered in files_to_test.txt.

The sample passes includeSystemInstruction = false, since the plugin's KDoc
cautions that it writes raw prompts, tool arguments and session state to disk.
Verified against the upstream test that the flag records has_system_instruction
in place of the instruction text rather than dropping the field, and the
comment names that field so it can be found in the output.

outputPath is left at its default rather than passed explicitly; the default
filename is given in the prose instead, so the snippet does not imply the
parameter is required.

Page badge left at Kotlin v0.1.0: the other snippets on the page have worked
since then, so the version requirement for this one is noted in the prose.

* docs: add Kotlin version support tag to debug logging documentation
2026-08-18 10:01:42 -07:00
Shahin Saadati b1b2eaa102 Upgrade Kotlin examples to adk-kotlin 0.7.0 (#2088)
* Upgrade Kotlin examples to adk-kotlin 0.7.0

The Kotlin examples were pinned to adk-kotlin 0.5.0, which predates the
context caching, Vertex AI memory, and RAG retrieval APIs. Bump the pin to
0.7.0 so snippets for those features can be added.

Three consequences of the bump are handled here:

- `ExperimentalResumabilityFeature` was removed in 0.7.0, so RunConfigExample
  no longer opts into it. The annotation class is gone, not merely deprecated,
  so this is a hard compile break rather than a warning that could be deferred.
- The Vertex AI session and memory services expose Ktor's `HttpClient` as a
  defaulted constructor parameter, so any snippet naming them needs Ktor on the
  compile classpath, not just at runtime.
- The `resolutionStrategy` block forcing kotlin-stdlib 2.1.20 is now dead. It
  worked around 0.5.0 publishing a stdlib newer than this project's compiler;
  0.6.0 fixed that upstream. Verified that the highest stdlib on the compile
  classpath is still 2.1.20 without it.

Also fixes two unrelated snags found while validating the above:

- `check_kotlin_snippets.sh` walked `examples/kotlin` without pruning build
  output, so after any local build it reported every generated KSP file as an
  unregistered snippet. CI only ever ran it against a clean checkout, so the
  bug was invisible there.
- A transclusion path in logging.md was split across two lines, so the include
  never resolved and the code block rendered empty.

* Fix broken links to adk-python plugin samples

The three plugin sample links 404. adk-python renamed
`contributing/samples/plugin/` to `contributing/samples/plugins/`; the
directory contents are otherwise unchanged, so only the path segment moves.

This is what the repo-wide `link-check` job has been failing on. It is
unrelated to the 0.7.0 upgrade in this PR, but the check gates the merge and
the fix is confined to the three URLs.

Verified all three targets return 200.
2026-08-07 13:24:29 -07:00
George Weale ab2d035e0d docs(observability): correct metric names, span attributes, logger names (#2013)
* docs(observability): correct metric names, span attributes, logger names

* docs(observability): restore otel_to_cloud metrics recipe, fix log-level fallback

* Update logging.md

---------

Co-authored-by: Joe Fernandez <931947+joefernandez@users.noreply.github.com>
2026-08-07 10:28:30 -07:00
Hyang-Ah Hana Kim af790ae141 docs: update more Go documentation and examples to ADK Go v2 (#1936)
* docs: update ADK Go imports to v2 for core concepts and tutorials

* docs: update ADK Go imports and APIs to v2 for runtime and safety

* docs: update ADK Go imports to v2 for features (workflows, tools, skills, sessions, plugins)

* docs: update ADK Go imports to v2 for operations and integrations

---------

Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-07-07 18:09:07 -05: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
Kumar Dhanagopal b1943362eb Fix command flag for GCP metrics export (#1763)
* Fix command flag for GCP metrics export

* Additional related fixes for --otel_to_cloud flag

---------

Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-05-14 16:17:20 -05:00
Kristopher Overholt 6261e3a2bd Readd docs page for metrics (#1713)
* Readd docs page for metrics

* Update lychee link checker config

* Update lychee config
2026-05-04 16:02:09 -05:00
Kristopher Overholt 7e3b386339 Remove metrics page that documents unreleased functionality (#1712)
The metrics module and has not shiipped in any stable ADK
Python release. The page will be restored once a release
includes metrics support.
2026-04-30 16:48:29 -05:00
mhenc dd4420907d Update documentation for setting up logging in ADK (#1704)
* Update documentation for setting logging in ADK

* Added OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT to Python and ADK web

* Small formatting issue

* Fix logging docs: bugs, heading structure, and copy-paste errors

- Fix os.environ assignment crash: bool True to string "true"
- Fix two errors: "traces"/"metrics" changed to "logs"
- Fix heading hierarchy: Python and Go setup as sibling h3 sections
- Add intro text under Python and Go programmatic setup headings
- Restore Go launcher CLI example that was removed in restructure
- Remove TypeScript and Java from language tags
- Remove redundant sentences in intro and Python setup sections

* Improve logging docs formatting and trim debugging example

- Convert blockquote notes to MkDocs admonitions
- Remove horizontal rules between sections
- Trim debugging example: trim redundant steps and log output
- Clean up section headings

---------

Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-04-30 13:12:48 -05:00
mhenc f68cf78ddc Add documentation pages for metrics and traces (#1686)
* Add documementation pages for metrics and traces

* First round of review

* Updated versions tag

* Update docs/observability/metrics.md

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

* Update docs/observability/traces.md

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

* Update docs/observability/traces.md

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

* Update docs/observability/metrics.md

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

* Update docs/observability/traces.md

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

* Update docs/observability/traces.md

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

* Update docs/observability/metrics.md

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

* Update docs/observability/traces.md

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

* Update docs/observability/traces.md

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

* Update docs/observability/metrics.md

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

* Added information about traces and metrics to observability/index.md

* Minor link and formatting edits

---------

Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-04-28 12:18:36 -05: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
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
Toni Klopfenstein 4ad6e08055 Updating logging doc to clarify Go logging info + otel (#1514)
* Updating logging docs with Go snippets

* rearranging logging llevel info

---------

Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2026-03-30 20:14:17 +00:00
Joe Fernandez 06a78591bd docs: MCP pages, add tip pointer to Tools and integrations (#1290)
* docs: MCP pages, add tip pointer to Tools and integrations

* adding Integration tips

- also removing incorrect Plugin / ADK Web incompatibility issue
2026-02-11 14:51:21 -08:00
Joe Fernandez b117fc695b docs: centralize 3P and 1P Integrations content (#1249)
* docs: centralize 3P and 1P Integrations content

- move all content to integrations/
- frontmatter headings for all integration listings

* respond to review comments
2026-02-06 09:30:13 -08:00
Haiyuan Cao 1a0783978f Enhance BigQuery Agent Analytics configuration (#1221)
Added new fields for session metadata and custom tags to the BigQuery Agent Analytics configuration.

Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2026-02-04 10:09:55 -08:00
Haiyuan Cao caae2150c3 Enhance documentation with OpenTelemetry support details (#1161)
Added OpenTelemetry initialization and tracing details to the documentation, explaining its optional use for distributed tracing and fallback mechanisms.

Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2026-01-22 16:34:14 -08:00
Haiyuan Cao 7f7f509dd5 Update BigQuery Agent Analytics configuration options (#1145)
* Update BigQuery Agent Analytics configuration options

Added new configuration options for BigQuery Agent Analytics, including queue_max_size and retry_config. Updated documentation to reflect changes in attributes and provided examples for AI-powered root cause analysis.

* Update model version in BigQuery agent analytics

* Update bigquery-agent-analytics.md

---------

Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2026-01-16 11:14:37 -08:00
Jeremy Silva 44267107bf Update freeplay.md (#1125)
Use direct linking
2026-01-08 17:19:08 -06:00
Jeremy Silva 18eef094b3 Update freeplay.md (#1103)
Fixing broken image links in documentation

Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-01-05 11:25:22 -06:00
ono.takayuki d54be009aa docs: fix typo in BigQuery DDL (missing space before OPTIONS) (#1080) 2025-12-17 09:31:56 -06:00
Goodnight 93be6e3dd2 docs: fix typos and spacing across docs (#1079) 2025-12-16 18:36:18 -06:00
Shahin Saadati fd7c7a3dca feat: Merge all the typescript code samples and snippets into the main repo. (#1063)
* Deleted redundant files.

* Deleted redundant files.

* Deleted redundant files.

* Deleted redundant files.

* Deleted redundant files.

* Deleted redundant files.

* Delete .gitignore

Deleted redundant files.

* Delete .gitignore

Deleted redundant files.

* Delete .gitignore

* Delete .gitignore

* Delete .gitignore

* Revert changes to .gitignore

* Revert changes to .gitignore

* Revert changes to .gitignore

* Revert changes to .gitignore

* Revert changes to .gitignore

* Revert changes to .gitignore

* Add MCP Tools TS example

* Removed unnecessary changes

* Removed extra slashes

* Added the custom agent sample.

* Corrected an error in the package.json file.

* Updated custom-agent.md

* Made small fixes.

* Add Session TS examples

* Added the typescript code snippets for multi agent.

* added the code sample for loop agent

* Added the code sample for loop agent

* Added the code sample for parallel agent

* Fixed a few issues and bugs

* Added the code sample for sequential agent

* Renamed run back to runAsync

* Updated the capital agent code sample.

* Corrected the snippet

* Renamed run() to runAsync()

* Add Runtime TS examples

* Fixed the snippets after library updates.

* Fixed the sample code after library changes.

* Added final touchups and fixes.

* Updated the code based on recent library changes.

* Updated package.json

* Updated package.json

* Updated package.json

* Updated the code with runAsync and package.json

* Updated the typescript sample.

* Updated after_tool_callback.ts with runAsync

* Updated after_model_callback.ts

* Updated before_model_callback.ts

* Updated before_tool_callback.ts

* Created before_agent_callback.ts

* Update before_agent_callback.ts

Changed the condition

* Update before_model_callback.ts

Changed the condition

* Update after_model_callback.ts

Changed the condition

* Update after_tool_callback.ts

Changed the condition

* Update after_agent_callback.ts

Changed the condition

* Update callback_basic.ts

Changed the condition

* Update storyflow_agent.ts

Changed the condition

* Update sequential_agent_code_development_agent.ts

Changed the condition

* Updated before_agent_callback.ts

* Removed unnecessary comment.

* Updated comment

* Renamed run to runAsync

* Added artifact code snippets.

* Fixed .link-checker-config.json

* Added tsconfig.json

* Update .gitignore with node modules files

* Added 7 typescript code snippets

* Cleaned up and corrected the snippets for plugins

* Update index.md

Undid the changes in artifacts/index.md

* Escaped properly.

* Add Long Running Function Tool TS examples

* Resolved code review feedback

* Fixed the code sample per git comments.

* Fixed the code per git comments.

* Fixed the md file per git comments.

* Fixed the issues per git comments.

* Fixed issues per github comments.

* Fixed the issues per PR comments.

* Fixed issues per PR comments.

* Added a code sample for HITL

* Fixed the indentations in the typescript code

* Used createPartFromBase64 when appropriate.

* Switched to use createUserContent.

* docs: Add JavaScript Quickstart, short unified format

* Added a simulated user delay to the code sample.

* Made some cosmetic improvements

* Added the code snippet with HITL with policy

* Made cosmetic modifications to multi-agents.md

* Added more tutorial for the HITL with policy

* Modularized the main function and added helper functions.

* Resolved code review feedback

* Resolved code review feedback

* Resolved code review feedback

* Fixed minor things in the typescript code per PR comments.

* Fixed the import for Event and used createEventActions.

* Simplified functionResponse code.

* Corrected the Event import and used createEventActions.

* Updated ADK versions in package.json.

* Final review of all changes & Add Safety TS example

* Make tsconfig.json files consistent

* Generated the API Reference for typescript

* Resolved code review feedback

* feat: Add Typescript API reference to docs

This commit adds the generated TypeDoc documentation for the Typescript ADK to the documentation site.

It also updates the main API reference page to include a link to the new Typescript API reference.

* docs: update TypeScript quickstart

* docs: Add version tags for Build Agents topics

- add version tags
- move TS content to second position (after Python)

* docs: Add MCP Toolbox for databases TS SDK Documentation

* Update mcp-toolbox-for-databases.md

* use typescript code block

* minor changes

* Update mcp-toolbox-for-databases.md

* Auto generated the typescript API reference.

* Added the TS code snippets for context.

* Fixed TS code snippets for context.

* Modified the sample based on the comment.

* docs: adding TypeScript language tags (2 of 3)

- Update all Run Agents section topics
- change all TS tags to v0.2.0 per eng agreement

* docs: Add TypeScript language support tags, Components (3 of 3)

- add TS language support tags
- re-order TS examples to be second
- minor fixes: remove trailing spaces

* Added callback samples for typescript to the markdown files.

* Updated adk version in quickstart

* Updated google/adk version for typescript.

---------

Co-authored-by: manchan <manchan@google.com>
Co-authored-by: Mandy Chan <75594070+slothwriter@users.noreply.github.com>
Co-authored-by: Joe Fernandez <joefernandez@google.com>
Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
Co-authored-by: Twisha Bansal <58483338+twishabansal@users.noreply.github.com>
2025-12-15 12:53:24 -08:00
Haiyuan Cao dd8d30d7a6 Move BigQuery Agent Analytics docs to observability directory and update the plugin doc to v2 (#1060)
* Move BigQuery Agent Analytics docs to plugins directory

* Enhance BigQuery Agent Analytics documentation

Updated the documentation for the BigQuery Agent Analytics plugin to clarify event logging configurations and added a code sample for setting up the plugin.

* Move BigQuery analytics to observability and update index link

* Remove default comment from max_content_length

* Update mkdocs.yml for BigQuery Analytics move

* Update BigQuery Agent Analytics configuration defaults

* Move BQ observabilty page in nav

* Fix markdown list formatting in IAM permissions

* Clarify ADK 1.21.0 version requirement

* Update BigQuery Agent Analytics documentation

* Strongly recommend latest ADK version

* Refine BigQuery Agent Analytics documentation

* Update bigquery-agent-analytics.md

* Remove deprecated documentation

---------

Co-authored-by: Kristopher Overholt <koverholt@google.com>
Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2025-12-12 15:55:04 -08:00
Jeremy Silva 35060b663c Update freeplay.md (#1028)
* Update freeplay.md

Replace the loom link with an embedded youtube video

* Update video w/ YouTube embed

---------

Co-authored-by: Kristopher Overholt <koverholt@google.com>
2025-12-04 20:13:58 -06:00
Yuki Watanabe 69868c95cc Add MLflow tracing integration guide (#1008)
* Add MLflow tracint integration guide:

Signed-off-by: B-Step62 <yuki.watanabe@databricks.com>

* Formatting

* Formatting and wording

* Formatting

---------

Signed-off-by: B-Step62 <yuki.watanabe@databricks.com>
Co-authored-by: Kristopher Overholt <koverholt@google.com>
2025-12-01 16:12:45 -06:00
Hoc Phan a15d122453 Add Monocle (#978) 2025-11-17 10:19:51 -06:00
Jeremy Silva b3c71d1447 Add Freeplay to observability page (#816)
* Add Freeplay to observability page

Add details on the Freeplay <> Google ADK integration

* Update freeplay.md

Making requested changes

* Update freeplay.md

Add links at the bottom

* Update mkdocs.yml

Add Freeplay to observability section

* Update docs/observability/freeplay.md

* Update mkdocs.yml

Maintain alphabetical ordering

---------

Co-authored-by: Kristopher Overholt <koverholt@google.com>
2025-11-07 10:21:11 -06:00
Joe Fernandez 820ef32385 docs: Runtime to Safety, update language order, part4 (#898)
- Runtime, Deployment, Observability, Evaluation, Safety
2025-11-06 14:35:14 -08:00
Ivan Cheung 8834593806 [ADK Go] Merging all Go docs from the private repo (#885)
* docs: Add Go language quickstart

* updates based on review comments

* fix tab stops

* update based on review comments

* sync with main

* update to tested version

* Added google_search snippet

* Fix: Address Go style guide issues in google_search.go

* Migrated to new API

* Fixed tool info in md file

* Added partial check

* Added function-tools sample

* Migrated to new API

* Added partial check

* Ran linter

* feat: add go fmt check

* Run go fmt only on changed files

* Added google_search snippet

* Fix: Address Go style guide issues in google_search.go

* Migrated to new API

* Added partial check

* Added function-tools sample

* Migrated to new API

* Added partial check

* Ran linter

* feat: add go fmt check

* Run go fmt only on changed files

* Feat: Add Golang example for LLM agents

* Added schema agent

* Added session support

* Migrated to new API

* Added back OutputKey

* Added missing snippets

* Moved snipped to its own package

* Minor cleanup

* Reverted llm-agents.md

* Added back correct changes to llm-agents.md

* Updated to newest API

* Ran linter

* WIP

* WIP: Added the rest of the agents

* Added sequential agent

* Migrated agents to new API

* Fixed snippet tags

* Updated parallel and sequential with OutputKey

* Updated loop agent

* Cleanup

* Fixed and ran linter

* Removed comment

* Ran linter

* Added custom agent snippets

* Migrated to new API

* Fixed incorrect info about channels since run returns an Iterator, not Channel

* Cleanup and renaming

* Ran linter

* Fixed md

* Added multi-agent docs

* Updated to use AgentTool

* Split snippets

* Added missing file

* Ran linter and fixed API

* Added Models snippets

* Migrated to new API

* Embedded imports

* Ran linter

* Added long running tool

* Ran linter and fixed API

* Switched to two-turn style

* Ran linter

* Added callback snippets

* Added back imports

* Added types of callbacks snippets

* feat(go): align callback snippets with other languages

* Ran linter and updated API

* Added tool callbacks

* Added artifact snippets

* Use story.pdf instead of random bytes

* Fixed issue with artifact loading

* Cleanup unneeded fixes

* Added back inadvertently removed GCS section

* Addressed PR comments

* Ran linter

* feat: Added context snippets

* Fixed callback signature

* Fixed additional callbacks

* Added remaining snippets

* Added conceptual runner example

* Removed duplicate code

* Clean up tags and imports

* Updated API

* Twaked text

* Ran linter

* Fixed broken API issues

* Updated to latest Go ADK API

* Added func param info

* Interleaved Py and Go

* Revert mistakes

* Removed extra newline

* Added example cloud run code and update md with Go (#41)

* Added example cloud run code and update md with Go

* Added a2a_agent_url and fixed future tense

* Moved Go before Java

---------

Co-authored-by: ivanmkc <ivanmkc@google.com>

* adding go snippets to runconfig docs

* realigning runconfig go examples with current state of adk-go.

* adding language support tags to individual runtime config fields

* removing unsupported supportcfc go examples

* removing unsupported streamingmode.bidi go snippets

* Added AgentTool examples (#31)

* Added AgentTool example

* Ran formatter

---------

Co-authored-by: ivanmkc <ivanmkc@google.com>

* adding initial go sessions.sessions snippets

* updating go session docs + session examples

* update go session snippets

* updating DatabaseSessionService language support tag

* cleaning up go vertex ai comments

* removing go.mod for session_management_example

* docs: add language support tags for Go

* initial go runtime sample updates

* fixing runtime go snippet formatting

* formatting updates to runtime go snippets

* updating runtime go examples to streamline to newer go features

* adding go snippets for events

* updating go snippets for events

* adding artifactdelta snippet for go

* minor java fixes, cleaning up go event.content

* Custom tools: Merging again  (#44)

* Added missing custom-tools snippets

* Split user_preference runner code

* Split more files

* Tweaks

* Split session into 1 and 2 and added artifact saving

* Fixed conflict

---------

Co-authored-by: ivanmkc <ivanmkc@google.com>

* Fixed tab issue with cloud-run md (#45)

Co-authored-by: ivanmkc <ivanmkc@google.com>

* adding initial go snippets for memory services

* updating go memory sample, adding python formatting in docs to clarify current support.

* removing go replace for memory example

* removing go.sum from memory_example

* fixing go formatting for memory example

* fixing go memory snippets to streamline examples in docs

* removing unnecessary go.mod for memory_example.go and snippet cleanup

* adding go session state snippets."

* adding additional go state examples for state injection

* fixing go formatting

* fixing language ordering on session/state.md; removing unnecessary go.mod files

* reworking error functions in go session state samples

* fixing go formatting on session state samples

* initial go snippets for safety tools

* fixing go snippet formatting in safety/index.md

* temp storing safety example

* cleaning up go snippets in safety docs; deferring safety go full example

* cleaning up go safety snippets

* Added link to Go API docs (#47)

Co-authored-by: ivanmkc <ivanmkc@google.com>

* Added a2a_basic sample (#46)

* Added a2a_basic sample

* Removed dummy LLMs

* Added md

Fix inaccuracies in md

Ran formatter

* Cleaned up index

---------

Co-authored-by: ivanmkc <ivanmkc@google.com>

* Reverted to proper ToC and added missing links (#48)

Co-authored-by: ivanmkc <ivanmkc@google.com>

* Added missing get-started/go.md (#50)

Co-authored-by: ivanmkc <ivanmkc@google.com>

* Added missing JSON tags for Go structs (#51)

* Added json tags

* Added jsonschema and json tags

---------

Co-authored-by: ivanmkc <ivanmkc@google.com>

* Renamed Golang to Go (#52)

Co-authored-by: ivanmkc <ivanmkc@google.com>

---------

Co-authored-by: Joe Fernandez <joefernandez@google.com>
Co-authored-by: ivanmkc <ivanmkc@google.com>
Co-authored-by: Toni Klopfenstein <tklopfenstein@google.com>
2025-11-06 14:13:13 -05:00
Joe Fernandez f12068a4bb docs: add language support tags to pages (#850)
* docs: add language support tags to pages

- replace img.shield tags
- add language support tags where missing

* update Agents page with general tags

* update language and version tagging

- response to review comments
- rename css styles to avoid style name conflicts

* add tags to api-server page
2025-11-03 16:07:35 -08:00
Kristopher Overholt 7481a13246 fix: Update link to sample notebook for observability / HITL (#795)
Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2025-10-22 15:08:59 -07:00
Will 保哥 2841f9afa5 Fix bad link (#709)
fixes #706
2025-09-23 12:24:58 -05:00
Holt Skinner af2ee80fde docs: Fix formatting/spelling errors in Docs (#676)
* docs: Update formatting of logging information

- Remove duplicates

* Fix formatting/spelling issues in Express Mode page

* Fix code formatting

* Rename "Google Cloud's" -> Google Cloud per branding guidelines

* Spelling fix on A2A

* Formatting fixes in a2a consuming

* Fix typo/formatting error on API Reference homepage

* Remove custom anchors in CONTRIBUTING.md because GFM doesn't support them

* Add imports to A2A Samples and update agent.json to agent-card.json

---------

Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2025-09-10 08:18:12 -07:00
nikkie 06f9cb3b2e fix: Correct option typo --log-level -> --log_level (#581)
Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2025-08-13 15:28:45 -07:00
Terrence Ryan f563df660d feat: adding heading identifier to improve linkability (#587)
Fixes: #109
2025-08-11 16:26:28 -07:00
Alvin Prayuda 50edb824a2 docs: add cloud trace observability guide and assets (#520)
* docs: add cloud trace observability guide and assets

* docs: reorder observability sections and clarify cloud trace setup instructions

* docs: add cloud tracing setup instructions for ADK CLI deployments

---------

Co-authored-by: Polong Lin <polong-lin@users.noreply.github.com>
2025-07-30 10:08:15 +01:00
Xuan Yang 52e1074962 docs: add --log-level option in ADK logging documentation (#534)
* docs: add `--log-level` option in ADK logging documentation

* docs: add -v, --verbose flag shortcut in ADK logging documentation
2025-07-30 08:48:24 +01:00
Anubhav Singh 2747fa3e0b docs: Add weave by W&B as an observability option (#498)
* docs: Add weave by W&B as an observability option

* Updated menu item name and Added screenshots

---------

Co-authored-by: Lavi Nigam <98014943+lavinigam-gcp@users.noreply.github.com>
2025-07-17 14:06:25 +05:30
Dwij a3354e3861 docs: add agentops integration documentation (#376)
* feat: add Observability section to mkdocs configuration and Agentops integration

This commit introduces a new "Observability" section in the mkdocs.yml file, including a link to the AgentOps Integration documentation. This enhancement improves the navigation structure of the documentation.

* small docs revisions

* Alex updates

* Update agentops.md

* fix: update navigation label for AgentOps in mkdocs.yml

* Update agentops.md

* Update README.md

* Update README.md

* Update mkdocs.yml

---------

Co-authored-by: Braelyn Boynton <bboynton97@gmail.com>
Co-authored-by: Alex Reibman <meta.alex.r@gmail.com>
Co-authored-by: Sita Lakshmi Sangameswaran <sitalakshmi@google.com>
2025-07-11 09:38:22 -04:00
Xuan Yang 69b9f89602 docs: add ADK logging documentation (#502)
* docs: add ADK logging documentation

* updated mkdocs.yml with the new guide

---------

Co-authored-by: Lavi Nigam <98014943+lavinigam-gcp@users.noreply.github.com>
Co-authored-by: Lavi Nigam <lavinigam@google.com>
2025-07-11 18:13:28 +05:30
s-yeddula 4c722d0992 docs: updating Phoenix connection instructions (#489)
* Updating Phoenix connection instructions

* docs: updating Phoenix connection

* docs: updating Phoenix connection docs

---------

Co-authored-by: Sita Lakshmi Sangameswaran <sitalakshmi@google.com>
2025-07-08 22:12:31 -04:00
s-yeddula 57348743b9 docs: Arize AX and phoenix tracing documentation (#431)
* adding docs

* docs: add Arize AX and Phoenix tracing documentation
2025-06-23 18:25:18 +05:30