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

# Atualizar Agente

> Atualiza os dados de um agente.

## Endpoint

`PUT https://gateway.orkeia.ai/agents/{id}`

## Cabeçalhos

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

### Parâmetros de caminho

```json theme={null}
{
  "id": "ID do agente (obrigatório)"
}
```

### Request body

Todos os campos de Agentes, salvo o id, são mutaveis.

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

```json theme={null}
{
  "name": "Novo nome do agente",
  "enabled": true
}
```

### Exemplo (cURL)

```bash theme={null}
curl -X PUT "https://gateway.orkeia.ai/agents/agent123" \
  -H "authorization:  <seu_token>" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Novo nome do agente", "enabled": true}'
```

## Respostas

### Response - Success

```json theme={null}
{
"status": "OK",
   "data": { "true" }
}
```

### 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
}
```