Skip to content

Commit e115978

Browse files
authored
docs: update data access default to enabled (#710)
Updates the data access documentation to reflect that data access is now **enabled by default** for AI agents, rather than being an opt-in feature. - Reorders the data access modes so "Data access enabled" appears first as the default, with "Metadata-only mode" listed as the alternative - Updates the info callout and surrounding copy to reflect the new default behavior - Adjusts the getting started guide to remove the "optional" label from the Data Access section and clarify that it's on by default with the option to disable it per agent
1 parent f708b57 commit e115978

2 files changed

Lines changed: 15 additions & 17 deletions

File tree

guides/ai-agents/data-access.mdx

Lines changed: 13 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -3,33 +3,32 @@ 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. By default, agents have data access enabled, and you can disable it per agent when you want metadata-only behavior.
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):**
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
2316
- Only shares data when explicitly enabled per agent
2417

18+
**Metadata-only mode:**
19+
20+
- Agents can see your data structure, field names, and model definitions
21+
- They can generate appropriate queries and visualizations
22+
- No actual data values (except for one-row query results) are shared with the agent
23+
- Perfect for exploring data structure and creating initial analyses
24+
2525
<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.
26+
Data access is controlled per agent and is enabled by default.
27+
Turn it off when you want the agent to work only with your data model
28+
structure and not see actual data values.
3029
</Info>
3130

32-
To enable data access, go to your agent settings and toggle the "Data Access" option.
31+
To change data access, go to your agent settings and toggle the "Data Access" option.
3332

3433
<Frame>
3534
<img

guides/ai-agents/getting-started.mdx

Lines changed: 2 additions & 3 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
107+
By default, agents have data access enabled so they can analyze actual query results and provide insights based on the data. You can turn it off per agent if you want metadata-only behavior. Learn more in [data access control](/guides/ai-agents/data-access).
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)
@@ -237,4 +237,3 @@ Once a channel is designated as the multi-agent channel, all eligible agents in
237237
<Warning>
238238
If you see the error **"This Slack channel is already assigned to another AI agent"** while trying to attach a second agent via the per-agent integration path, that path only supports single-agent channels. Switch to the org-level multi-agent channel setup described above instead.
239239
</Warning>
240-

0 commit comments

Comments
 (0)