> For the complete documentation index, see [llms.txt](https://agpt.co/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://agpt.co/docs/platform/using-the-platform/agent-library.md).

# Agent Library

## Overview

The Agent Library is your personal collection of agents. From here you can run agents, view task history, set up schedules and triggers, edit agents, and manage your collection.

**URL:** [platform.agpt.co/library](https://platform.agpt.co/library)

**Access:** Click the **Agents** button in the navigation bar.

## Library View

Your library displays all of your agents, including agents you've built yourself and agents you've added from the marketplace. Each agent shows its name and key information at a glance.

### Favorites and folders

Click the **heart icon** on an agent to add or remove it from the **Favorites** tab. Use folders to organize agents; create a folder from the library and choose **Move to folder** from an agent's menu.

## Agent Detail View

Click on any agent to open its detail view. This screen provides:

* **Tasks**: A full history of every time this agent has been executed
* **Scheduled**: A list of active schedules for this agent
* **Triggers**: Configured webhook triggers for trigger-based agents
* **Templates**: Saved task inputs and credential references for reuse

These are accessible via tabs on the left-hand side of the agent screen (e.g., `Tasks 286 | Scheduled 1 | Templates 0`).

### Agent Actions Menu

Click the **three dots** (⋯) on the far right-hand side of the agent screen to access:

| Action                   | Description                                                                       |
| ------------------------ | --------------------------------------------------------------------------------- |
| **Edit Agent**           | Opens the agent in the builder; marketplace agents are read-only until duplicated |
| **Delete Agent**         | Permanently removes the agent from your library                                   |
| **Export Agent to File** | Downloads the agent as a file you can share with others                           |

## Running an Agent

To run an agent manually:

1. Open the agent from your library
2. Click **New agent task**
3. Fill in the required inputs and credentials
4. Click **Start Task**

The task will begin executing immediately. You can watch the progress and view the results once it completes.

{% hint style="warning" %}
For a trigger-based agent, use the same **New agent task** dialog and click **Set up Trigger**. Trigger-based agents cannot be started manually. See [Scheduling & Triggers](/docs/platform/using-the-platform/scheduling-and-triggers.md) for details.
{% endhint %}

## Viewing Task Results

Every time an agent runs, it creates a **task**. To view task results:

1. Open the agent from your library
2. In the left-hand pane, browse the list of completed tasks
3. Click on a task to view its details

A task detail view shows:

* **Inputs**: The values that were provided when the task started
* **Outputs**: The results the agent produced
* **Cost**: The run's reported cost, displayed at the top of the task detail view

To share an output, click **Share results** and explicitly enable sharing; copying the authenticated task URL does not create a public link. See [Sharing & Exporting Agents](/docs/platform/using-the-platform/sharing-and-exporting.md#share-task-output-via-url) for visibility and revocation details.

## Importing an Agent

To import an agent from a file:

1. Go to your Agent Library
2. Click **Import**
3. Keep **AutoGPT agent** selected
4. Choose the exported JSON file, complete the requested metadata, and click **Upload**

The agent will be added to your library and can be run or edited like any other agent. This is useful for importing agents shared by other users outside of the marketplace.

## Deleting an Agent

1. Open the agent from your library
2. Click the **three dots** (⋯) on the far right
3. Select **Delete Agent**
4. Confirm the deletion when prompted

{% hint style="danger" %}
Deleting an agent is permanent and cannot be undone. Make sure you want to remove it before confirming.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://agpt.co/docs/platform/using-the-platform/agent-library.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.