Files
genai-toolbox/docs/en/resources/tools/looker/looker-get-dimensions.md
Dr. Strangelove 285aa46b88 feat(looker/tools): Enhance dashboard creation with dashboard filters (#2133)
## Description

Enhance dashboard creation with dashboard level filters. Also improve
tool descriptions.

## PR Checklist

> Thank you for opening a Pull Request! Before submitting your PR, there
are a
> few things you can do to make sure it goes smoothly:

- [X] Make sure you reviewed

[CONTRIBUTING.md](https://github.com/googleapis/genai-toolbox/blob/main/CONTRIBUTING.md)
- [x] Make sure to open an issue as a

[bug/issue](https://github.com/googleapis/genai-toolbox/issues/new/choose)
  before writing your code! That way we can discuss the change, evaluate
  designs, and agree on the general idea
- [x] Ensure the tests and linter pass
- [x] Code coverage does not decrease (if any source code was changed)
- [x] Appropriate docs were updated (if necessary)
- [x] Make sure to add `!` if this involve a breaking change
2025-12-10 13:30:20 -08:00

2.4 KiB

title, type, weight, description, aliases
title type weight description aliases
looker-get-dimensions docs 1 A "looker-get-dimensions" tool returns all the dimensions from a given explore in a given model in the source.
/resources/tools/looker-get-dimensions

About

A looker-get-dimensions tool returns all the dimensions from a given explore in a given model in the source.

It's compatible with the following sources:

looker-get-dimensions accepts two parameters, the model and the explore.

Example

tools:
    get_dimensions:
        kind: looker-get-dimensions
        source: looker-source
        description: |
          This tool retrieves a list of dimensions defined within a specific Looker explore.
          Dimensions are non-aggregatable attributes or characteristics of your data
          (e.g., product name, order date, customer city) that can be used for grouping,
          filtering, or segmenting query results.

          Parameters:
          - model_name (required): The name of the LookML model, obtained from `get_models`.
          - explore_name (required): The name of the explore within the model, obtained from `get_explores`.

          Output Details:
          - If a dimension includes a `suggestions` field, its contents are valid values
            that can be used directly as filters for that dimension.
          - If a `suggest_explore` and `suggest_dimension` are provided, you can query
            that specified explore and dimension to retrieve a list of valid filter values.

The response is a json array with the following elements:

{
  "name": "field name",
  "description": "field description",
  "type": "field type",
  "label": "field label",
  "label_short": "field short label",
  "tags": ["tags", ...],
  "synonyms": ["synonyms", ...],
  "suggestions": ["suggestion", ...],
  "suggest_explore": "explore",
  "suggest_dimension": "dimension"
}

Reference

field type required description
kind string true Must be "looker-get-dimensions".
source string true Name of the source the SQL should execute on.
description string true Description of the tool that is passed to the LLM.