Anubhav Dhawan
362ed8df41
docs: migrate to toolbox-adk and simplified ToolboxToolset ( #2211 )
...
Updates all quickstart guides and samples to use the new `toolbox-adk`
package instead of the legacy `toolbox-core`. Also updates
`ToolboxToolset` usage to rely on the simplified constructor (implicit
authentication) and ensures correct dependency installation.
> [!NOTE]
> The integration tests are failing because the `google-adk` package is
not released yet with the newer changes from `toolbox-adk`. This is
expected behavior until the [package update](cl/853799009) is released.
2026-01-28 11:26:13 +05:30
Anubhav Dhawan
923479034f
docs: Improve and simplify ADK Python Quickstart ( #1962 )
...
## Description
This PR updates the ADK portion of the Python local quickstart to align
with the latest ADK getting started guide. The previous instructions
involved a complex, boilerplate-heavy script that was not the
recommended approach and made it difficult to focus on the Toolbox
integration.
### Improvements
* The guide now uses the `adk` CLI (e.g., `adk create`, `adk web`),
which is the standard and more intuitive way to work with ADK projects.
* The agent script is now much simpler and more focused, removing a
significant amount of ADK-specific boilerplate. This makes it easier for
users to see how Toolbox is integrated.
* The steps are clearer, and we've added links to more in-depth ADK
documentation for running agents locally and deploying them to the
cloud.
### Before
<img width="1820" height="1852" alt="image"
src="https://github.com/user-attachments/assets/cecb8a4d-cccb-4488-8fca-df5f86c153e9 "
/>
### After
<img width="1800" height="1830" alt="image"
src="https://github.com/user-attachments/assets/9200fb51-548e-4188-b42f-1850a47d7349 "
/>
### Before
<img width="1778" height="278" alt="image"
src="https://github.com/user-attachments/assets/beb32070-5ef4-4bfb-b8ce-04268da4aa90 "
/>
### After
<img width="1822" height="852" alt="image"
src="https://github.com/user-attachments/assets/5e725058-7bae-4e44-9d69-25c46d88005a "
/>
These changes provide a much smoother and more straightforward
onboarding experience for developers using ADK with Toolbox.
🛠️ Addresses https://github.com/googleapis/genai-toolbox/issues/1705
Fixes https://github.com/googleapis/mcp-toolbox-sdk-python/issues/370
2025-11-26 18:41:36 +05:30
Anubhav Dhawan
185c72939d
docs: Update guides to require Python 3.10+ following Python 3.9 drop ( #2020 )
...
## Description
This PR updates the installation guides and documentation to reflect
that Python 3.9 is no longer supported. Users are now instructed to
install Python 3.10+.
## Context
This is a follow-up to
https://github.com/googleapis/mcp-toolbox-sdk-python/pull/422 , which
officially removed support for Python 3.9 from the Python SDKs codebase.
This change ensures the documentation aligns with the current package
requirements.
2025-11-24 14:58:03 +05:30
Yuan Teoh
735cb760ea
docs: update long lines and tables ( #1952 )
...
Update long lines and tables formatting in markdown doc files.
2025-11-14 20:25:49 +00:00
Yuan Teoh
3d8a041782
docs: fix docs linting ( #1520 )
2025-09-18 16:30:46 -07:00
Yuan Teoh
38eae15e16
docs: fix broken links in python quickstart ( #1427 )
2025-09-11 14:17:38 -07:00
Harsh Jha
f544e676ea
chore: modify quickstart structure to support testing ( #1186 )
...
Co-authored-by: Anmol Shukla <shuklaanmol@google.com >
Co-authored-by: Twisha Bansal <58483338+twishabansal@users.noreply.github.com >
2025-08-28 11:52:49 +05:30
Anmol Shukla
a21e68022b
docs: renaming sample agent functions to a common name ( #1244 )
2025-08-28 11:07:51 +05:30
Harsh Jha
e376cce18c
docs: add shortcode for including file regions ( #1043 )
...
Introduces a new Hugo shortcode, `includeRegion`, to allow embedding
specific, tagged regions from source files directly into Markdown
content.
This helps maintain a single source of truth for code snippets and other
repeated content, such as setup instructions, preventing duplication and
simplifying updates across multiple quickstart guides.
Demo PR: https://github.com/googleapis/genai-toolbox/pull/1179
---------
Co-authored-by: Anmol Shukla <shuklaanmol@google.com >
2025-08-22 06:24:50 +00:00
release-please[bot]
d19cfc1e7e
chore(main): release 0.12.0 ( #1085 )
...
🤖 I have created a release *beep* *boop*
---
##
[0.12.0](https://github.com/googleapis/genai-toolbox/compare/v0.11.0...v0.12.0 )
(2025-08-14)
### Features
* **prebuiltconfig:** Introduce additional parameter to limit context in
list_tables
([#1151 ](https://github.com/googleapis/genai-toolbox/issues/1151 ))
([497d3b1 ](497d3b126d ))
* **prebuiltconfig/alloydb-admin:** Add list cluster, instance and users
([#1126 ](https://github.com/googleapis/genai-toolbox/issues/1126 ))
([b42c139 ](b42c139158 ))
* **prebuiltconfig/alloydb-postgres:** Add tool to create user via Built
in user type or IAM
([#1130 ](https://github.com/googleapis/genai-toolbox/issues/1130 ))
([f5bcb9c ](f5bcb9c755 ))
* **source/http:** Add User Agent to `http` invocations
([#1102 ](https://github.com/googleapis/genai-toolbox/issues/1102 ))
([6f55b78 ](6f55b78e96 ))
* **sources/postgres:** Add support for `queryParams`
([#1047 ](https://github.com/googleapis/genai-toolbox/issues/1047 ))
([7b57251 ](7b57251402 )),
closes [#963 ](https://github.com/googleapis/genai-toolbox/issues/963 )
* **tools/bigquery-execute-sql:** Add dry run support
([#1057 ](https://github.com/googleapis/genai-toolbox/issues/1057 ))
([1cac9b5 ](1cac9b5b37 ))
* **tools/dataplex-search-aspect-types:** Add support for
`dataplex-search-aspect-types` tool
([#1061 ](https://github.com/googleapis/genai-toolbox/issues/1061 ))
([d940187 ](d940187c85 ))
* **tools/looker:** Add `looker-make-look` tool to create Looks
([#1099 ](https://github.com/googleapis/genai-toolbox/issues/1099 ))
([61d9489 ](61d9489344 ))
* **tools/looker:** Add visualizations to `query-url` tool
([#1090 ](https://github.com/googleapis/genai-toolbox/issues/1090 ))
([5bf2758 ](5bf275846a ))
* **tools/looker:** New Looker tools for dashboards
([#1118 ](https://github.com/googleapis/genai-toolbox/issues/1118 ))
([42be3f5 ](42be3f550c ))
* **ui:** Add login with google button for automatic id token retrieval
([#1044 ](https://github.com/googleapis/genai-toolbox/issues/1044 ))
([d91bdfc ](d91bdfcbdc ))
### Bug Fixes
* Correct the capitalization of `map` manifests
([#1139 ](https://github.com/googleapis/genai-toolbox/issues/1139 ))
([0b0457c ](0b0457c8e6 ))
* Remove unnecessary fields from `map` parameter manifests
([#1138 ](https://github.com/googleapis/genai-toolbox/issues/1138 ))
([fbe8c1a ](fbe8c1a9c0 ))
* **tools/looker:** Add authorized invocation feature to all Looker
tools ([#1091 ](https://github.com/googleapis/genai-toolbox/issues/1091 ))
([3b1cce7 ](3b1cce72e7 ))
* Update ui info log to reflect port
([#1125 ](https://github.com/googleapis/genai-toolbox/issues/1125 ))
([6d691d5 ](6d691d582f ))
---
This PR was generated with [Release
Please](https://github.com/googleapis/release-please ). See
[documentation](https://github.com/googleapis/release-please#release-please ).
---------
Co-authored-by: release-please[bot] <55107282+release-please[bot]@users.noreply.github.com>
Co-authored-by: Yuan Teoh <45984206+Yuan325@users.noreply.github.com >
2025-08-14 16:41:28 -07:00
Ajaykumar Yadav
c65c11af24
docs: fix typos across docs ( #1154 )
...
got some typos while reading the docs
Co-authored-by: Averi Kitsch <akitsch@google.com >
2025-08-14 21:42:04 +00:00
release-please[bot]
a09f628b52
chore(main): release 0.11.0 ( #1071 )
...
🤖 I have created a release *beep* *boop*
---
##
[0.11.0](https://github.com/googleapis/genai-toolbox/compare/v0.11.0...v0.11.0 )
(2025-08-05)
### ⚠ BREAKING CHANGES
* **tools/bigquery-sql:** Ensure invoke always returns a non-null value
([#1020 ](https://github.com/googleapis/genai-toolbox/issues/1020 ))
([9af55b6 ](9af55b651d ))
* **tools/bigquery-execute-sql:** Update the return messages
([#1034 ](https://github.com/googleapis/genai-toolbox/issues/1034 ))
([051e686 ](051e686476 ))
### Features
* Add TiDB source and tool
([#829 ](https://github.com/googleapis/genai-toolbox/issues/829 ))
([6eaf36a ](6eaf36ac85 ))
* Interactive web UI for Toolbox
([#1065 ](https://github.com/googleapis/genai-toolbox/issues/1065 ))
([8749b03 ](8749b03003 ))
* **prebuiltconfigs/cloud-sql-postgres:** Introduce additional parameter
to limit context in list tables
([#1062 ](https://github.com/googleapis/genai-toolbox/issues/1062 ))
([c3a58e1 ](c3a58e1d16 ))
* **tools/looker-query-url:** Add support for `looker-query-url` tool
([#1015 ](https://github.com/googleapis/genai-toolbox/issues/1015 ))
([327ddf0 ](327ddf0439 ))
* **tools/dataplex-lookup-entry:** Add support for
`dataplex-lookup-entry` tool
([#1009 ](https://github.com/googleapis/genai-toolbox/issues/1009 ))
([5fa1660 ](5fa1660fc8 ))
### Bug Fixes
* **tools/bigquery,mssql,mysql,postgres,spanner,tidb:** Add query
logging to execute-sql tools
([#1069 ](https://github.com/googleapis/genai-toolbox/issues/1069 ))
([0527532 ]([0527532bd7 ))
---
This PR was generated with [Release
Please](https://github.com/googleapis/release-please ). See
[documentation](https://github.com/googleapis/release-please#release-please ).
---------
Co-authored-by: release-please[bot] <55107282+release-please[bot]@users.noreply.github.com>
Co-authored-by: Yuan Teoh <45984206+Yuan325@users.noreply.github.com >
2025-08-05 14:00:26 -07:00
Averi Kitsch
af3d791dea
chore: roll back version ( #1077 )
2025-08-05 16:12:31 +00:00
release-please[bot]
8d0fa6783a
chore(main): release 0.11.0 ( #1000 )
...
🤖 I have created a release *beep* *boop*
---
##
[0.11.0](https://github.com/googleapis/genai-toolbox/compare/v0.10.0...v0.11.0 )
(2025-08-04)
### ⚠ BREAKING CHANGES
* **tools/bigquery-sql:** Ensure invoke always returns a non-null value
([#1020 ](https://github.com/googleapis/genai-toolbox/issues/1020 ))
([9af55b6 ](9af55b651d ))
* **tools/bigquery-execute-sql:** Update the return messages
([#1034 ](https://github.com/googleapis/genai-toolbox/issues/1034 ))
([051e686 ](051e686476 ))
### Features
* Add DuckDB source and tool
([#879 ](https://github.com/googleapis/genai-toolbox/pull/879 ))
([fd14933 ](fd149337e9 ))
* Add TiDB source and tool
([#829 ](https://github.com/googleapis/genai-toolbox/issues/829 ))
([6eaf36a ](6eaf36ac85 ))
* Interactive web UI for Toolbox
([#1065 ](https://github.com/googleapis/genai-toolbox/issues/1065 ))
([8749b03 ](8749b03003 ))
* **tools/looker-query-url:** Add support for `looker-query-url` tool
([#1015 ](https://github.com/googleapis/genai-toolbox/issues/1015 ))
([327ddf0 ](327ddf0439 ))
* **tools/dataplex-lookup-entry:** Add support for
`dataplex-lookup-entry` tool
([#1009 ](https://github.com/googleapis/genai-toolbox/issues/1009 ))
([5fa1660 ](5fa1660fc8 ))
---
This PR was generated with [Release
Please](https://github.com/googleapis/release-please ). See
[documentation](https://github.com/googleapis/release-please#release-please ).
---------
Co-authored-by: release-please[bot] <55107282+release-please[bot]@users.noreply.github.com>
Co-authored-by: Yuan Teoh <45984206+Yuan325@users.noreply.github.com >
2025-08-04 19:11:17 -07:00
Yuan Teoh
90d4558a8e
docs: update docs lint ( #995 )
2025-07-25 17:26:28 +00:00
release-please[bot]
c45390e6f7
chore(main): release 0.10.0 ( #886 )
...
🤖 I have created a release *beep* *boop*
---
##
[0.10.0](https://github.com/googleapis/genai-toolbox/compare/v0.9.0...v0.10.0 )
(2025-07-25)
### Features
* Add `Map` parameters support
([#928 ](https://github.com/googleapis/genai-toolbox/issues/928 ))
([4468bc9 ](4468bc920b ))
* Add Dataplex source and tool
([#847 ](https://github.com/googleapis/genai-toolbox/issues/847 ))
([30c16a5 ](30c16a559e ))
* Add Looker source and tool
([#923 ](https://github.com/googleapis/genai-toolbox/issues/923 ))
([c67e01b ](c67e01bcf9 ))
* Add support for null optional parameter
([#802 ](https://github.com/googleapis/genai-toolbox/issues/802 ))
([a817b12 ](a817b120ca )),
closes [#736 ](https://github.com/googleapis/genai-toolbox/issues/736 )
* **prebuilt/alloydb-admin-config:** Add alloydb control plane as a
prebuilt config
([#937 ](https://github.com/googleapis/genai-toolbox/issues/937 ))
([0b28b72 ](0b28b72aa0 ))
* **prebuilt/mysql,prebuilt/mssql:** Add generic mysql and mssql
prebuilt tools
([#983 ](https://github.com/googleapis/genai-toolbox/issues/983 ))
([c600c30 ](c600c30374 ))
* **server/mcp:** Support MCP version 2025-06-18
([#898 ](https://github.com/googleapis/genai-toolbox/issues/898 ))
([313d3ca ](313d3ca0d0 ))
* **sources/mssql:** Add support for encrypt connection parameter
([#874 ](https://github.com/googleapis/genai-toolbox/issues/874 ))
([14a868f ](14a868f2a0 ))
* **sources/firestore:** Add Firestore as Source
([#786 ](https://github.com/googleapis/genai-toolbox/issues/786 ))
([2bb790e ](2bb790e4f8 ))
* **sources/mongodb:** Add MongoDB Source
([#969 ](https://github.com/googleapis/genai-toolbox/issues/969 ))
([74dbd61 ](74dbd6124d ))
* **tools/alloydb-wait-for-operation:** Add wait for operation tool with
exponential backoff
([#920 ](https://github.com/googleapis/genai-toolbox/issues/920 ))
([3f6ec29 ](3f6ec2944e ))
* **tools/mongodb-aggregate:** Add MongoDB `aggregate` Tools
([#977 ](https://github.com/googleapis/genai-toolbox/issues/977 ))
([bd399bb ](bd399bb0fb ))
* **tools/mongodb-delete:** Add MongoDB `delete` Tools
([#974 ](https://github.com/googleapis/genai-toolbox/issues/974 ))
([78e9752 ](78e9752f62 ))
* **tools/mongodb-find:** Add MongoDB `find` Tools
([#970 ](https://github.com/googleapis/genai-toolbox/issues/970 ))
([a747475 ](a7474752d8 ))
* **tools/mongodb-insert:** Add MongoDB `insert` Tools
([#975 ](https://github.com/googleapis/genai-toolbox/issues/975 ))
([4c63f0c ](4c63f0c1e4 ))
* **tools/mongodb-update:** Add MongoDB `update` Tools
([#972 ](https://github.com/googleapis/genai-toolbox/issues/972 ))
([dfde52c ](dfde52ca9a ))
* **tools/neo4j-execute-cypher:** Add neo4j-execute-cypher for Neo4j
sources ([#946 ](https://github.com/googleapis/genai-toolbox/issues/946 ))
([81d0505 ](81d05053b2 ))
* **tools/neo4j-schema:** Add neo4j-schema tool
([#978 ](https://github.com/googleapis/genai-toolbox/issues/978 ))
([be7db3d ](be7db3dff2 ))
* **tools/wait:** Create wait for tool
([#885 ](https://github.com/googleapis/genai-toolbox/issues/885 ))
([ed5ef4c ](ed5ef4caea ))
### Bug Fixes
* Fix document preview pipeline for forked PRs
([#950 ](https://github.com/googleapis/genai-toolbox/issues/950 ))
([481cc60 ](481cc608ba ))
* **prebuilt/firestore:** Mark database field as required in the
firestore prebuilt tools
([#959 ](https://github.com/googleapis/genai-toolbox/issues/959 ))
([15417d4 ](15417d4e0c ))
* **prebuilt/cloud-sql-mssql:** Correct source reference for execute_sql
tool in cloud-sql-mssql.yaml prebuilt config
([#938 ](https://github.com/googleapis/genai-toolbox/issues/938 ))
([d16728e ](d16728e5c6 ))
* **prebuilt/cloud-sql-mysql:** Update list_table tool
([#924 ](https://github.com/googleapis/genai-toolbox/issues/924 ))
([2083ba5 ](2083ba5048 ))
* Replace 'float' with 'number' in McpManifest
([#985 ](https://github.com/googleapis/genai-toolbox/issues/985 ))
([59e23e1 ](59e23e1725 ))
* **server/api:** Add logger to context in tool invoke handler
([#891 ](https://github.com/googleapis/genai-toolbox/issues/891 ))
([8ce311f ](8ce311f256 ))
* **sources/looker:** Add agent tag to Looker API calls.
([#966 ](https://github.com/googleapis/genai-toolbox/issues/966 ))
([f55dd6f ](f55dd6fcd0 ))
* **tools/bigquery-execute-sql:** Ensure invoke always returns a
non-null value
([#925 ](https://github.com/googleapis/genai-toolbox/issues/925 ))
([9a55b80 ](9a55b80482 ))
* **tools/mysqlsql:** Unmarshal json data from database during invoke
([#979 ](https://github.com/googleapis/genai-toolbox/issues/979 ))
([ccc3498 ](ccc3498cf0 )),
closes [#840 ](https://github.com/googleapis/genai-toolbox/issues/840 )
---
This PR was generated with [Release
Please](https://github.com/googleapis/release-please ). See
[documentation](https://github.com/googleapis/release-please#release-please ).
---------
Co-authored-by: release-please[bot] <55107282+release-please[bot]@users.noreply.github.com>
Co-authored-by: Yuan Teoh <45984206+Yuan325@users.noreply.github.com >
2025-07-24 17:58:37 -07:00
Twisha Bansal
26bdba46ca
docs: add links to quickstart ( #888 )
2025-07-15 11:47:59 +05:30
Harsh Jha
65843621c5
docs: Add JS SDK quickstart ( #845 )
...
Co-authored-by: Anmol Shukla <shuklaanmol@google.com >
Co-authored-by: Twisha Bansal <58483338+twishabansal@users.noreply.github.com >
Co-authored-by: Twisha Bansal <twishabansal@google.com >
2025-07-15 01:09:18 +05:30
Harsh Jha
6d27dabfb2
docs: add optional cloud setup section for Vertex AI ( #790 )
...
Co-authored-by: Twisha Bansal <58483338+twishabansal@users.noreply.github.com >
2025-07-14 18:38:25 +05:30
release-please[bot]
2b69700c5e
chore(main): release 0.9.0 ( #789 )
...
🤖 I have created a release *beep* *boop*
---
##
[0.9.0](https://github.com/googleapis/genai-toolbox/compare/v0.8.0...v0.9.0 )
(2025-07-11)
### Features
* Dynamic reloading for toolbox config
([#800 ](https://github.com/googleapis/genai-toolbox/issues/800 ))
([4c240ac ](4c240ac3c9 ))
* **sources/mysql:** Add queryTimeout support to MySQL source
([#830 ](https://github.com/googleapis/genai-toolbox/issues/830 ))
([391cb5b ](391cb5bfe8 ))
* **tools/bigquery:** Add optional projectID parameter to bigquery tools
([#799 ](https://github.com/googleapis/genai-toolbox/issues/799 ))
([c6ab74c ](c6ab74c5da ))
### Bug Fixes
* Cleanup unassigned err log
([#857 ](https://github.com/googleapis/genai-toolbox/issues/857 ))
([c081ace ](c081ace46b ))
* Fix docs preview deployment pipeline
([#787 ](https://github.com/googleapis/genai-toolbox/issues/787 ))
([0a93b04 ](0a93b0482c ))
* **tools:** Nil parameter error when arrays are used
([#801 ](https://github.com/googleapis/genai-toolbox/issues/801 ))
([2bdcc08 ](2bdcc0841a ))
* Trigger reload on additional fsnotify operations
([#854 ](https://github.com/googleapis/genai-toolbox/issues/854 ))
([aa8dbec ](aa8dbec970 ))
---
This PR was generated with [Release
Please](https://github.com/googleapis/release-please ). See
[documentation](https://github.com/googleapis/release-please#release-please ).
---------
Co-authored-by: release-please[bot] <55107282+release-please[bot]@users.noreply.github.com>
Co-authored-by: Yuan Teoh <45984206+Yuan325@users.noreply.github.com >
2025-07-10 17:46:05 -07:00
AlexTalreja
4c240ac3c9
feat: dynamic reloading for toolbox config ( #800 )
...
Allow Toolbox server to automatically update when users modify their
tool configuration file(s), instead of requiring a restart.
This feature is automatically enabled, but can be turned off with the
flag `--disable-reload`.
2025-07-08 17:28:12 -07:00
release-please[bot]
f13e9635ba
chore(main): release 0.8.0 ( #689 )
...
🤖 I have created a release *beep* *boop*
---
##
[0.8.0](https://github.com/googleapis/genai-toolbox/compare/v0.7.0...v0.8.0 )
(2025-07-02)
### ⚠ BREAKING CHANGES
* **postgres,mssql,cloudsqlmssql:** encode source connection url for
sources ([#727 ](https://github.com/googleapis/genai-toolbox/issues/727 ))
### Features
* Add support for multiple YAML configuration files
([#760 ](https://github.com/googleapis/genai-toolbox/issues/760 ))
([40679d7 ](40679d700e ))
* Add support for optional parameters
([#617 ](https://github.com/googleapis/genai-toolbox/issues/617 ))
([4827771 ](4827771b78 )),
closes [#475 ](https://github.com/googleapis/genai-toolbox/issues/475 )
* **mcp:** Support MCP version 2025-03-26
([#755 ](https://github.com/googleapis/genai-toolbox/issues/755 ))
([474df57 ](474df57d62 ))
* **sources/http:** Support disable SSL verification for HTTP Source
([#674 ](https://github.com/googleapis/genai-toolbox/issues/674 ))
([4055b0c ](4055b0c356 ))
* **tools/bigquery:** Add templateParameters field for bigquery
([#699 ](https://github.com/googleapis/genai-toolbox/issues/699 ))
([f5f771b ](f5f771b0f3 ))
* **tools/bigtable:** Add templateParameters field for bigtable
([#692 ](https://github.com/googleapis/genai-toolbox/issues/692 ))
([1c06771 ](1c067715fa ))
* **tools/couchbase:** Add templateParameters field for couchbase
([#723 ](https://github.com/googleapis/genai-toolbox/issues/723 ))
([9197186 ](9197186b8b ))
* **tools/http:** Add support for HTTP Tool pathParams
([#726 ](https://github.com/googleapis/genai-toolbox/issues/726 ))
([fd300dc ](fd300dc606 ))
* **tools/redis:** Add Redis Source and Tool
([#519 ](https://github.com/googleapis/genai-toolbox/issues/519 ))
([f0aef29 ](f0aef29b0c ))
* **tools/spanner:** Add templateParameters field for spanner
([#691 ](https://github.com/googleapis/genai-toolbox/issues/691 ))
([075dfa4 ](075dfa47e1 ))
* **tools/sqlitesql:** Add templateParameters field for sqlitesql
([#687 ](https://github.com/googleapis/genai-toolbox/issues/687 ))
([75e254c ](75e254c0a4 ))
* **tools/valkey:** Add Valkey Source and Tool
([#532 ](https://github.com/googleapis/genai-toolbox/issues/532 ))
([054ec19 ](054ec198b9 ))
### Bug Fixes
* **bigquery,mssql:** Fix panic on tools with array param
([#722 ](https://github.com/googleapis/genai-toolbox/issues/722 ))
([7a6644c ](7a6644cf0c ))
* **postgres,mssql,cloudsqlmssql:** Encode source connection url for
sources ([#727 ](https://github.com/googleapis/genai-toolbox/issues/727 ))
([67964d9 ](67964d939f )),
closes [#717 ](https://github.com/googleapis/genai-toolbox/issues/717 )
* Set default value to field's type during unmarshalling
([#774 ](https://github.com/googleapis/genai-toolbox/issues/774 ))
([fafed24 ](fafed24858 )),
closes [#771 ](https://github.com/googleapis/genai-toolbox/issues/771 )
* **server/mcp:** Do not listen from port for stdio
([#719 ](https://github.com/googleapis/genai-toolbox/issues/719 ))
([d51dbc7 ](d51dbc759b )),
closes [#711 ](https://github.com/googleapis/genai-toolbox/issues/711 )
* **tools/mysqlexecutesql:** Handle nil panic and connection leak in
Invoke ([#757 ](https://github.com/googleapis/genai-toolbox/issues/757 ))
([7badba4 ](7badba42ee ))
* **tools/mysqlsql:** Handle nil panic and connection leak in invoke
([#758 ](https://github.com/googleapis/genai-toolbox/issues/758 ))
([cbb4a33 ](cbb4a33351 ))
---
This PR was generated with [Release
Please](https://github.com/googleapis/release-please ). See
[documentation](https://github.com/googleapis/release-please#release-please ).
---------
Co-authored-by: release-please[bot] <55107282+release-please[bot]@users.noreply.github.com>
Co-authored-by: Yuan <45984206+Yuan325@users.noreply.github.com >
2025-07-02 09:30:33 -06:00
Yuan
c7fe3c7f38
docs: fix linting in docs ( #749 )
...
Fix long lines and table column width lints in docs.
2025-06-25 17:03:42 +00:00
Twisha Bansal
d8e2abe2dd
fix: fix adk quickstart ( #741 )
2025-06-24 12:04:11 +05:30
Twisha Bansal
7b3539e9ff
chore: reorder quickstart ( #740 )
...
Reorder quickstart.
Order from
`GoogleGenAI -> ADK -> Langchain -> Llamaindex`
to
`ADK -> Langchain -> Llamaindex -> GoogleGenAI`
2025-06-24 11:55:01 +05:30
release-please[bot]
714d990c34
chore(main): release 0.7.0 ( #640 )
...
🤖 I have created a release *beep* *boop*
---
##
[0.7.0](https://github.com/googleapis/genai-toolbox/compare/v0.6.0...v0.7.0 )
(2025-06-10)
### Features
* Add templateParameters field for mssqlsql
([#671 ](https://github.com/googleapis/genai-toolbox/issues/671 ))
([b81fc6a ](b81fc6aa6c ))
* Add templateParameters field for mysqlsql
([#663 ](https://github.com/googleapis/genai-toolbox/issues/663 ))
([0a08d2c ](0a08d2c15d ))
* **metrics:** Add user agent for prebuilt tools
([#669 ](https://github.com/googleapis/genai-toolbox/issues/669 ))
([29aa0a7 ](29aa0a70da ))
* **tools/postgressql:** Add templateParameters field
([#615 ](https://github.com/googleapis/genai-toolbox/issues/615 ))
([b763469 ](b76346993f ))
### Bug Fixes
* Improve versionString
([#658 ](https://github.com/googleapis/genai-toolbox/issues/658 ))
([cf96f4c ](cf96f4c249 ))
* **server/stdio:** Notifications should not return a response
([#638 ](https://github.com/googleapis/genai-toolbox/issues/638 ))
([69d047a ](69d047af46 ))
* **tools/mysqlsql:** Handled the null value for string case in mysqlsql
tools ([#641 ](https://github.com/googleapis/genai-toolbox/issues/641 ))
([ef94648 ](ef94648455 ))
* Update path library
([#678 ](https://github.com/googleapis/genai-toolbox/issues/678 ))
([4998f82 ](4998f82852 )),
closes [#662 ](https://github.com/googleapis/genai-toolbox/issues/662 )
---
This PR was generated with [Release
Please](https://github.com/googleapis/release-please ). See
[documentation](https://github.com/googleapis/release-please#release-please ).
Co-authored-by: release-please[bot] <55107282+release-please[bot]@users.noreply.github.com>
2025-06-09 17:15:26 -07:00
Twisha Bansal
4700dd363c
docs: update to latest stable gemini models ( #633 )
...
Update to the latest Stable gemini models. See the [latest stable models
list](https://cloud.google.com/vertex-ai/generative-ai/docs/learn/model-versions#latest-stable ).
Closes https://github.com/googleapis/genai-toolbox/issues/518
2025-06-02 10:40:52 +05:30
release-please[bot]
3180830403
chore(main): release 0.6.0 ( #545 )
...
🤖 I have created a release *beep* *boop*
---
##
[0.6.0](https://github.com/googleapis/genai-toolbox/compare/v0.5.0...v0.6.0 )
(2025-05-28)
### Features
* Add Execute sql tool for SQL Server(MSSQL)
([#585 ](https://github.com/googleapis/genai-toolbox/issues/585 ))
([6083a22 ](6083a224aa ))
* Add mysql-execute-sql tool
([#577 ](https://github.com/googleapis/genai-toolbox/issues/577 ))
([8590061 ](8590061ae4 ))
* Add new BigQuery tools: execute_sql, list_datatset_ids,
list_table_ids, get_dataset_info, get_table_info
([0fd88b5 ](0fd88b574b ))
* Add spanner-execute-sql tool
([#576 ](https://github.com/googleapis/genai-toolbox/issues/576 ))
([d65747a ](d65747a2dc ))
* Add support for read-only in Spanner tool
([#563 ](https://github.com/googleapis/genai-toolbox/issues/563 ))
([6512704 ](6512704e77 ))
* Adding support for the --prebuilt flag
([#604 ](https://github.com/googleapis/genai-toolbox/issues/604 ))
([a29c800 ](a29c80012e ))
* Support MCP stdio transport protocol
([#607 ](https://github.com/googleapis/genai-toolbox/issues/607 ))
([1702ce1 ](1702ce1e00 ))
### Bug Fixes
* Explicitly set query location for BigQuery queries
([#586 ](https://github.com/googleapis/genai-toolbox/issues/586 ))
([eb52b66 ](eb52b66d82 ))
* Fix spellings in comments
([#561 ](https://github.com/googleapis/genai-toolbox/issues/561 ))
([b58bf76 ](b58bf76dda ))
* Prevent tool calls through MCP when auth is required
([#544 ](https://github.com/googleapis/genai-toolbox/issues/544 ))
([e747b6e ](e747b6e289 ))
* Reinitialize required slice if nil
([#571 ](https://github.com/googleapis/genai-toolbox/issues/571 ))
([04dcf47 ](04dcf47912 )),
closes [#564 ](https://github.com/googleapis/genai-toolbox/issues/564 )
---
This PR was generated with [Release
Please](https://github.com/googleapis/release-please ). See
[documentation](https://github.com/googleapis/release-please#release-please ).
Co-authored-by: release-please[bot] <55107282+release-please[bot]@users.noreply.github.com>
2025-05-28 15:08:44 -07:00
Anubhav Dhawan
22edbea579
docs: Update docs to guide with proper lifecycle management ( #606 )
...
Fixes
[#208 ](https://github.com/googleapis/mcp-toolbox-sdk-python/issues/208 )
2025-05-26 20:12:53 +05:30
Jack Wotherspoon
0c07e15c2c
docs: update ADK samples to use toolbox-core ( #584 )
...
`ToolboxTool` has been removed from `google-adk` package in
11ca528090
Instead `toolbox-core` should be used directly to remove the need for a
dependency on `toolbox-langchain` and `langchain`.
The new recommendation is to install `toolbox-core`.
```shell
pip install toolbox-core
```
And then load toolbox tools directly and pass it to the ADK agent.
```python
from google.adk.agents import Agent
# NEW IMPORT
from toolbox_core import ToolboxSyncClient
# Full control over MCP Toolbox
toolbox_client = ToolboxSyncClient("http://127.0.0.1:5000 ")
toolbox_tools = toolbox_client.load_toolset("my-toolset")
root_agent = Agent(
model="gemini-2.0-flash",
name="root_agent",
instruction=agent_instruction,
# Add Toolbox tools to ADK agent
tools=toolbox_tools,
)
```
2025-05-20 17:44:50 +00:00
AlexTalreja
e8e0125eaa
docs: fix typo and import in local quickstart ( #565 )
2025-05-14 16:58:37 -07:00
release-please[bot]
9a5d76e2dc
chore(main): release 0.5.0 ( #484 )
...
🤖 I have created a release *beep* *boop*
---
##
[0.5.0](https://github.com/googleapis/genai-toolbox/compare/v0.4.0...v0.5.0 )
(2025-05-06)
### Features
* Add Couchbase as Source and Tool
([#307 ](https://github.com/googleapis/genai-toolbox/issues/307 ))
([d7390b0 ](d7390b06b7 ))
* Add postgres-execute-sql tool
([#490 ](https://github.com/googleapis/genai-toolbox/issues/490 ))
([11ea7bc ](11ea7bc584 ))
### Bug Fixes
* **deps:** Update module cloud.google.com/go/cloudsqlconn to v1.17.0
([#500 ](https://github.com/googleapis/genai-toolbox/issues/500 ))
([ad040cf ](ad040cfb8b ))
* **deps:** Update module cloud.google.com/go/spanner to v1.80.0
([#481 ](https://github.com/googleapis/genai-toolbox/issues/481 ))
([1e1348f ](1e1348f5f0 ))
* **deps:** Update module google.golang.org/api to v0.231.0
([#505 ](https://github.com/googleapis/genai-toolbox/issues/505 ))
([50ec7f4 ](50ec7f4a06 ))
---
This PR was generated with [Release
Please](https://github.com/googleapis/release-please ). See
[documentation](https://github.com/googleapis/release-please#release-please ).
---------
Co-authored-by: release-please[bot] <55107282+release-please[bot]@users.noreply.github.com>
Co-authored-by: Yuan <45984206+Yuan325@users.noreply.github.com >
Co-authored-by: Yuan Teoh <yuanteoh@google.com >
2025-05-06 16:32:01 -06:00
Anubhav Dhawan
1dce40fc26
docs: Bump Toolbox version in Colab Quickstart + fix typo ( #533 )
2025-05-06 16:51:52 +05:30
Anubhav Dhawan
717f43420a
docs: Address connection issues in local quickstart with clearer guidance ( #520 )
...
Fix for #517
This PR improves the Local Quickstart guide by adding troubleshooting
advice for common PostgreSQL connection issues in [step
1](https://googleapis.github.io/genai-toolbox/getting-started/local_quickstart/#step-1-set-up-your-database ).
This reduces friction and improves the setup experience for users
following the local quickstart by addressing feedback in #517 regarding
difficulties in the initial database connection step.
### Problem
Users faced issues like password prompts or "role 'postgres' does not
exist" errors when trying to connect to PostgreSQL with `psql -h
127.0.0.1 -U postgres`.
### Solution
This PR adds a notice that provides solutions for common connection
errors, including guidance on using `sudo -i -u postgres` for peer
authentication.
---------
Co-authored-by: Averi Kitsch <akitsch@google.com >
2025-05-06 11:24:59 +05:30
Jack Wotherspoon
c7189e9fcf
docs: use --tools-file over deprecated --tools_file ( #524 )
...
Updating docs to use the `--tools-file` flag over the now deprecated
`--tools_file`.
The new flag was added as of `v0.3.0` in #384
This change reduces confusion as current usage in docs results in
following message on startup of Toolbox server:
```sh
Flag --tools_file has been deprecated, please use --tools-file instead
```
Fixes #514
---------
Co-authored-by: Yuan <45984206+Yuan325@users.noreply.github.com >
2025-05-05 16:16:40 +00:00
release-please[bot]
4ed16ccd18
chore(main): release 0.4.0 ( #411 )
...
🤖 I have created a release *beep* *boop*
---
##
[0.4.0](https://github.com/googleapis/genai-toolbox/compare/v0.3.0...v0.4.0 )
(2025-04-23)
### Features
* Add `AuthRequired` to Neo4j & Dgraph Tools
([#434 ](https://github.com/googleapis/genai-toolbox/issues/434 ))
([afbf4b2 ](afbf4b2dae ))
* Add `AuthRequired` to tool manifest
([#433 ](https://github.com/googleapis/genai-toolbox/issues/433 ))
([d9388ad ](d9388ad57e ))
* Add BigQuery source and tool
([#463 ](https://github.com/googleapis/genai-toolbox/issues/463 ))
([8055aa5 ](8055aa519f ))
* Add Bigtable source and tool
([#418 ](https://github.com/googleapis/genai-toolbox/issues/418 ))
([ae53b8e ](ae53b8eeff ))
* Add IAM AuthN to AlloyDB Source
([#399 ](https://github.com/googleapis/genai-toolbox/issues/399 ))
([e8ed447 ](e8ed447d91 ))
* Add IAM AuthN to Cloud SQL Sources
([#414 ](https://github.com/googleapis/genai-toolbox/issues/414 ))
([be85b82 ](be85b82078 ))
* Add toolset feature to mcp
([#425 ](https://github.com/googleapis/genai-toolbox/issues/425 ))
([e307857 ](e307857085 )),
closes [#403 ](https://github.com/googleapis/genai-toolbox/issues/403 )
* Add SQLite source and tool
([#438 ](https://github.com/googleapis/genai-toolbox/issues/438 ))
([fc14cbf ](fc14cbfd07 ))
* Support env replacement for tools.yaml
([#462 ](https://github.com/googleapis/genai-toolbox/issues/462 ))
([eadb678 ](eadb678a7b ))
### Bug Fixes
* [#419 ](https://github.com/googleapis/genai-toolbox/issues/419 ) TLS
https URL for SSE endpoint
([#420 ](https://github.com/googleapis/genai-toolbox/issues/420 ))
([0a7d3ff ](0a7d3ff06b ))
* **docs:** Fix link 'Edit this page'
([#454 ](https://github.com/googleapis/genai-toolbox/issues/454 ))
([969065e ](969065e561 )),
closes [#427 ](https://github.com/googleapis/genai-toolbox/issues/427 )
* Update http error code from invocation
([#468 ](https://github.com/googleapis/genai-toolbox/issues/468 ))
([ff7c0ff ](ff7c0ffc65 )),
closes [#465 ](https://github.com/googleapis/genai-toolbox/issues/465 )
---
This PR was generated with [Release
Please](https://github.com/googleapis/release-please ). See
[documentation](https://github.com/googleapis/release-please#release-please ).
---------
Co-authored-by: release-please[bot] <55107282+release-please[bot]@users.noreply.github.com>
Co-authored-by: Wenxin Du <117315983+duwenxin99@users.noreply.github.com >
Co-authored-by: Kurtis Van Gent <31518063+kurtisvg@users.noreply.github.com >
2025-04-23 13:22:25 -04:00
Wenxin Du
eadb678a7b
feat: Support env replacement for tool.yaml ( #462 )
...
Environment variable replacement is needed so that users don't have to
hardcode their secrets in configuring `tools.yaml`.
Both formats `$ENV_NAME` and `${ENV_NAME}` are standard ways to declare
an environment variable.
However, some database statement placeholders that are already using the
`$ENV_NAME` format.
Therefore, we only support env var declaration using `${ENV_NAME}` to
disambiguate it from other usages.
Fixes issue: https://github.com/googleapis/genai-toolbox/issues/431
2025-04-23 07:33:02 -04:00
Twisha Bansal
2c3f00c0cd
docs: better response messages for ADK agent ( #460 )
2025-04-21 19:41:46 +05:30
Twisha Bansal
71132d05d2
docs: add ADK in quickstart intro ( #458 )
2025-04-21 18:02:23 +05:30
F. Hinkelmann
c4de4be044
docs: add ADK to local quickstart ( #439 )
...
Add ADK to the local quickstart.
---------
Co-authored-by: Twisha Bansal <58483338+twishabansal@users.noreply.github.com >
2025-04-21 06:24:31 +00:00
Twisha Bansal
f232e5387e
docs: make quickstart async-first ( #421 )
2025-04-10 17:00:48 +05:30
Twisha Bansal
f1ca030038
docs: Modify quickstart introduction ( #429 )
2025-04-10 14:07:19 +05:30
Twisha Bansal
7ea3c904ce
docs: Add a toolbox-core quickstart ( #407 )
...
Co-authored-by: Anubhav Dhawan <anubhavdhawan@google.com >
2025-04-10 05:05:57 +00:00
release-please[bot]
12222fe27a
chore(main): release 0.3.0 ( #382 )
...
🤖 I have created a release *beep* *boop*
---
##
[0.3.0](https://github.com/googleapis/genai-toolbox/compare/v0.2.1...v0.3.0 )
(2025-04-04)
### Features
* Add 'alloydb-ai-nl' tool
([#358 ](https://github.com/googleapis/genai-toolbox/issues/358 ))
([f02885f ](f02885fd4a ))
* Add HTTP Source and Tool
([#332 ](https://github.com/googleapis/genai-toolbox/issues/332 ))
([64da5b4 ](64da5b4efe ))
* Adding support for Model Context Protocol (MCP).
([#396 ](https://github.com/googleapis/genai-toolbox/issues/396 ))
([a7d1d4e ](a7d1d4eb2a ))
* Added [toolbox-core](https://pypi.org/project/toolbox-core/ ) SDK –
easily integrate Toolbox into any Python function calling framework
### Bug Fixes
* Add `tools-file` flag and deprecate `tools_file`
([#384 ](https://github.com/googleapis/genai-toolbox/issues/384 ))
([34a7263 ](34a7263fdc )),
closes [#383 ](https://github.com/googleapis/genai-toolbox/issues/383 )
---
This PR was generated with [Release
Please](https://github.com/googleapis/release-please ). See
[documentation](https://github.com/googleapis/release-please#release-please ).
---------
Co-authored-by: release-please[bot] <55107282+release-please[bot]@users.noreply.github.com>
Co-authored-by: Kurtis Van Gent <31518063+kurtisvg@users.noreply.github.com >
2025-04-04 11:51:23 -07:00
Yuan
a7d1d4eb2a
feat: adding support for Model Context Protocol (MCP). ( #396 )
...
Adding Toolbox support for MCP. Toolbox can now be run as an MCP server.
Fixes #312 .
---------
Co-authored-by: Jack Wotherspoon <jackwoth@google.com >
Co-authored-by: Kurtis Van Gent <31518063+kurtisvg@users.noreply.github.com >
Co-authored-by: Averi Kitsch <akitsch@google.com >
2025-04-04 18:24:34 +00:00
Twisha Bansal
38cf4c02be
docs: fix open quickstart in colab link ( #359 )
2025-04-01 13:53:06 +05:30
Twisha Bansal
0a19ac7c3b
docs: add colab quickstart ( #349 )
2025-03-30 09:48:43 -06:00
Twisha Bansal
a3ab38539c
docs: Adopted a generic terminology for agents ( #351 )
2025-03-27 08:31:32 -06:00
Twisha Bansal
0423bdb045
docs: Added tip for using toolbox from colab ( #352 )
2025-03-27 10:27:10 +05:30
Twisha Bansal
48ed9399b1
chore: change to template project id ( #345 )
2025-03-24 12:48:49 +05:30