> ## 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.

# Criar Agente

> Cria um novo agente na plataforma Orkeia AI.

## Endpoint

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

## Cabeçalhos

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

## Corpo da Requisição (JSON)

**Todos os campos abaixo são obrigatórios**

| Campo          | Tipo                                 | Descrição                                                                                                                                                                                 |
| -------------- | ------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| name           | string                               | Nome do agente                                                                                                                                                                            |
| enabled        | boolean                              | Se o agente está ativo                                                                                                                                                                    |
| model          | string / Model                       | id do modelo ou modelo de IA                                                                                                                                                              |
| auto           | boolean                              | Se o agente está ativo                                                                                                                                                                    |
| reasoning      | boolean                              | Se o agente tem permissao para processar o pensamento                                                                                                                                     |
| publisher      | string                               | Id de quem criou o agente                                                                                                                                                                 |
| temperature    | number (0.0 até 1.0)                 | Responsável por controlar a randomicidade das respostas do modelo. Valores mais proximos de 0 tendem a ser mais determinísticos, enquanto mais proximos de 1 tendem a ser mais variáveis. |
| role           | string                               | Papel que o agente irá desempenhar                                                                                                                                                        |
| objective      | string                               | Objetivo do agente em cada interação                                                                                                                                                      |
| referencies    | string                               | Referência textual que o agente ira utilizar                                                                                                                                              |
| can\_delegate  | boolean                              | O agente pode delegar tarefas?                                                                                                                                                            |
| can\_code      | boolean                              | O agente pode programar?                                                                                                                                                                  |
| multimodal     | boolean                              | O agente tem capacidade de interagir com multiplos modos (imagem, texto, audio)?                                                                                                          |
| sectors        | array(String)                        | array de setores que usarão o agente                                                                                                                                                      |
| tools          | array(String) / array(Tools)         | array de ferramentas que o agente pode usar                                                                                                                                               |
| knowledgeBases | array(String) / array(KnowledgeBase) | array de bases de conhecimento que poderão ser usadas pelo agente                                                                                                                         |

<Tip>
  Clique aqui para saber mais o que são [Ferramentas](https://docs.orkeia.ai/pt-BR/core-concepts/tools), [Bases de Conhecimento](https://docs.orkeia.ai/pt-BR/core-concepts/knowledge-bases) e [Modelos de IA](https://docs.orkeia.ai/pt-BR/core-concepts/models)!
</Tip>

```json theme={null}
{
  "name": "Nome do agente",
  "enabled": "true",
  "model": "sabia-3",
  "auto": "false",
 "reasoning": "false",
  "publisher": "ork-123",
  "temperature": "1",
  "role": "criador de conteúdo",
  "objective": "tem como objetivo fazer tal tarefa",
  "referencies": "texto de referencia",
  "can_delegate": "false",
  "can_code": "false",
  "multimodal": "false",
  "sectors": ["market"],
  "tools": ["web_scrapper"],
  "knowledgeBases": ["market_base"]
}
```

### Exemplo (cURL)

```bash theme={null}
curl -X POST "https://gateway.orkeia.ai/agents" \
  -H "authorization:  <seu_token>" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Nome do agente", "enabled": true
   "enabled": "true",
  "model": "sabia-3",
  "auto": "false",
 "reasoning": "false",
  "publisher": "ork-123",
  "temperature": "0.3",
  "role": "criador de conteúdo",
  "objective": "tem como objetivo fazer tal tarefa",
  "referencies": "texto de referencia",
  "can_delegate": "false",
  "can_code": "false",
  "multimodal": "false",
  "sectors": ["market"],
  "tools": ["web_scrapper"],
  "knowledgeBases": ["market_base"]
  }'
```

## Respostas

### Response - Success

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

### 500 — Bad Request

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

### 400 — Client Error

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