Chat with Your Data
Ask the in-app agent a question about your published packages, see the Malloy query it ran, and save the answer as a report
Type a question in a workspace in the Credible app, and the agent answers it from the workspace's published packages. Every answer comes from a Malloy query run against the data model, and the chat shows that query.
Prerequisites
- At least one package must be published and finished indexing, or the agent has nothing to search. The package page shows the version's status.
- You need read access to the package. Your personal workspace includes every package you can read; a shared workspace includes the packages its managers added.
Ask a Question
Type a question in the chat box at the bottom of the workspace, for example "revenue by region for the last four quarters".
The agent finds the relevant sources and fields in the workspace's packages, writes a Malloy query and runs it, so the model's access rules apply. In your personal workspace it runs with your own access. In a shared workspace it runs with the workspace's access under your name: it reads only the packages the workspace holds, and access rules see the workspace's group, not your own groups. A model that reads a person's own access values, such as a custom secure given, is refused there; use it from your personal workspace. How It Works explains the retrieval behind it.
Ask follow-ups that build on the previous answer, for example "only the West region" or "split that by product category".
See the Query It Ran
The chat shows each step the agent took, including the Malloy query behind each answer, so you can check which source, fields and filters an answer used. If the agent picked the wrong field, say so in the chat, or fix the description in the model (see Troubleshooting).
Save the Answer
From a chat you can:
- Download a result as CSV or Excel.
- Ask the agent to save the answer as a report, a dashboard or a notebook, in the workspace. A report saved from a chat reads the published model and doesn't change the package.
Chats are saved to the workspace under Conversations. In a shared workspace every member can see them. Questions asked of the in-app agent are metered in tokens; see pricing.
Troubleshooting
| Problem | Cause | Fix |
|---|---|---|
| The agent can't find a field you know exists | The field has no description, or the value you asked about isn't indexed | Add a #(doc) description, or #(index) on the dimension. See Descriptions and Value Search |
| A package is missing from your personal workspace | You can't read the package | Ask an admin of the package's environment for access |
| A package is missing from a shared workspace | Nobody has added it | Ask a workspace manager to add it |