Billy Assistant in Cribl Search
Ask Billy to explain your data, answer product questions, run searches, and build content, without leaving the page you’re on.
About the Billy Assistant in Cribl Search
Billy is integrated across Cribl Search as a sidebar that stays with you as you move between the Logs page, Dashboards, Notebooks, and saved searches.
The assistant keeps your conversation and knows which page you’re viewing. This means you can ask follow-up questions about what’s in front of you, instead of restating context each time.
What Billy Can Do
Explain and analyze. Ask what a set of results, a Dashboard panel, or a Notebook contains. Billy reads the page you’re on, including the current Dashboard definition and its panels, and answers in plain language. It reads a live snapshot each time, so it reflects edits you just made.
Answer product questions. Ask how an operator works, how to set up a feature, or how to troubleshoot a problem. These questions can cover Cribl Search, Cribl Stream, Cribl Edge, or Cribl Lake. Billy answers from the official documentation and links each page it used.
Run searches. Describe what you want to find and Billy writes and runs the KQL for you. It can run a query in the live Search view from anywhere in the product, so you don’t have to navigate to the Logs page first.
A query that writes data, sends data out, or uses a Macro isn’t run in the live Search view. Billy asks you to confirm that query, or shows it to you to run yourself.
Convert and fix queries. Paste an SPL query, or a KQL query that fails, and ask Billy to convert or fix it.
Billy doesn’t run or save a query it can’t make valid. It shows you the query and the remaining error.
Create and update content. Use Billy to create, update, and delete Dashboards, Dashboard Collections, Notebooks, and saved searches. You can also build Dashboard chart panels, set up Notifications on saved searches, manage search jobs, and create and update Macros and Notebook Templates. For a scheduled search that sends email, see Schedule a Search That Emails Results.
Create and use lookups. Ask Billy to find a lookup or create a .csv lookup. You can also enrich a live
search, a saved search, a Dashboard, or a Notebook through the lookup operator.
A pasted lookup is a .csv file of up to 64 KB. If that file name is taken, Billy asks for another name. Columns
and rows of a lookup in a Pack aren’t available.
Adjust what you’re viewing. While you’re on a Dashboard, ask Billy to change an input to filter or re-scope the Dashboard without leaving the page. The change applies only to your current view and resets when you reload the page.
Share resources. Billy can grant or revoke user and team access to Dashboards, Datasets, Dataset Providers, Macros, Notebooks, and Notebook Templates.
When Billy creates or updates something that has its own page, it offers a View it here link. Selecting the link opens the resource and leaves the sidebar open, so your session continues.
Billy changes only Cribl Search objects. For Cribl Stream, Cribl Edge, and Cribl Lake, answers come from the official documentation, and configuration stays unchanged. Billy can’t create or edit Packs. To inspect your Cribl Stream deployment, use the Billy Assistant in Cribl Stream.
Before You Start
- Use Cribl.Cloud. This feature isn’t available in on-prem deployments or in Cribl.Cloud Government.
- Confirm that an AI provider is configured for your Organization. See Cribl AI Availability.
- (Optional) Enable Dataset Intelligence on the Datasets you search most often.
On the Metrics and Monitors pages, Billy answers product questions but currently doesn’t interact with the page.
Run a Billy Session
On the top bar, select the Billy icon at the upper right. The sidebar opens on the right side of the page, alongside your content rather than on top of it.

