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

# agent.create()

> Public low-code contract, signatures and examples for agent.create.

## `agent.create()`

Creates a new agent. The server creates agentId, status, managed workspace,
timestamps, and version; supply an existing service-account user id only.

Notes:

* Unavailable with `readOnly: true` (throws an error).

### Signature

```ts theme={null}
static create(data: AgentCreateInput): Promise<Agent>;
```

### Example

```ts theme={null}
const created = await agent.create({
  name: 'Ops copilot',
  serviceAccountUserId: userId,
  config: {
    systemInstructions: 'Translate each requested message to English.',
    contextMode: 'minimal',
    responseFormat: { type: 'json', strict: true, schema: {
      type: 'object', properties: { translation: { type: 'string' } },
      required: ['translation'], additionalProperties: false,
    } },
  },
});
```

See [all agent methods](https://docs.revoengine.com/low-code/reference/agent.md) or [runtime basics](https://docs.revoengine.com/low-code/overview.md).


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