# agents

> Reference for the agents tool: create, read and list agents; running is part of the AI features.

Source: https://prompt-verse.io/docs/reference/agents/

An agent holds instructions, a provider and settings such as temperature. Use versions to give it a history.

Call it as `geenius_promptverse(tool: "agents", action: "<action>", args: {...})` through Geenius OS, or as the `agents` tool of the Prompt Verse MCP server with `action` and `args`.

## Actions

| Action | What it does |
|---|---|
| `create` | A new agent. |
| `get` | One agent with its definition. |
| `list` | Newest first, optionally filtered by provider. |
| `run` | One turn: your message and its answer. Remembers the last 20 turns. Switched off in the pre-beta. |

## Arguments we have checked

### agents · create

A new agent.

- `title` (required): Name.
- `provider` (required): internal, anthropic, openai, google or vercel.
- `data`: The definition, such as instructions and temperature.

### agents · get

One agent with its definition.

- `id` (required): Agent id.

### agents · list

Newest first, optionally filtered by provider.

- `provider`: Provider.

### agents · run

One turn: your message and its answer. Remembers the last 20 turns. Switched off in the pre-beta.

- `id` (required): Agent id.
- `message` (required): What you say.
- `model_id`: Optional model id.

> [!TIP]
> Ask for the exact arguments of any action with `action: "help", of: "create"`. The server answers from its own definitions, so that answer is always current.

> [!HONEST]
> run is listed but refuses while the AI features are off.