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

> Crea un nuevo agente en la plataforma Orkeia AI.

# Agents create

## Endpoint

`POST https://gateway.orkeia.ai/agents`

## Encabezados

```
authorization: <tu_token>
Content-Type: application/json
```

## Cuerpo de la Solicitud (JSON)

**Todos los campos a continuación son obligatorios**

| Campo          | Tipo                                 | Descripción                                                                                                                                                                                |
| -------------- | ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| name           | string                               | Nombre del agente                                                                                                                                                                          |
| enabled        | boolean                              | Si el agente está activo                                                                                                                                                                   |
| model          | string / Model                       | id del modelo o modelo de IA                                                                                                                                                               |
| auto           | boolean                              | Si el agente está activo                                                                                                                                                                   |
| reasoning      | boolean                              | Si el agente tiene permiso para procesar el pensamiento                                                                                                                                    |
| publisher      | string                               | Id de quien creó el agente                                                                                                                                                                 |
| temperature    | number (0.0 hasta 1.0)               | Responsable por controlar la aleatoriedad de las respuestas del modelo. Valores más cercanos a 0 tienden a ser más determinísticos, mientras más cercanos a 1 tienden a ser más variables. |
| role           | string                               | Papel que el agente desempeñará                                                                                                                                                            |
| objective      | string                               | Objetivo del agente en cada interacción                                                                                                                                                    |
| referencias    | string                               | Referencia textual que el agente utilizará                                                                                                                                                 |
| can.delegate   | boolean                              | ¿Puede el agente delegar tareas?                                                                                                                                                           |
| can\_code      | boolean                              | ¿Puede el agente programar?                                                                                                                                                                |
| multimodal     | boolean                              | ¿Puede el agente interactuar con múltiples modos (imagen, texto, audio)?                                                                                                                   |
| sectors        | array(String)                        | array de sectores que usarán el agente                                                                                                                                                     |
| tools          | array(String) / array(Tools)         | array de herramientas que el agente puede usar                                                                                                                                             |
| knowledgeBases | array(String) / array(KnowledgeBase) | array de bases de conocimiento que podrán ser usadas por el agente                                                                                                                         |

<Tip>
  ¡Haz clic aquí para saber más sobre [Herramientas](https://docs.orkeia.ai/es-ES/core-concepts/tools), [Bases de Conocimiento](https://docs.orkeia.ai/es-ES/core-concepts/knowledge-bases) y [Modelos de IA](https://docs.orkeia.ai/es-ES/core-concepts/models)!
</Tip>

```json theme={null}
{
  "name": "Nombre del agente",
  "enabled": "true",
  "model": "sabia-3",
  "auto": "false",
 "reasoning": "false",
  "publisher": "ork-123",
  "temperature": "1",
  "role": "creador de contenido",
  "objective": "tiene como objetivo realizar tal tarea",
  "referencias": "texto de referencia",
  "can.delegate": "false",
  "can_code": "false",
  "multimodal": "false",
  "sectors": ["market"],
  "tools": ["web_scrapper"],
  "knowledgeBases": ["market_base"]
}
```

### Ejemplo (cURL)

```bash theme={null}
curl -X POST "https://gateway.orkeia.ai/agents" \
  -H "authorization:  <tu_token>" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Nombre del agente", "enabled": true
   "enabled": "true",
  "model": "sabia-3",
  "auto": "false",
 "reasoning": "false",
  "publisher": "ork-123",
  "temperature": "0.3",
  "role": "creador de contenido",
  "objective": "tiene como objetivo realizar tal tarea",
  "referencias": "texto de referencia",
  "can.delegate": "false",
  "can_code": "false",
  "multimodal": "false",
  "sectors": ["market"],
  "tools": ["web_scrapper"],
  "knowledgeBases": ["market_base"]
  }'
```

## Respuestas

### Response - Success

```json response theme={null}
{
  "status": "OK",
  "data": { "id": "string_id"}
}
```

### 500 — Error Interno del Servidor

```json theme={null}
{
  "status": "ERROR",
  "code": "server/error",
  "data": null
}
```

### 400 — Error del Cliente

```json theme={null}
{
  "status": "ERROR",
  "code": "client/error",
  "data": null
}
```