> ## Documentation Index
> Fetch the complete documentation index at: https://docs.langdock.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Looker

> Connect Looker to Langdock to query your BI dashboards and run data analyses from your conversations

## Overview

Looker is Google Cloud's business intelligence platform. Once connected, you can use Langdock to search dashboards, run Looks, execute ad-hoc queries against your LookML models, and retrieve results directly from your conversations.

<Info>
  **Authentication:** API Key (Client ID + Client Secret)
  **Category:** Data & Analytics
  **Availability:** All workspace plans
</Info>

## Prerequisites

* A Looker instance (cloud or self-hosted)
* Permission to generate API credentials in Looker

## Setup

<Steps>
  <Step title="Generate API credentials in Looker">
    Follow [Looker's API authentication guide](https://cloud.google.com/looker/docs/api-auth) to generate a Client ID and Client Secret. Copy the secret immediately — it's only shown once.
  </Step>

  <Step title="Get your Looker base URL">
    Your base URL is the address of your Looker instance, e.g. `https://your-company.cloud.looker.com`.
  </Step>

  <Step title="Navigate to Integrations in Langdock">
    Go to [Integrations](https://app.langdock.com/integrations) and find **Looker** in the list.
  </Step>

  <Step title="Enter your credentials">
    Enter your base URL, Client ID, and Client Secret, then save.
  </Step>

  <Step title="Start using Looker in Langdock">
    Tag the integration with `@` in any agent to start querying your Looker data.
  </Step>
</Steps>

## Common Use Cases

<CardGroup cols={2}>
  <Card title="Dashboard Access" icon="chart-pie">
    Search and retrieve dashboards, get dashboard elements and their underlying queries
  </Card>

  <Card title="Run Looks" icon="play">
    Execute saved Looks and get results in JSON or CSV format
  </Card>

  <Card title="Ad-hoc Queries" icon="magnifying-glass-chart">
    Run inline queries against LookML models by specifying model, explore, fields, and filters
  </Card>

  <Card title="Data Discovery" icon="database">
    Browse LookML models, explores, and available fields to understand your data structure
  </Card>
</CardGroup>

## Troubleshooting

| Issue                     | Solution                                                                             |
| ------------------------- | ------------------------------------------------------------------------------------ |
| **Authentication failed** | Verify the Client ID and Secret are correct — regenerate if the secret was lost      |
| **Instance not found**    | Check the base URL format: `https://[instance].cloud.looker.com` (no trailing slash) |
| **Permission denied**     | Ensure the API user has access to the dashboards or models you're querying           |
| **Look not found**        | Use the search or list actions to find the correct Look ID                           |