# Conversation history

Conversation history is a powerful AIsuru feature that lets you review and analyze all of your Agent's past interactions. It's essential for monitoring usage and improving performance.

**Note:**\
Only users who created the Agent or have been invited as "authors" can access the Agent's conversations.

### Accessing conversation history

The conversation history lets you review and analyze all conversations your Agent has had — with you and with other users. Here's how to access it:

1. From the AIsuru homepage, find the Agent whose conversations you want to view;
2. Click the "Manage" button for the selected Agent;
3. In the Agent management sidebar, find and select  **Conversations.**

### Viewing the conversation list

On the main history page, you'll find a detailed list of all conversations. Each row contains the following information:

* **Title:** a distinctive title to identify the conversation;
* **Email:** the email address of the user who interacted with the agent;
* **Conversation start date**: when the interaction began;
* **Messages**: the number of messages exchanged;
* **Duration**: how long the conversation lasted;
* **Media**: this column indicates whether images were present or functions were executed during the conversation;
* **Actions**: you'll find the  Open and  Delete buttons.

{% hint style="info" %}
Before deleting a conversation, AIsuru will ask for confirmation.
{% endhint %}

### Filter and search tools

At the top of the list, three tools are available for filtering conversations:

### Search bar

The search bar lets you find conversations using the following criteria:

* Keyword: search for keywords within conversation content;
* Username: filter to show only conversations from a specific user who logged in to the platform (if a user didn't log in via email, they'll appear as anonymous);
* Email: filter conversations by the specific email address of the user who chatted with the agent;
* Session ID: filter by the unique session identifier.

Usage example: type "refund" in the search bar to find all conversations that mention that keyword.

{% hint style="info" %}
You can sort the list by clicking on the column headers.
{% endhint %}

### Date range selector

Clicking the date range selector, located next to the search bar, opens a dropdown calendar that lets you choose a custom time range with a start date and an end date, so you can filter conversations to a specific period.

Usage example: select "01/12/2024 - 14/12/2024" to see only conversations from the first two weeks of December.

### Minimum message count filter

The minimum message count filter is a dropdown that lets you filter conversations by length. The available options are:

* Any message: shows all conversations (no filter applied);
* At least 2/3/5/10/15/20 messages: shows only conversations with at least that number of messages;
* Set minimum: lets you specify a custom minimum number of messages to show only chats that meet the filter.

### Additional download button

Just below the user's username, you can press a button with 3 lines to access 2 distinct features:

* Download conversations: download the full conversation history in HTML format;
* Notifications: press this option to go directly to the [notification preferences](/en/analytics/agent-analysis/notification-preferences.md) section.

### Management buttons

In the Conversations section of the Agent management panel, in addition to the **Refresh** button, you'll also find a **Notification preferences** button.

The **Notification preferences button** takes you directly to the "Settings > Notifications" section of the Agent, letting you quickly manage notification preferences without navigating through the main menu. This is particularly useful when you're monitoring conversations and want to quickly adjust notification settings.

### Conversation details

After pressing the **Open** button, a new tab will open with the details of the selected conversation. **In the top right**, you can press the button to **download the conversation as a .txt file and click "Show info"** to open some advanced settings.

In the rest of the window, you'll find the **full transcript** of the message exchange between your Agent and the user, with precise timestamps for each message (e.g. 10:22:05).

**Show info**

The **Conversation details** panel opens **by clicking "Show info"** and contains the main information:

* **Conversation start date**: the date and time the conversation began (e.g. 11/07/2025, 10:22:04);
* **Username**: the username (if the user was logged in before interacting with the Agent);
* **Email**: the user's email address;
* **Language**: the language used by the user during the conversation.

**Session information**

The **Session information** section includes technical details about the session:

* **Session ID**: the unique identifier for the conversation (e.g. 5c75befa-7edd-442b-9a13-e9b9a3a63d2e);
* **DEBUG** button: provides access to advanced conversation debugging;
* **Referral**: the URL from which the user interacted with the Agent;
* **IP address**: the IP address is shown — pressing "Info" gives you further details (e.g. the location associated with the IP address);
* **User agent**: information about the user's browser and operating system.

Finally, at the bottom of the screen you'll also find:

* A "**show context per message**" checkbox: enabling this option lets you see which [context](https://claude.ai/istruzione-gestione-contenuti-agenti/istruzione-sezione-avanzata/personalizzazione-dei-contenuti/contesto-argomenti-ed-etichette.md) was set for each message;
* A "**show usage per message**" checkbox: when enabled, you can see various statistics such as token counts, environmental impact metrics, and the water consumption of each message.
* Two navigation buttons for moving forward and backward through the Agent's conversations.

### Function debugging

When viewing conversation details, next to messages that used functions you'll see the debug icon  shaped like a bug.

Clicking the icon lets you see:

* **Which function was called** (e.g. "Function Call to 'FUNCTION\_NAME' on \[call\_timestamp]");
* **The complete result** returned by the function.

This tool is particularly useful for:

* Verifying that your functions are being called correctly;
* Checking the data returned by functions;
* Debugging issues with external integrations.

Additionally, when the AI uses functions to generate responses, those results are automatically saved as **preformatted text** in the AI-generated content section, where you can validate them and turn them into fixed content.

#### Advanced conversation debugging

Beyond function-specific debugging, AIsuru offers an **advanced debug** feature that lets you monitor the technical events occurring during a conversation — in particular, any errors encountered by AI providers (e.g. incorrect API key, rate limits reached, context exceeded, etc.).

**Accessing advanced debug**

To access the advanced debug:

1. Open the details of a conversation from the **Conversations** section;
2. **Click on "Show info" and then "Session information"**;
3. Click the **DEBUG** button on the conversation details page, next to the Session ID.

**Information shown in the debug panel**

The debug panel shows:

* A **"Copy ALL Responses" button** to copy the log to your clipboard;
* A **complete technical log** of the conversation, organized in a table with the following columns:
  * **Time**: precise timestamp of the event (e.g. 2025-07-11T08:24:02.3168982Z);
  * **LogType**: type of event (e.g. "audit");
  * **Method**: HTTP method used;
  * **Path**: API endpoint called;
  * **Status**: HTTP status code of the response;
  * **Result Code**: internal result code of the operation;
  * **Result Message**: status message for the operation (e.g. "Ok");
  * **Details**: the API response in JSON format.

{% hint style="warning" %}
Advanced debug **is a technical tool** intended primarily for developers and administrators for in-depth monitoring of conversations and any technical errors.
{% endhint %}

### Viewing live conversations

With AIsuru you can also see conversations your users are having right now. All you need to do is:

1. Go to the Conversations section of your Agent;
2. Open the conversation you're interested in (usually the latest one);
3. **Refresh the page to check for new messages**.

AIsuru's conversation history is a valuable tool for keeping track of all interactions, improving system performance, and ensuring transparency. Explore this feature to get the most out of your AI assistant and optimize your future interactions.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.aisuru.com/en/analytics/agent-analysis/conversations.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.