feat(tools/looker): tools to retrieve the connections, schemas, databases, and column metadata from a looker system.

cmd/root.go

@@ -102,6 +102,11 @@ import (
 	_ "github.com/googleapis/genai-toolbox/internal/tools/looker/lookerconversationalanalytics"
 	_ "github.com/googleapis/genai-toolbox/internal/tools/looker/lookerdeleteprojectfile"
 	_ "github.com/googleapis/genai-toolbox/internal/tools/looker/lookerdevmode"
+	_ "github.com/googleapis/genai-toolbox/internal/tools/looker/lookergetconnectiondatabases"
+	_ "github.com/googleapis/genai-toolbox/internal/tools/looker/lookergetconnections"
+	_ "github.com/googleapis/genai-toolbox/internal/tools/looker/lookergetconnectionschemas"
+	_ "github.com/googleapis/genai-toolbox/internal/tools/looker/lookergetconnectiontables"
+	_ "github.com/googleapis/genai-toolbox/internal/tools/looker/lookergetconnectiontablecolumns"
 	_ "github.com/googleapis/genai-toolbox/internal/tools/looker/lookergetdashboards"
 	_ "github.com/googleapis/genai-toolbox/internal/tools/looker/lookergetdimensions"
 	_ "github.com/googleapis/genai-toolbox/internal/tools/looker/lookergetexplores"

cmd/root_test.go

@@ -1507,7 +1507,7 @@ func TestPrebuiltTools(t *testing.T) {
 			wantToolset: server.ToolsetConfigs{
 				"looker_tools": tools.ToolsetConfig{
 					Name:      "looker_tools",
-					ToolNames: []string{"get_models", "get_explores", "get_dimensions", "get_measures", "get_filters", "get_parameters", "query", "query_sql", "query_url", "get_looks", "run_look", "make_look", "get_dashboards", "make_dashboard", "add_dashboard_element", "health_pulse", "health_analyze", "health_vacuum", "dev_mode", "get_projects", "get_project_files", "get_project_file", "create_project_file", "update_project_file", "delete_project_file"},
+					ToolNames: []string{"get_models", "get_explores", "get_dimensions", "get_measures", "get_filters", "get_parameters", "query", "query_sql", "query_url", "get_looks", "run_look", "make_look", "get_dashboards", "make_dashboard", "add_dashboard_element", "health_pulse", "health_analyze", "health_vacuum", "dev_mode", "get_projects", "get_project_files", "get_project_file", "create_project_file", "update_project_file", "delete_project_file", "get_connections", "get_connection_schemas", "get_connection_databases", "get_connection_tables", "get_connection_table_columns"},
 				},
 			},
 		},

docs/en/resources/tools/looker/looker-get-connection-databases.md

@@ -0,0 +1,41 @@
+---
+title: "looker-get-connection-databases"
+type: docs
+weight: 1
+description: >
+  A "looker-get-connection-databases" tool returns all the databases in a connection.
+aliases:
+- /resources/tools/looker-get-connection-databases
+---
+
+## About
+
+A `looker-get-connection-databases` tool returns all the databases in a connection.
+
+It's compatible with the following sources:
+
+- [looker](../../sources/looker.md)
+
+`looker-get-connection-databases` accepts a `conn` parameter.
+
+## Example
+
+```yaml
+tools:
+    get_connection_databases:
+        kind: looker-get-connection-databases
+        source: looker-source
+        description: |
+          get_connection_databases Tool
+
+          This tool will list the databases available from a connection if the connection
+          supports multiple databases.
+```
+
+## Reference
+
+| **field**   | **type** | **required** | **description**                                    |
+|-------------|:--------:|:------------:|----------------------------------------------------|
+| kind        |  string  |     true     | Must be "looker-get-connection-databases".         |
+| source      |  string  |     true     | Name of the source Looker instance.                |
+| description |  string  |     true     | Description of the tool that is passed to the LLM. |

docs/en/resources/tools/looker/looker-get-connection-schemas.md

@@ -0,0 +1,41 @@
+---
+title: "looker-get-connection-schemas"
+type: docs
+weight: 1
+description: >
+  A "looker-get-connection-schemas" tool returns all the schemas in a connection.
+aliases:
+- /resources/tools/looker-get-connection-schemas
+---
+
+## About
+
+A `looker-get-connection-schemas` tool returns all the schemas in a connection.
+
+It's compatible with the following sources:
+
+- [looker](../../sources/looker.md)
+
+`looker-get-connection-schemas` accepts a `conn` parameter and an optional `db` parameter.
+
+## Example
+
+```yaml
+tools:
+    get_connection_schemas:
+        kind: looker-get-connection-schemas
+        source: looker-source
+        description: |
+          get_connection_schemas Tool
+
+          This tool will list the schemas available from a connection, filtered by
+          an optional database name.
+```
+
+## Reference
+
+| **field**   | **type** | **required** | **description**                                    |
+|-------------|:--------:|:------------:|----------------------------------------------------|
+| kind        |  string  |     true     | Must be "looker-get-connection-schemas".           |
+| source      |  string  |     true     | Name of the source Looker instance.                |
+| description |  string  |     true     | Description of the tool that is passed to the LLM. |

docs/en/resources/tools/looker/looker-get-connection-table-columns.md

@@ -0,0 +1,43 @@
+---
+title: "looker-get-connection-table-columns"
+type: docs
+weight: 1
+description: >
+  A "looker-get-connection-table-columns" tool returns all the columns for each table specified.
+aliases:
+- /resources/tools/looker-get-connection-table-columns
+---
+
+## About
+
+A `looker-get-connection-table-columns` tool returns all the columnes for each table specified.
+
+
+It's compatible with the following sources:
+
+- [looker](../../sources/looker.md)
+
+`looker-get-connection-table-columns` accepts a `conn` parameter, a `schema` parameter, a `tables` parameter with a comma separated list of tables, and an optional `db` parameter.
+
+## Example
+
+```yaml
+tools:
+    get_connection_table_columns:
+        kind: looker-get-connection-table-columns
+        source: looker-source
+        description: |
+          get_connection_table_columns Tool
+
+          This tool will list the columns available from a connection, for all the tables
+          given in a comma separated list of table names, filtered by the 
+          schema name and optional database name.
+```
+
+## Reference
+
+| **field**   | **type** | **required** | **description**                                    |
+|-------------|:--------:|:------------:|----------------------------------------------------|
+| kind        |  string  |     true     | Must be "looker-get-connection-table-columns".     |
+| source      |  string  |     true     | Name of the source Looker instance.                |
+| description |  string  |     true     | Description of the tool that is passed to the LLM. |

docs/en/resources/tools/looker/looker-get-connection-tables.md

@@ -0,0 +1,41 @@
+---
+title: "looker-get-connection-tables"
+type: docs
+weight: 1
+description: >
+  A "looker-get-connection-tables" tool returns all the tables in a connection.
+aliases:
+- /resources/tools/looker-get-connection-tables
+---
+
+## About
+
+A `looker-get-connection-tables` tool returns all the tables in a connection.
+
+It's compatible with the following sources:
+
+- [looker](../../sources/looker.md)
+
+`looker-get-connection-tables` accepts a `conn` parameter, a `schema` parameter, and an optional `db` parameter.
+
+## Example
+
+```yaml
+tools:
+    get_connection_tables:
+        kind: looker-get-connection-tables
+        source: looker-source
+        description: |
+          get_connection_tables Tool
+
+          This tool will list the tables available from a connection, filtered by the 
+          schema name and optional database name.
+```
+
+## Reference
+
+| **field**   | **type** | **required** | **description**                                    |
+|-------------|:--------:|:------------:|----------------------------------------------------|
+| kind        |  string  |     true     | Must be "looker-get-connection-tables".            |
+| source      |  string  |     true     | Name of the source Looker instance.                |
+| description |  string  |     true     | Description of the tool that is passed to the LLM. |

docs/en/resources/tools/looker/looker-get-connections.md

@@ -0,0 +1,42 @@
+---
+title: "looker-get-connections"
+type: docs
+weight: 1
+description: >
+  A "looker-get-connections" tool returns all the connections in the source.
+aliases:
+- /resources/tools/looker-get-connections
+---
+
+## About
+
+A `looker-get-connections` tool returns all the connections in the source.
+
+It's compatible with the following sources:
+
+- [looker](../../sources/looker.md)
+
+`looker-get-connections` accepts no parameters.
+
+## Example
+
+```yaml
+tools:
+    get_connections:
+        kind: looker-get-connections
+        source: looker-source
+        description: |
+          get_connections Tool
+
+          This tool will list all the connections available in the Looker system, as
+          well as the dialect name, the default schema, the database if applicable,
+          and whether the connection supports multiple databases.
+```
+
+## Reference
+
+| **field**   | **type** | **required** | **description**                                    |
+|-------------|:--------:|:------------:|----------------------------------------------------|
+| kind        |  string  |     true     | Must be "looker-get-connections".                  |
+| source      |  string  |     true     | Name of the source Looker instance.                |
+| description |  string  |     true     | Description of the tool that is passed to the LLM. |

internal/prebuiltconfigs/tools/looker.yaml

@@ -823,6 +823,54 @@ tools:
           This tool must be called after the dev_mode tool has changed the session to
           dev mode.
 
+    get_connections:
+        kind: looker-get-connections
+        source: looker-source
+        description: |
+          get_connections Tool
+
+          This tool will list all the connections available in the Looker system, as
+          well as the dialect name, the default schema, the database if applicable,
+          and whether the connection supports multiple databases.
+
+    get_connection_schemas:
+        kind: looker-get-connection-schemas
+        source: looker-source
+        description: |
+          get_connection_schemas Tool
+
+          This tool will list the schemas available from a connection, filtered by
+          an optional database name.
+
+    get_connection_databases:
+        kind: looker-get-connection-databases
+        source: looker-source
+        description: |
+          get_connection_databases Tool
+
+          This tool will list the databases available from a connection if the connection
+          supports multiple databases.
+
+    get_connection_tables:
+        kind: looker-get-connection-tables
+        source: looker-source
+        description: |
+          get_connection_tables Tool
+
+          This tool will list the tables available from a connection, filtered by the 
+          schema name and optional database name.
+
+    get_connection_table_columns:
+        kind: looker-get-connection-table-columns
+        source: looker-source
+        description: |
+          get_connection_table_columns Tool
+
+          This tool will list the columns available from a connection, for all the tables
+          given in a comma separated list of table names, filtered by the 
+          schema name and optional database name.
+
+
 toolsets:
     looker_tools:
         - get_models
@@ -850,3 +898,8 @@ toolsets:
         - create_project_file
         - update_project_file
         - delete_project_file
+        - get_connections
+        - get_connection_schemas
+        - get_connection_databases
+        - get_connection_tables
+        - get_connection_table_columns