Ask about your data
A Data Source is a database or data warehouse of your company that the agent can query directly. Someone with the Right to create Data Sources connects it in the Data Studio (Connect a Data Source), and you need access to it to ask about its data.
Which Data Sources a Conversation has
Section titled “Which Data Sources a Conversation has”On Start, where you write the first message of a new Conversation, select Data Sources below the message field. It lists every Data Source you can query, each with a tick: all are selected. Select one to untick it, and the agent won’t use it in this Conversation.
Your first message fixes the Data Sources for the whole Conversation. Inside a Conversation, the same button lists them, read-only. If you lose access to one later, the agent can no longer query it there and says so if you ask about it.
What the agent does
Section titled “What the agent does”Ask your question in your own words, such as “What was revenue by region last quarter?”. The agent:
- looks at the Data Source’s tables and columns first, so it doesn’t guess names;
- writes a query in the database’s own SQL and runs it;
- answers from what the query returned. It never makes up or rounds numbers that weren’t in the result.
If the database answers with an error, the agent reads it, corrects its query and tries again.
What a query looks like
Section titled “What a query looks like”Each of these shows as a card in the answer. Looked at shows which tables the agent found, or the columns of one table. Queried names the Data Source and the question the query answers; select it to see the SQL, how many rows came back and the first of them, or the database’s error.
A result keeps at most 100,000 rows. The agent sees only the first 50, so it adds up, filters and sorts in the query rather than reading rows one by one.
What the agent may change
Section titled “What the agent may change”The agent can do whatever the database user behind the Data Source may do, including changing data, and it doesn’t ask first. Whoever connected the Data Source decides that by the database user they chose. The agent changes data only when you ask it to.
Who sees your queries
Section titled “Who sees your queries”Every query goes into the Data Source’s Query Log: your question, the query, whether it worked and how long it took, never the rows it returned. The people who may accept Context Change Requests on the Data Source can read it.