Get or create agent
create_agentGet or create a persistent cloud agent to accumulate project files, tools, and long-running jobs. Reusing a name reconnects to your existing agent.
Instructions
Get or create an agent by name: a persistent cloud environment running plori's agent, with its own disk, tools, and memory. Create one when the work should accumulate somewhere the user can return to: a project with files that build up, a repo to keep checked out, tools to install once and reuse, or a long job to hand off. You do not need one for a question you can answer yourself or for a one-off script with no state worth keeping. If the account already has an agent with this name, that agent is returned (marked "existing": true) instead of a duplicate — safe to call repeatedly, and the right way to reconnect to an agent you used before. Creation is subject to the account's plan limits (agent count, model tier); model is ignored when an existing agent is returned (use set_agent_model to change it).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | The agent's name. Reusing a previous name returns that existing agent. | |
| model | No | Optional model slug; omitted uses the Plori Router, which picks the cheapest model that fits each task from the pool the account's plan unlocks. An explicit frontier model still requires a paid plan. |