> For the complete documentation index, see [llms.txt](https://help.botpenguin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.botpenguin.com/ai-agents/overview.md).

# Overview

In this guide you see the Overview tab of an AI agent and what each part of it shows.

AI Agent has two main views. All Agents lists every agent in your account. Overview shows one agent: what is set up, what to do next, and how it performs. Use them to manage your agents in one place.

***

### Prerequisites

* A BotPenguin account that includes the AI agents feature.
* At least one AI agent. To make one, see Create your first AI Agent.

***

### Key definitions

| Term           | Meaning                                                               |
| -------------- | --------------------------------------------------------------------- |
| Active         | The agent is switched on and answers customers.                       |
| Installed      | The agent is connected to at least one channel, such as your website. |
| Setup progress | A checklist of what is left to do before the agent is ready.          |
| Key analytics  | Numbers that show how your agent performs.                            |

***

### All Agents

1. Click **All Agents** in the AI Agent sidebar. You see every agent in a table with the columns Agent Name, Status, Created At and Actions.

![Click All Agents to see every agent](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/04CWGMXhaAYFnV2I26y8/images/overview-step-1.png)

2. Type in **Search agents** to find an agent by name.

![Type an agent name in Search agents](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/ydXKhISxeIYTzy1x3yc9/images/overview-step-2.png)

3. Click **Filter by status** and choose Active or Inactive to show only those agents. A tag shows the filter. Click its close icon to clear it.

![Click Filter by status to show only active or inactive agents](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/bwhJnbE4nIS0ntdb6xIQ/images/overview-step-3.png)

4. Use the switch in the Status column to turn an agent on or off.

![Use the switch to turn an agent on or off](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/xPlHEUoEcJHFEJUBNIdl/images/overview-step-4.png)

5. Click the name of an agent to open it. In the Actions column you can also edit or delete an agent. To bring in an agent from a file, click the Import agent icon.

![Click an agent name to open it](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/pav9jHZ7TkVvjbuKQQvq/images/overview-step-5.png)

***

### Overview

1. The top right of the agent's Overview page shows the tag shows Installed or Not installed. Click it to go to the installation page. The Active switch turns the agent on or off.

![Read the Installed tag and use the Active switch](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/XABKCXzeI0Y6XuiwCglO/images/overview-step-6.png)

2. A fully set up agent shows&#x20;

   1. Total Conversations,&#x20;
   2. Resolved Automatically,&#x20;
   3. Avg. Response Time and&#x20;
   4. Active Users (7d).&#x20;

   Click a number to open it in Analytics. Charts below show Conversations per week and AI accuracy.

![Read the four Key analytics numbers](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/0p7pJ8TU2eBy9EeTBfgM/images/overview-step-7.png)

3. Scroll to Shortcuts to jump to WA Catalogue, WA Flows, Widgets and Agent Templates. You can also use Export Agent to download this agent or Import Agent to load one from a file.

![Use Shortcuts to jump to related pages](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/x38V1pyxcs9h6MAUI03x/images/overview-step-8.png)

4. While an agent is still being set up, the page shows Setup progress instead of Key analytics. It lists 7 steps:&#x20;

   1. Create your AI agent,&#x20;
   2. Set up your AI agent,&#x20;
   3. Install your AI agent and&#x20;
   4. Review your settings and others&#x20;

   Click the button on a step to do it, or click Mark as done. When all steps are done, Key analytics replaces the list.

![Follow the Setup progress list until it is complete](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/1qusGzhxdBQO0jlJqtpH/images/overview-step-9.png)

***

### Common errors

<details>

<summary>My agent shows Not installed</summary>

The agent is not connected to a channel yet. Click the tag to open the installation page and install it on your website or another channel.

</details>

<details>

<summary>I do not see Key analytics</summary>

Key analytics shows only after setup is complete. Until then you see Setup progress. You also need permission to view Analytics.

</details>

<details>

<summary>An agent I switched off still appears in the list</summary>

Switching an agent off does not delete it. It stays in All Agents with Status off. Use the delete icon to remove it.

</details>

<details>

<summary>I cannot find an agent in the list</summary>

Clear the search and the status filter. The list may be hidden by a filter. Use Load more at the bottom to see more agents.

</details>

<details>

<summary>An Action required message appears. What do I do?</summary>

Click the button in the message. It takes you to the page that needs attention, such as connecting a tool's account in Prompt & Tools.

</details>

***

### Support

Still not working? Write to us at <support@botpenguin.com>. We will reach out to you within 24 hours.
