> ## Documentation Index
> Fetch the complete documentation index at: https://docs.manypi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent tools

> Start agent runs, follow them and answer their questions.

## `run_agent`

> [!NOTE]
>
> Write · reaches the web

Run the ManyPI agent on a natural-language goal: scrape sites, research,
analyse data, turn a site into an API. Asynchronous — returns a `run_id` and
`conversation_id`.

| Argument | Type | |
| - | - | - |
| `goal` | string | **Required.** What you want ManyPI to do, in plain language. |

For finding leads, prefer `generate_leads`.

## `get_agent_run`

> [!NOTE]
>
> Read-only

Check the status and result of agent and lead-gen runs.

| Argument | Type | |
| - | - | - |
| `conversation_id` | uuid | From `run_agent` / `generate_leads`. Omit for your most recent runs. |
| `limit` | 1–50 | How many runs to return. |

Statuses: `queued` / `planning` / `running` (working), `paused` (waiting on you
— the question is in `result_summary`), `completed` / `failed` / `cancelled`
(done — see `result_summary`).

## `reply_to_agent`

> [!NOTE]
>
> Write · reaches the web

Answer an agent that is waiting for input, or send a follow-up to a finished
run. Resumes the **same** run if it was paused; otherwise starts a follow-up run
in the same conversation.

| Argument | Type | |
| - | - | - |
| `run_id` | uuid | **Required.** The run to answer. |
| `message` | string | **Required.** Your answer or follow-up, up to 8,000 characters. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.