> ## Documentation Index
> Fetch the complete documentation index at: https://asapp-04-04-getting-started-ga.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Conversation Explorer

> Review and analyze GenerativeAgent conversations to improve performance.

As you add use cases to GenerativeAgent and refine its configuration, you will need to see how GenerativeAgent handles real customer interactions. **Conversation Explorer** is a powerful tool that enables you to fine-tune and review GenerativeAgent's customer interactions.

For each conversation, you can see the full model actions GenerativeAgent took which includes its input, knowledge, reasoning, actions, and output back to the customer.

Conversation Explorer also shows conversations that have been flagged as having [quality issues](#quality-issues).

## Using Conversation Explorer

To get started with Conversation Explorer:

<Steps>
  <Step title="Access Conversation Explorer">
    Request access to Conversation Explorer from your admin.

    Once granted, you can access Conversation Explorer at the following URLs:

    * Production: [https://app.asapp.com/reporting/conversations](https://app.asapp.com/reporting/conversations)
    * Sandbox: [https://app.sandbox.asapp.com/reporting/conversations](https://app.sandbox.asapp.com/reporting/conversations)
  </Step>

  <Step title="Find a conversation">
    Use the search and filter interface to locate specific interactions or patterns:

    * Use date filters to narrow your search
    * Search by conversation ID, customer name, or keywords
    * Filter by specific tasks, functions, or model actions

    <Frame>
      <img src="https://mintcdn.com/asapp-04-04-getting-started-ga/RRg3Ad4pxY3z3L-S/images/generativeagent/reporting/ce-search.png?fit=max&auto=format&n=RRg3Ad4pxY3z3L-S&q=85&s=90d49b6bfdd2b79c4c023f4bd83e4510" alt="Search functionality" width="609" height="299" data-path="images/generativeagent/reporting/ce-search.png" />
    </Frame>
  </Step>

  <Step title="Review the interaction">
    Once you have found a conversation, you can see exactly how GenerativeAgent makes decisions:

    * Enable model actions to see GenerativeAgent's reasoning
    * Click on model actions for detailed function responses
    * Check the quality tab for flagged interactions

    <Frame>
      <img src="https://mintcdn.com/asapp-04-04-getting-started-ga/RRg3Ad4pxY3z3L-S/images/generativeagent/reporting/ce-model-actions.png?fit=max&auto=format&n=RRg3Ad4pxY3z3L-S&q=85&s=5d7ea778ccc300860c383cfc793c406c" alt="Model actions in conversation" width="1178" height="730" data-path="images/generativeagent/reporting/ce-model-actions.png" />
    </Frame>
  </Step>
</Steps>

<Note>
  Your admin must grant Conversation Explorer permissions before you can access the interface.
</Note>

## Find conversations

Conversation Explorer provides a search and filter interface to locate specific interactions or patterns.

### Search and filter options

Use the search bar to find conversations containing specific words or phrases. Enclose terms in quotes for exact matches.

<Frame>
  <img src="https://mintcdn.com/asapp-04-04-getting-started-ga/RRg3Ad4pxY3z3L-S/images/generativeagent/reporting/ce-filters.png?fit=max&auto=format&n=RRg3Ad4pxY3z3L-S&q=85&s=9231da46752fc66f49468cff270d3e26" alt="Filter options" width="599" height="260" data-path="images/generativeagent/reporting/ce-filters.png" />
</Frame>

* **Date range**: Select specific time periods
* **Task**: Find conversations where specific tasks were performed
* **Functions**: Locate conversations that called particular APIs
* **Conversation ID**: Search for a specific conversation

### Filter for flagged conversations

To find [Quality Issues](#quality-issues):

1. Add the "GenerativeAgent Flags" filter
2. Review flagged interactions to understand quality alerts

<Frame>
  <img src="https://mintcdn.com/asapp-04-04-getting-started-ga/RRg3Ad4pxY3z3L-S/images/generativeagent/reporting/ce-flags-filter.png?fit=max&auto=format&n=RRg3Ad4pxY3z3L-S&q=85&s=72194f98a33c3134dc8ca0f1b6c65f0d" alt="Flags filter" width="368" height="190" data-path="images/generativeagent/reporting/ce-flags-filter.png" />
</Frame>

### Share a conversation

You can share a conversation with others by clicking the "Copy Link" button when viewing a conversation.

<Frame>
  <img src="https://mintcdn.com/asapp-04-04-getting-started-ga/RRg3Ad4pxY3z3L-S/images/generativeagent/reporting/ce-copy-link.png?fit=max&auto=format&n=RRg3Ad4pxY3z3L-S&q=85&s=52cedfd7ade5f18bca4860f6493c7c8d" alt="Copy link" width="344" height="140" data-path="images/generativeagent/reporting/ce-copy-link.png" />
</Frame>

You can also share your current filtered view by copying the URL of your current page.

## Analyze Model Actions

Once you have found a conversation, you can see exactly how GenerativeAgent makes decisions by viewing its internal reasoning process via **model actions**.

Model actions are the input, knowledge, api calls, reasoning, and output of GenerativeAgent's model while handling the customer interaction.

The information in the model actions can drive how you update the configuration of your tasks and functions.

<Frame>
  <img src="https://mintcdn.com/asapp-04-04-getting-started-ga/RRg3Ad4pxY3z3L-S/images/generativeagent/reporting/ce-model-actions.png?fit=max&auto=format&n=RRg3Ad4pxY3z3L-S&q=85&s=5d7ea778ccc300860c383cfc793c406c" alt="Model actions in conversation" width="1178" height="730" data-path="images/generativeagent/reporting/ce-model-actions.png" />
</Frame>

### Model actions categories

Model actions are categorized into the following:

<Note>
  When enabling a model action category, there may be multiple model actions with the same category that will be displayed. e.g. enabling Functions will show both a "Function Call" for the request and a "Function Response" for the response.
</Note>

<AccordionGroup>
  <Accordion title="Authentication">
    Actions occur when GenerativeAgent needs authentication data to call an API. Only used for API Connections that require [client data](/generativeagent/configuring/connect-apis/authentication-methods#client-authentication-data).
  </Accordion>

  <Accordion title="Confirmation requests">
    Actions occur when GenerativeAgent needs to confirm an action with the customer.
  </Accordion>

  <Accordion title="Functions">
    Actions that occur when GenerativeAgent calls a function to handle the customer interaction.

    The model actions will show:

    * The function name
    * Input parameters
    * Output

    Function calls may appear as multiple entries in the model action stream.

    You can also see the "Raw" JSON interaction between GenerativeAgent and the function.
  </Accordion>

  <Accordion title="Errors">
    Actions occur when GenerativeAgent encounters an error.
  </Accordion>

  <Accordion title="HILA">
    Actions occur when GenerativeAgent needs consultation from a human agent as part of [Human in the Loop](/generativeagent/human-in-the-loop).
  </Accordion>

  <Accordion title="Input variables">
    The [input variables](/generativeagent/configuring/tasks-and-functions/input-variables) that GenerativeAgent uses to call a function.
  </Accordion>

  <Accordion title="Knowledge">
    The Knowledgebase articles that GenerativeAgent was given to answer the customer's question.
  </Accordion>

  <Accordion title="Out-of-scope Customer Message">
    This occurs when GenerativeAgent determines that the customer's question is out of scope for the current task.
  </Accordion>

  <Accordion title="Tasks">
    The task that GenerativeAgent is entering or changing into in order to handle the customer interaction.
  </Accordion>

  <Accordion title="Thoughts">
    GenerativeAgent's internal thoughts and reasoning process.
  </Accordion>

  <Accordion title="Transfer to agent">
    This occurs when GenerativeAgent performs a [transfer to agent](/generativeagent/configuring/tasks-and-functions/system-transfer#transfer-to-agent) to escalate the conversation to a human agent.
  </Accordion>

  <Accordion title="Unsafe Customer Input">
    This occurs when GenerativeAgent determines that the customer's input is unsafe.
  </Accordion>
</AccordionGroup>

### Review model actions

When looking at a conversation, model actions are displayed inline with the conversation flow. This allows you to understand exactly when and why the AI made specific decisions during the interaction.

To review model actions:

1. Open a conversation
2. In the center panel, enable the model actions you want to review

   <Frame>
     <img src="https://mintcdn.com/asapp-04-04-getting-started-ga/RRg3Ad4pxY3z3L-S/images/generativeagent/reporting/ce-model-actions-filter.png?fit=max&auto=format&n=RRg3Ad4pxY3z3L-S&q=85&s=196ac739ba61b29f8e7d1575f65b6cc0" alt="Model actions filter" width="428" height="360" data-path="images/generativeagent/reporting/ce-model-actions-filter.png" />
   </Frame>
3. View the AI's reasoning process inline with the conversation, showing the chronological flow of decisions
4. Click any model action to see detailed information.

   This example shows a function response.

   <Frame>
     <img src="https://mintcdn.com/asapp-04-04-getting-started-ga/RRg3Ad4pxY3z3L-S/images/generativeagent/reporting/ce-model-action-details.png?fit=max&auto=format&n=RRg3Ad4pxY3z3L-S&q=85&s=5e358b0e9412832a21bdfeb1193b847a" alt="Model action details" width="1008" height="719" data-path="images/generativeagent/reporting/ce-model-action-details.png" />
   </Frame>

   You can also see the "Raw" JSON interaction between GenerativeAgent and the function.

## Quality issues

Our monitoring system can flag a conversation as having potential quality issues as determined by our quality evaluators. When quality issues are detected:

* **Inline indicators**: Flagged messages appear with visual indicators directly in the conversation flow
* **Quality tab**: The "Quality" tab provides detailed information about each flagged utterance.

<Frame>
  <img src="https://mintcdn.com/asapp-04-04-getting-started-ga/RRg3Ad4pxY3z3L-S/images/generativeagent/reporting/ce-quality-tab.png?fit=max&auto=format&n=RRg3Ad4pxY3z3L-S&q=85&s=eb6c68110a7ad12ff91ceb6a19892420" alt="Quality tab" width="1600" height="555" data-path="images/generativeagent/reporting/ce-quality-tab.png" />
</Frame>

<Accordion title="Quality Evaluators">
  Our monitoring system uses quality evaluators to flag conversations that may have quality issues. Work with your ASAPP Account team to understand the quality evaluators for your company.
</Accordion>

## Next steps

<CardGroup cols={2}>
  <Card title="Improve Tasks" href="/generativeagent/configuring/tasks-and-functions/improving">
    Refine tasks, functions, and knowledge base based on your analysis.
  </Card>

  <Card title="Previewer" href="/generativeagent/configuring/previewer">
    Live test your configuration within the dashboard using the Previewer.
  </Card>

  <Card title="Troubleshooting" href="/generativeagent/configuring/safety-and-troubleshooting">
    Fix problems identified through conversation review.
  </Card>
</CardGroup>
