Skip to main content

Using Your Assistants

Once your vendor, Knowledge Stores, and Narratives are configured, you can begin interacting with assistants.

An assistant searches only the Knowledge Store data available through its configured agents. If the user prompting the assistant does not have access to a Knowledge Store, the assistant does not use that data when generating responses.

Using the Research Assistant

The Research Assistant page lists your chats, grouped by assistant. Each chat session maintains contextual memory within that session only. The Research Assistant saves your chats, so you can return to them later.

Assistants respond using only the Knowledge Store data available through their configured agents.

Starting a Chat

To start a chat with an assistant:

  1. Click the Research Assistant icon in the application menu.

  2. Click New Chat.

    A list of the assistants that you have access to appears.

  3. Click the assistant you want to use.

  4. Type your question in natural language, and click the Send icon.

  5. Review the assistant’s response.

Opening an Existing Chat

To open an existing chat:

  1. Click the Research Assistant icon in the application menu.

  2. In the list of chats, click the name of the chat.

Renaming a Chat

To rename a chat:

  1. Click the Research Assistant icon in the application menu.

  2. In the list of chats, click the Menu icon next to the chat.

  3. Click Rename.

  4. Type the new name.

  5. Click the check mark icon. To cancel, click the X icon.

Deleting a Chat

To delete a chat:

  1. Click the Research Assistant icon in the application menu.

  2. In the list of chats, click the Menu icon next to the chat.

  3. Click Delete.

  4. Click Delete to confirm.

Using an Assistant in the SQL Explorer

In the SQL Explorer, an assistant helps translate natural-language questions into SQL queries, which you can then run, refine, or explore. Each query tab in the SQL Explorer can have its own assistant, which appears in a chat pane to the right of the query editor. Only assistants configured with the Text-to-SQL agent are available in the SQL Explorer.

To use an assistant in the SQL Explorer:

  1. Click the SQL Explorer icon in the application menu.

  2. Click the + icon to the right of the query tabs to create a new query tab.

    If more than one assistant is available to you, a list of assistants appears. Click the assistant you want to use. If only one assistant is available, the new query tab uses that assistant automatically.

  3. In the chat pane, type a question about your structured data, and click the Send icon.

  4. Review the assistant’s response. If the response includes an SQL query, you may do one of the following:

    • Click Run to place the query in the query editor and run it. The results appear in the Results tab below the query editor.

    • Click Copy to copy the query to your clipboard.

Each query tab maintains its own chat session. Context and history are preserved within a tab, but not shared across different tabs. You can keep up to 15 query tabs open, so you can work on different queries at the same time.

For details on the rest of the SQL Explorer, see Using the SQL Explorer.

Troubleshooting Assistant Results

If assistants are not returning expected results, review your assistant and Knowledge Store configurations.

  • Verify that all items in the associated Knowledge Stores have been processed. Only processed documents and data are included in assistant responses.

  • Review the summarization questions and ensure it aligns with the types of questions users are asking. Including additional contextual information may improve retrieval accuracy.

  • Review Knowledge Store contents to ensure that unrelated data has not been included. Mixing unrelated data sources can reduce search accuracy and result quality.

If debugging and Langfuse logging are enabled, you can review execution traces for assistant interactions. These traces show the steps taken to generate a response and can help identify configuration or retrieval issues.

FeedbackOpens in a new tab