> For the complete documentation index, see [llms.txt](https://docs.arcwise.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.arcwise.app/espanol/configuracion-de-arcwise/conexion-de-herramientas-de-datos/conectate-a-dbt.md).

# Conéctate a dbt

Once you’ve set up the initial data warehouse connection, you can add dbt jobs linked to the warehouse account.

{% hint style="info" %}
**NOTE:** this requires `Job Viewer` role access to a dbt Cloud account.
{% endhint %}

## Adding DBT

1. In the **Connections** tab, click on the connection that should have linked dbt jobs.
2. Go to the **dbt connections** section and click the **Add dbt connection** button.<br>

   <figure><img src="/files/ut6giCEOYcJCSC7fQaE3" alt="" width="375"><figcaption></figcaption></figure>
3. Fill in the form with the required details. See below for additional details.<br>

   <figure><img src="/files/dOi9eFdBs4jxticmE1Fc" alt=""><figcaption></figcaption></figure>

## Form Details

<details>

<summary>Account and job ID</summary>

In dbt Cloud, navigate to the **Jobs** list under the **Deploy** menu. Click on the job that you want to connect to Arcwise (if you have multiple jobs, please select the job that builds your dbt docs, i.e. it includes a dbt docs generate step). The URL should be in the form&#x20;

`https://cloud.getdbt.com/next/deploy/[ACCOUNT-ID]/projects/[PROJECT_ID]/jobs/[JOB_ID]`

Copy and paste the account and job numbers into the Arcwise form.

![](/files/8cBeat3xgi5YitlCmzI3)

</details>

<details>

<summary>Service token</summary>

See instructions in [dbt docs for generating a service token](https://docs.getdbt.com/docs/dbt-cloud-apis/service-tokens). The token must have access to both the **Metadata API** and **Job Admin**.

</details>

<details>

<summary>Semantic Layer Proxy URL</summary>

If you want to allow Arcwise to use [dbt metrics](https://docs.getdbt.com/docs/build/metrics), then you’ll need to link Arcwise to the dbt Semantic Layer. Follow the [semantic layer setup instructions from the dbt docs](https://docs.getdbt.com/docs/use-dbt-semantic-layer/setup-dbt-semantic-layer) (if you haven’t already) and paste the proxy URL from your job’s environment into Arcwise.

</details>

## Indexing

After the dbt connection has been successfully saved, navigate to the “Tables” tab and you should see the models and metrics belonging to your dbt job.

{% hint style="info" %}
By default, Arcwise will index all models and metrics linked to the job that have not been marked as hidden from dbt docs. To hide things from Arcwise, you can set the `docs` config to `show: false` - please see the [official dbt docs](https://docs.getdbt.com/reference/resource-configs/docs#mark-a-model-as-hidden) for how to do this for an individual model or entire folders.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.arcwise.app/espanol/configuracion-de-arcwise/conexion-de-herramientas-de-datos/conectate-a-dbt.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