Select the icon again or select Close AI sidebar to close the sidebar.
The next time you open the sidebar from the top bar, Billy starts a new session. The previous session stays under My recent sessions and in session history.
A session is one continuous conversation. Billy keeps your session as you move between Search pages, so you can build a Dashboard on one page and keep asking about it on another.
A new session is titled New Chat. After your first prompt, Billy replaces the title with a topic it derives from what you asked, which makes sessions easier to recognize later.
The sidebar header offers these actions:
- Expand to full width: Make the sidebar fill the page. The button then changes to Restore width.
- New chat: Start a fresh session. Your previous session remains available in your history.
- View session history: Open the sessions drawer, which lists every session you have access to.
- Close AI sidebar: Hide the sidebar. Opening it again from the top bar starts a new session.
The sessions drawer has a Context column that shows which AI feature a session came from, not which Cribl product you were in. Sessions you start in the Billy sidebar are labeled Cribl AI, and the sidebar lists your latest ones under My recent sessions. Sessions from Cribl Search investigations are labeled Investigations and appear in their own drawer. The two features are distinct, so starting a Billy session doesn’t affect your investigations or vice versa.
Point Billy at a Panel or Cell
To ask about part of a page, select the AI icon on a Dashboard panel (Ask AI about this panel) or Notebook cell (Ask AI about this cell).
To have Billy add content to a Notebook, select Use Cribl AI on the Add menu between cells or in the bar at the bottom of the Notebook.
Billy then uses that panel, cell, or position as context in every message you send. This continues until you select Clear selected panel, Clear selected cell, or Clear insert position above the message box, or start a New chat.
How Permissions Apply
Billy acts as you, so it can only do what your Search Permission already allows.
Before it offers a change, Billy checks your permissions and shows Checking permissions… briefly. If you don’t have permission, the card tells you so and offers only Dismiss. Billy never sends the request, and no Run request button appears.
Confirm Changes Before They Happen
Billy asks before it changes saved content. When it proposes a change, the sidebar shows a confirmation card describing the action in plain language.
To review the exact change first, expand View request. This shows the HTTP method and URL that Billy will call, along with the request body when there is one.
Then choose one of the following:
- Run request: Apply the change.
- Cancel: Reject the change. Billy continues the conversation without applying it.
When the change creates a lookup, the card lists Filename, Scope, Columns, and Rows. Expand View CSV to read the file that will be saved. Scope shows Cribl Search, global (not in a Pack).
To create a lookup from search results, select Run request on the confirmation card. Billy tells you if the lookup is ready or if rows were dropped.
Reading data and changing a Dashboard input don’t need confirmation, because they don’t change saved content.
Undo a Change
After a completed update, select Revert to reapply the previous definition. After a completed delete, select Recreate to create a new copy. The copy doesn’t have the permissions, sharing, or Notifications of the original.
Undo is available only immediately after the change, and only in the same browser tab. Reloading the page removes it. Undo also fails if someone changed the item after your edit, so Billy doesn’t overwrite the newer change.
Revert doesn’t appear after Billy creates a lookup.
Schedule a Search That Emails Results
Ask Billy to schedule a search and email you when the search returns results. For example, the prompt “Run this daily at 9 AM and email me if there are one or more results” requests a daily email.
Billy schedules the search in the time zone under Current Timezone, unless your prompt names a different zone.
An alert query is saved as you wrote it, even when that query returns no results right now.
Select Run request to create the saved search, and select it again to add the email Notification. If you select Cancel for the Notification, the saved search remains and no Notification is created.
Billy uses the email Notification target you name. When you don’t name one, it uses
the system_email target or your only email target. When it still can’t
choose, Billy asks which email target to use.
When no email target is configured, Billy creates the saved search and doesn’t add a Notification. Add a target in Settings > Search > Notification Targets.
Billy sends the Notification to the addresses you name, or to your account email.
Billy adds email Notifications that trigger on a result count. Slack, webhook, and custom conditions aren’t available through Billy.
After you confirm, Billy reports that the Notification is configured, but the report doesn’t mean the email was delivered.
Report a Problem
To report a problem with Billy, type /report and describe what went wrong. Billy submits the report to the
Cribl Search team and shows a confirmation message.
Find Searches That Billy Ran
Searches that Billy runs on your behalf have a job type of agentic. Search History excludes them by
default, because a single conversation can generate many searches and they would otherwise crowd out the searches you
ran yourself.
To see them, select agentic in the Type column filter. Search History then refetches and includes them.
Other Cribl AI Features in Cribl Search
Cribl Search offers several AI features. Use this page for the integrated sidebar, and see the following for the others:
- Run Investigations: A guided experience for incident investigation, with investigation plans, hypotheses, and Notebook output.
- Write Queries Using Billy: Natural-language to KQL translation in the query box, plus suggested follow-up queries.
- Add Visualizations Using Billy: Dataset analysis that suggests Dashboard visualizations.
For how the sidebar works across Cribl products, including the session history that Cribl Search shares with other Cribl products, see Billy Assistant.
For what each feature sends to an AI provider, see Cribl AI and Your Data.