Skip to content

Commit ffab2fa

Browse files
docs: update AI agent data access default to enabled
1 parent f708b57 commit ffab2fa

2 files changed

Lines changed: 15 additions & 17 deletions

File tree

guides/ai-agents/data-access.mdx

Lines changed: 13 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -3,33 +3,31 @@ title: Data access control
33
description: Understand how AI agents access and use your data
44
---
55

6-
AI agents offer flexible data access control to balance insights with privacy and security. By default, agents work with metadata only, but you can optionally enable data access for deeper analysis.
6+
AI agents offer flexible data access control to balance insights with privacy and security. New agents have data access enabled by default so they can analyze actual query results out of the box. You can turn data access off per agent to restrict them to metadata only.
77

88
## Data access modes
99

10-
**Metadata-only mode (default):**
11-
12-
- Agents can see your data structure, field names, and model definitions
13-
- They can generate appropriate queries and visualizations
14-
- No actual data values (except for one-row query results) are shared with the agent
15-
- Perfect for exploring data structure and creating initial analyses
16-
17-
**Data access enabled:**
10+
**Data access enabled (default for new agents):**
1811

1912
- Agents receive actual query results in addition to metadata
2013
- Can provide specific insights, identify trends, and analyze patterns in your data
2114
- Offers detailed summaries and data-driven recommendations
2215
- Can search for actual field values to ensure accurate filters when building visualizations
23-
- Only shares data when explicitly enabled per agent
16+
17+
**Metadata-only mode:**
18+
19+
- Agents can see your data structure, field names, and model definitions
20+
- They can generate appropriate queries and visualizations
21+
- No actual data values (except for one-row query results) are shared with the agent
22+
- Useful for exploring data structure when you don't want actual values shared with the agent
2423

2524
<Info>
26-
Data access is optional and controlled per agent. When disabled, agents only
27-
work with your data model structure and cannot see actual data values. This
28-
ensures sensitive information is only shared when you explicitly choose to
29-
enable this capability.
25+
Data access is controlled per agent. When disabled, agents only work with your
26+
data model structure and cannot see actual data values. Turn it off if you
27+
need to prevent sensitive values from being shared with the agent.
3028
</Info>
3129

32-
To enable data access, go to your agent settings and toggle the "Data Access" option.
30+
To change data access for an agent, go to your agent settings and toggle the "Data Access" option.
3331

3432
<Frame>
3533
<img

guides/ai-agents/getting-started.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -103,8 +103,8 @@ The more context you provide, the more accurate, relevant, and predictable your
103103
### Knowledge documents (optional)
104104
Upload reference material — glossaries, metric definitions, business context, internal SOPs — that your agent can consult while answering questions. Use this for the kind of context that doesn't fit neatly into a dbt `ai_hint` or your instructions. See [knowledge documents best practices](/guides/ai-agents/best-practices#knowledge-documents) for guidance on what to upload.
105105

106-
### Enable Data Access (optional)
107-
Enable data access to allow your agent to analyze actual query results and provide insights based on the data. When disabled, agents work with metadata only. Learn [how to enable data access](/guides/ai-agents/data-access#how-to-enable-data-access)
106+
### Data access (optional)
107+
Data access is enabled by default for new agents, allowing them to analyze actual query results and provide insights based on the data. Disable it from your agent settings if you want the agent to work with metadata only. Learn more about [data access modes](/guides/ai-agents/data-access#data-access-modes).
108108
### User and Group Access (optional)
109109
Control which users and groups can access your agent through the agent settings. For detailed guidance on how to configure data access control, see [here](/guides/ai-agents/data-access#user-attributes-and-permissions)
110110
### Tags (optional)

0 commit comments

Comments
 (0)