wehub/googleapis--mcp-toolbox
1
0
Fork 0
Code Issues Pull Requests Actions Deployments Models Agent Notes Packages Projects Releases Wiki Activity

chore: import upstream snapshot with attribution
CF: Deploy Dev Docs / deploy (push) Has been cancelled
Details
Sync Labels / build (push) Has been cancelled
Details
tests / unit tests (macos-latest) (push) Has been cancelled
Details
tests / unit tests (windows-latest) (push) Has been cancelled
Details
tests / unit tests (ubuntu-latest) (push) Has been cancelled
Details

Browse Source
This commit is contained in:
wehub-resource-sync
2026-07-13 13:32:45 +08:00
commit e04ed9c211
1798 changed files with 307905 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/en/integrations/cloud-sql-pg/tools/_index.md
+7
View File
@@ -0,0 +1,7 @@
---
title: "Tools"
weight: 2
shared_tools:
- source: "/integrations/postgres/tools"
header: "Postgres Tools"
---
docs/en/integrations/cloud-sql-pg/tools/vector-assist-apply-spec.md
+59
View File
@@ -0,0 +1,59 @@
---
title: "vector-assist-apply-spec"
type: docs
weight: 1
description: >
The "vector-assist-apply-spec" tool automatically executes all SQL recommendations
associated with a specific vector specification or table to finalize the
vector search setup.
---
## About
The `vector-assist-apply-spec` tool automatically executes all the SQL recommendations associated with a specific vector specification (spec_id) or table. It runs the necessary commands in the correct sequence to provision the workload, marking each step as applied once successful.
Use this tool when the user has reviewed the generated recommendations from a defined (or modified) spec and is ready to apply the changes directly to their database instance to finalize the vector search setup. Under the hood, this tool connects to the target database and executes the `vector_assist.apply_spec` function.
## Compatible Sources
{{< compatible-sources >}}
## Requirements
{{< notice tip >}}
Ensure that your target PostgreSQL database has the required `vector_assist` extension installed, in order for this tool to execute successfully.
{{< /notice >}}
## Parameters
The tool takes the following input parameters:
| Parameter | Type | Description | Required |
| :------------ | :----- | :-------------------------------------------------------------------- | :------- |
| `spec_id` | string | Unique ID of the vector specification to apply. | No |
| `table_name` | string | Target table name for applying the vector specification. | No |
| `column_name` | string | Text or vector column name to uniquely identify the specification. | No |
| `schema_name` | string | Schema name for the target table. | No |
> Note
> Parameters are marked as required or optional based on the vector assist function definitions.
> The function may perform further validation on optional parameters to ensure all necessary
> data is available before returning a response.
## Example
```yaml
kind: tool
name: apply_spec
type: vector-assist-apply-spec
source: my-database-source
description: "This tool automatically executes all the SQL recommendations associated with a specific vector specification (spec_id) or table. It runs the necessary commands in the correct sequence to provision the workload, marking each step as applied once successful. Use this tool when the user has reviewed the generated recommendations from a defined (or modified) spec and is ready to apply the changes directly to their database instance to finalize the vector search setup."
```
## Reference
| **field** | **type** | **required** | **description** |
|-------------|:--------:|:------------:|------------------------------------------------------|
| type | string | true | Must be "vector-assist-apply-spec". |
| source | string | true | Name of the source the SQL should execute on. |
| description | string | false | Description of the tool that is passed to the agent. |
docs/en/integrations/cloud-sql-pg/tools/vector-assist-define-spec.md
+73
View File
@@ -0,0 +1,73 @@
---
title: "vector-assist-define-spec"
type: docs
weight: 1
description: >
The "vector-assist-define-spec" tool defines a new vector specification by
capturing the user's intent and requirements for a vector search workload,
generating SQL recommendations for setting up database, embeddings, and
vector indexes.
---
## About
The `vector-assist-define-spec` tool defines a new vector specification by capturing the user's intent and requirements for a vector search workload. It generates a complete, ordered set of SQL recommendations required to set up the database, embeddings, and vector indexes.
Use this tool at the very beginning of the vector setup process when an agent or user first wants to configure a table for vector search, generate embeddings, or create a new vector index. Under the hood, this tool connects to the target database and executes the `vector_assist.define_spec` function to generate the necessary specifications.
## Compatible Sources
{{< compatible-sources >}}
## Requirements
{{< notice tip >}}
Ensure that your target PostgreSQL database has the required `vector_assist` extension installed, in order for this tool to execute successfully.
{{< /notice >}}
## Parameters
The tool takes the following input parameters:
| Parameter | Type | Description | Required |
| :----------------------- | :------ | :--------------------------------------------------------------------- | :------- |
| `table_name` | string | Target table name for setting up the vector workload. | Yes |
| `schema_name` | string | Name of the schema containing the target table. | No |
| `spec_id` | string | Unique ID for the vector specification; auto-generated if omitted. | No |
| `vector_column_name` | string | Name of the column containing the vector embeddings. | No |
| `text_column_name` | string | Name of the text column for setting up vector search. | No |
| `vector_index_type` | string | Type of vector index ('hnsw', 'ivfflat', or 'scann'). | No |
| `embeddings_available` | boolean | Indicates if vector embeddings already exist in the table. | No |
| `num_vectors` | integer | Expected total number of vectors in the dataset. | No |
| `dimensionality` | integer | Dimension of existing vectors or the chosen embedding model. | No |
| `embedding_model` | string | Model to be used for generating vector embeddings. | No |
| `prefilter_column_names` | array | List of columns to use for prefiltering vector queries. | No |
| `distance_func` | string | Distance function for comparing vectors ('cosine', 'ip', 'l2', 'l1'). | No |
| `quantization` | string | Quantization method for vector indexes ('none', 'halfvec', 'bit'). | No |
| `memory_budget_kb` | integer | Maximum memory (in KB) the index can use during build. | No |
| `target_recall` | float | Target recall rate for standard vector queries using this index. | No |
| `target_top_k` | integer | Number of top results (top-K) to retrieve per query. | No |
| `tune_vector_index` | boolean | Indicates whether automatic tuning is required for the index. | No |
> Note
> Parameters are marked as required or optional based on the vector assist function definitions.
> The function may perform further validation on optional parameters to ensure all necessary
> data is available before returning a response.
## Example
```yaml
kind: tool
name: define_spec
type: vector-assist-define-spec
source: my-database-source
description: "This tool defines a new vector specification by capturing the user's intent and requirements for a vector search workload. This generates a complete, ordered set of SQL recommendations required to set up the database, embeddings, and vector indexes. Use this tool at the very beginning of the vector setup process when a user first wants to configure a table for vector search, generate embeddings, or create a new vector index."
```
## Reference
| **field** | **type** | **required** | **description** |
|-------------|:--------:|:------------:|------------------------------------------------------|
| type | string | true | Must be "vector-assist-define-spec". |
| source | string | true | Name of the source the SQL should execute on. |
| description | string | false | Description of the tool that is passed to the agent. |
docs/en/integrations/cloud-sql-pg/tools/vector-assist-delete-spec.md
+54
View File
@@ -0,0 +1,54 @@
---
title: "vector-assist-delete-spec"
type: docs
weight: 1
description: >
The "vector-assist-delete-spec" tool deletes an existing vector specification and its associated metadata using its spec_id.
---
## About
The `vector-assist-delete-spec` tool deletes an existing vector specification using its `spec_id`.
Use this tool when a user explicitly requests to delete, remove, or clean up an existing vector specification which was created in the context of the vector assist tools. Under the hood, this tool connects to the target database and executes the `vector_assist.delete_spec` function.
## Compatible Sources
{{< compatible-sources >}}
## Requirements
{{< notice tip >}}
Ensure that your target PostgreSQL database has the required `vector_assist` extension installed, in order for this tool to execute successfully.
{{< /notice >}}
## Parameters
The tool takes the following input parameters:
| Parameter | Type | Description | Required |
| :-------- | :----- | :----------------------------------------- | :------- |
| `spec_id` | string | Unique ID for the vector spec to delete. | Yes |
> Note :
> Parameters are marked as required or optional based on the tool's parameter definitions.
> The underlying function may perform further validation on optional parameters to ensure
> all necessary data is available before returning a response.
## Example
```yaml
kind: tool
name: delete_spec
type: vector-assist-delete-spec
source: my-database-source
description: "This tool deletes an existing vector specification using its spec_id. Use this tool when a user explicitly requests to delete, remove, or clean up an existing vector specification which was created in the context of the vector assist tools."
```
## Reference
| **field** | **type** | **required** | **description** |
|-------------|:--------:|:------------:|------------------------------------------------------|
| type | string | true | Must be "vector-assist-delete-spec". |
| source | string | true | Name of the source the SQL should execute on. |
| description | string | false | Description of the tool that is passed to the agent. |
docs/en/integrations/cloud-sql-pg/tools/vector-assist-generate-query.md
+65
View File
@@ -0,0 +1,65 @@
---
title: "vector-assist-generate-query"
type: docs
weight: 1
description: >
The "vector-assist-generate-query" tool produces optimized SQL queries for
vector search, leveraging metadata and specifications to enable semantic
and similarity searches.
---
## About
The `vector-assist-generate-query` tool generates optimized SQL queries for vector search by leveraging the metadata and vector specifications defined in a specific spec_id. It serves as the primary actionable tool for generating the executable SQL required to retrieve relevant results based on vector similarity.
The tool contextually understands requirements such as distance functions, quantization, and filtering to ensure the resulting query is compatible with the corresponding vector index. Additionally, it can automatically handle iterative index scans for filtered queries and calculate the necessary search parameters (like ef_search) to meet a target recall.
## Compatible Sources
{{< compatible-sources >}}
## Requirements
{{< notice tip >}}
Ensure that your target PostgreSQL database has the required `vector_assist` extension installed, in order for this tool to execute successfully.
{{< /notice >}}
## Parameters
The tool takes the following input parameters:
| Parameter | Type | Description | Required |
| :----------------------- | :------ | :------------------------------------------------------------------ | :------- |
| `spec_id` | string | Unique ID of the vector spec for query generation. | No |
| `table_name` | string | Target table name for generating the vector query. | No |
| `schema_name` | string | Schema name for the query's target table. | No |
| `column_name` | string | Text or vector column name identifying the specific spec. | No |
| `search_text` | string | Text string to search for; embeddings are auto-generated. | No |
| `search_vector` | string | Vector to search for; use instead of search_text. | No |
| `output_column_names` | array | List of columns to retrieve in the search results. | No |
| `top_k` | integer | Number of nearest neighbors to return (defaults to 10). | No |
| `filter_expressions` | array | List of filter expressions applied to the vector query. | No |
| `target_recall` | float | Target recall rate, overriding the spec-level default. | No |
| `iterative_index_search` | boolean | Enables iterative search for filtered queries to guarantee results. | No |
> Note
> Parameters are marked as required or optional based on the vector assist function definitions.
> The function may perform further validation on optional parameters to ensure all necessary
> data is available before returning a response.
## Example
```yaml
kind: tool
name: generate_query
type: vector-assist-generate-query
source: my-database-source
description: "This tool generates optimized SQL queries for vector search by leveraging the metadata and vector specifications defined in a specific spec_id. It may return a single query or a sequence of multiple SQL queries that can be executed sequentially. Use this tool when a user wants to perform semantic or similarity searches on their data. It serves as the primary actionable tool to invoke for generating the executable SQL required to retrieve relevant results based on vector similarity."
```
## Reference
| **field** | **type** | **required** | **description** |
|-------------|:--------:|:------------:|------------------------------------------------------|
| type | string | true | Must be "vector-assist-generate-query". |
| source | string | true | Name of the source the SQL should execute on. |
| description | string | false | Description of the tool that is passed to the agent. |
docs/en/integrations/cloud-sql-pg/tools/vector-assist-get-spec.md
+54
View File
@@ -0,0 +1,54 @@
---
title: "vector-assist-get-spec"
type: docs
weight: 1
description: >
The "vector-assist-get-spec" tool retrieves the details of an existing vector specification using its unique spec_id.
---
## About
The `vector-assist-get-spec` tool retrieves the details of an existing vector specification using its unique `spec_id`.
Use this tool to retrieve a vector specification which was created in the context of the vector assist tools. It allows users to inspect the detailed parameters and current state of a particular vector setup. Under the hood, this tool connects to the target database and executes the `vector_assist.get_spec` function.
## Compatible Sources
{{< compatible-sources >}}
## Requirements
{{< notice tip >}}
Ensure that your target PostgreSQL database has the required `vector_assist` extension installed, in order for this tool to execute successfully.
{{< /notice >}}
## Parameters
The tool takes the following input parameters:
| Parameter | Type | Description | Required |
| :-------- | :----- | :------------------------------- | :------- |
| `spec_id` | string | Unique ID for the vector spec. | Yes |
> Note :
> Parameters are marked as required or optional based on the tool's parameter definitions.
> The underlying function may perform further validation on optional parameters to ensure
> all necessary data is available before returning a response.
## Example
```yaml
kind: tool
name: get_spec
type: vector-assist-get-spec
source: my-database-source
description: "This tool retrieves the details of an existing vector specification using its unique 'spec_id'. Use this tool to retrieve a vector specification which was created in the context of the vector assist tools."
```
## Reference
| **field** | **type** | **required** | **description** |
|-------------|:--------:|:------------:|------------------------------------------------------|
| type | string | true | Must be "vector-assist-get-spec". |
| source | string | true | Name of the source the SQL should execute on. |
| description | string | false | Description of the tool that is passed to the agent. |
docs/en/integrations/cloud-sql-pg/tools/vector-assist-improve-query-recall.md
+60
View File
@@ -0,0 +1,60 @@
---
title: "vector-assist-improve-query-recall"
type: docs
weight: 1
description: >
The "vector-assist-improve-query-recall" tool generates SQL recommendations to improve search accuracy for users experiencing degraded recall.
---
## About
The `vector-assist-improve-query-recall` tool is designed to troubleshoot and optimize existing vector search workloads when a user reports irrelevant results, poor accuracy, or degraded recall.
It determines the optimal tuning parameter (such as `hnsw.ef_search`) for an active vector index to improve the search results. The tool evaluates the target recall and outputs an actionable SQL query recommendation (e.g., `SET hnsw.ef_search TO ...`) that must be executed as a next action using the `execute_sql` tool.
## Compatible Sources
{{< compatible-sources >}}
## Requirements
{{< notice tip >}}
Ensure that your target PostgreSQL database has the required `vector_assist` extension installed. This tool requires an existing HNSW index to function properly; if the table lacks an existing vector setup, use the `define_spec` tool instead.
{{< /notice >}}
## Parameters
The tool takes the following input parameters:
| Parameter | Type | Description | Required |
| :------------------- | :------ | :-------------------------------------------------------------------------- | :------- |
| `table_name` | string | Table name experiencing degraded vector search recall. | Yes |
| `vector_column_name` | string | Column name containing the vector embeddings. | Yes |
| `index_name` | string | Name of the vector index to tune. | Yes |
| `schema_name` | string | Schema name of the table (default is `public`). | No |
| `top_k` | integer | Top k value for the vector search (default is `10`). | No |
| `target_recall` | float | Target recall value for search results (default is `0.95`). | No |
| `distance_func` | string | Distance function used for the vector search similarity (default is `cosine`).| No |
> Note :
> Parameters are marked as required or optional based on the tool's parameter definitions.
> The underlying function may perform further validation on optional parameters to ensure
> all necessary data is available before returning a response.
## Example
```yaml
kind: tool
name: improve_query_recall
type: vector-assist-improve-query-recall
source: my-database-source
description: "Use this tool to troubleshoot and optimize existing vector search workloads when a user reports irrelevant results, poor accuracy, or degraded recall. It determines the optimal tuning parameter (such as ef_search) for an active vector index to improve the search results. The tool outputs an actionable SQL query recommendation to be executed as a next action using the 'execute_sql' tool."
```
## Reference
| **field** | **type** | **required** | **description** |
|-------------|:--------:|:------------:|------------------------------------------------------|
| type | string | true | Must be "vector-assist-improve-query-recall". |
| source | string | true | Name of the source the SQL should execute on. |
| description | string | false | Description of the tool that is passed to the agent. |
docs/en/integrations/cloud-sql-pg/tools/vector-assist-list-specs.md
+55
View File
@@ -0,0 +1,55 @@
---
title: "vector-assist-list-specs"
type: docs
weight: 1
description: >
The "vector-assist-list-specs" tool retrieves a list of all defined vector specifications for a given table and column.
---
## About
The `vector-assist-list-specs` tool lists all defined vector specifications for a given table and column name.
Use this tool to list vector specifications which were created in the context of the vector assist tools. It provides a high-level overview of existing vector setups. Under the hood, this tool connects to the target database and executes the `vector_assist.list_specs` function.
## Compatible Sources
{{< compatible-sources >}}
## Requirements
{{< notice tip >}}
Ensure that your target PostgreSQL database has the required `vector_assist` extension installed, in order for this tool to execute successfully.
{{< /notice >}}
## Parameters
The tool takes the following input parameters:
| Parameter | Type | Description | Required |
| :------------ | :----- | :--------------------------------------------------- | :------- |
| `table_name` | string | Table name to list vector specifications for. | Yes |
| `column_name` | string | Column name to list vector specifications for. | No |
> Note :
> Parameters are marked as required or optional based on the tool's parameter definitions.
> The underlying function may perform further validation on optional parameters to ensure
> all necessary data is available before returning a response.
## Example
```yaml
kind: tool
name: list_specs
type: vector-assist-list-specs
source: my-database-source
description: "This tool lists all defined vector specifications for a given table and column name. Use this tool to list vector specifications which were created in the context of the vector assist tools."
```
## Reference
| **field** | **type** | **required** | **description** |
|-------------|:--------:|:------------:|------------------------------------------------------|
| type | string | true | Must be "vector-assist-list-specs". |
| source | string | true | Name of the source the SQL should execute on. |
| description | string | false | Description of the tool that is passed to the agent. |
docs/en/integrations/cloud-sql-pg/tools/vector-assist-modify-spec.md
+72
View File
@@ -0,0 +1,72 @@
---
title: "vector-assist-modify-spec"
type: docs
weight: 1
description: >
The "vector-assist-modify-spec" tool modifies an existing vector specification
with new parameters or overrides, recalculating the generated SQL
recommendations to match the updated requirements.
---
## About
The `vector-assist-modify-spec` tool modifies an existing vector specification (identified by a required `spec_id`) with new parameters or overrides. Upon modification, it automatically recalculates and refreshes the list of generated recommendations by `vector_assist.define-spec` to match the updated spec requirements.
Use this tool when a user or agent wants to adjust or fine-tune the configuration of an already defined vector spec (such as changing the target recall, embedding model, or quantization) before actually executing the setup commands. Under the hood, this tool connects to the target database and executes the `vector_assist.modify_spec` function to generate the updated specifications.
## Compatible Sources
{{< compatible-sources >}}
## Requirements
{{< notice tip >}}
Ensure that your target PostgreSQL database has the required `vector_assist` extension installed, and that the `vector_assist.modify_spec` function is available in order for this tool to execute successfully.
{{< /notice >}}
## Parameters
The tool takes the following input parameters:
| Parameter | Type | Description | Required |
| :----------------------- | :------ | :--------------------------------------------------------------------- | :------- |
| `spec_id` | string | Unique ID of the vector specification to modify. | Yes |
| `table_name` | string | New table name for the vector workload setup. | No |
| `schema_name` | string | New schema name containing the target table. | No |
| `vector_column_name` | string | New name for the column containing vector embeddings. | No |
| `text_column_name` | string | New name for the text column for vector search. | No |
| `vector_index_type` | string | New vector index type ('hnsw', 'ivfflat', or 'scann'). | No |
| `embeddings_available` | boolean | Update if vector embeddings already exist in the table. | No |
| `num_vectors` | integer | Update the expected total number of vectors. | No |
| `dimensionality` | integer | Update the dimension of vectors or the embedding model. | No |
| `embedding_model` | string | Update the model used for generating vector embeddings. | No |
| `prefilter_column_names` | array | Update the columns used for prefiltering vector queries. | No |
| `distance_func` | string | Update the distance function ('cosine', 'ip', 'l2', 'l1'). | No |
| `quantization` | string | Update the quantization method ('none', 'halfvec', 'bit'). | No |
| `memory_budget_kb` | integer | Update maximum memory (in KB) for index building. | No |
| `target_recall` | float | Update the target recall rate for the index. | No |
| `target_top_k` | integer | Update the number of top results (top-K) to retrieve. | No |
| `tune_vector_index` | boolean | Update whether automatic tuning is required for the index. | No |
> Note
> Parameters are marked as required or optional based on the vector assist function definitions.
> The function may perform further validation on optional parameters to ensure all necessary
> data is available before returning a response.
## Example
```yaml
kind: tool
name: modify_spec
type: vector-assist-modify-spec
source: my-database-source
description: "This tool modifies an existing vector specification (identified by a required spec_id) with new parameters or overrides. Upon modification, it automatically recalculates and refreshes the list of generated SQL recommendations to match the updated requirements. Use this tool when a user wants to adjust or fine-tune the configuration of an already defined vector spec (such as changing the target recall, embedding model, or quantization) before actually executing the setup commands."
```
## Reference
| **field** | **type** | **required** | **description** |
|-------------|:--------:|:------------:|------------------------------------------------------|
| type | string | true | Must be "vector-assist-modify-spec". |
| source | string | true | Name of the source the SQL should execute on. |
| description | string | false | Description of the tool that is passed to the agent. |