# Atualizar agente de IA

> Muda a configuração de um agente: a Mensagem do sistema (Prompt), o Max tokens e o modelo de cada provedor.

Endereço: https://docs.nextags.com.br/referencia/agentes-de-ia/atualizar-agente-de-ia/
Tipo: Endpoint

```http
POST https://app.nextagsai.com.br/api/agents/{agent_id}
X-ACCESS-TOKEN: <sua chave de API>
```

Muda a configuração de um agente: a **Mensagem do sistema (Prompt)**, o **Max tokens** e o modelo de cada provedor. Os três campos são opcionais. Veja [Escrever a mensagem do sistema](https://help.nextags.com.br/tutoriais/ia/escrever-o-prompt/) e [Modelo, temperatura e limite de tokens](https://help.nextags.com.br/tutoriais/ia/modelo-e-parametros/).

Autenticação: Mande a chave de API da conta no cabeçalho `X-ACCESS-TOKEN` de cada chamada. Veja [Autenticação com a chave de API](https://docs.nextags.com.br/comecar/autenticacao/).

## Parâmetros de caminho

| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `agent_id` | integer | sim | O ID do agente (veja [Listar agentes de IA](https://docs.nextags.com.br/referencia/agentes-de-ia/listar-agentes-de-ia/)). |

## Corpo da requisição (JSON)

| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `prompt` | string | não | A **Mensagem do sistema (Prompt)**: as instruções que o agente segue em todas as respostas. O texto novo substitui o atual. |
| `max_output_tokens` | integer | não | O **Max tokens**: o tamanho máximo de cada resposta, em tokens. Na tela, de 1 a 32768; o agente novo vem com 2048. |
| `model` | object | não | O modelo de cada provedor, os campos **Modelo (OpenAI)**, **Modelo (Gemini)**, **Modelo (Claude)**, **Modelo (xAI)** e **Modelo (DeepSeek)** dos ajustes do agente. Use o nome do modelo como o provedor chama; os exemplos são os modelos com que um agente novo começa. Mande os cinco, mesmo os de provedores que a conta não usa. |
| `model.openAI` | string | sim | O modelo da OpenAI, como `gpt-6-luna`. |
| `model.gemini` | string | sim | O modelo do Google Gemini, com o prefixo `models/`, como `models/gemini-3.5-flash-lite`. |
| `model.claude` | string | sim | O modelo do Claude, como `claude-haiku-4-5-20251001`. |
| `model.xAI` | string | sim | O modelo do xAI, como `grok-4.3`. |
| `model.deepseek` | string | sim | O modelo do DeepSeek, como `deepseek-v4-flash`. |

```json
{
  "prompt": "Você é a Bia, atendente da Loja Exemplo. Responda em português, em até 3 frases. Quando o cliente pedir troca, passe para a equipe.",
  "max_output_tokens": 2048,
  "model": {
    "openAI": "gpt-6-luna",
    "gemini": "models/gemini-3.5-flash-lite",
    "claude": "claude-haiku-4-5-20251001",
    "xAI": "grok-4.3",
    "deepseek": "deepseek-v4-flash"
  }
}
```

## Exemplo

```bash
curl -X POST "https://app.nextagsai.com.br/api/agents/5001" \
  -H "X-ACCESS-TOKEN: $NEXTAGS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Você é a Bia, atendente da Loja Exemplo. Responda em português, em até 3 frases. Quando o cliente pedir troca, passe para a equipe.",
    "max_output_tokens": 2048,
    "model": {
      "openAI": "gpt-6-luna",
      "gemini": "models/gemini-3.5-flash-lite",
      "claude": "claude-haiku-4-5-20251001",
      "xAI": "grok-4.3",
      "deepseek": "deepseek-v4-flash"
    }
  }'
```

Os exemplos em JavaScript, Python e PHP estão na página e no contrato (`x-codeSamples` em https://docs.nextags.com.br/openapi.json).

## Respostas

### 200 Sucesso

O agente, depois da mudança.

| Campo | Tipo | Descrição |
|---|---|---|
| `id` | integer | O ID do agente. |
| `name` | string | O nome do agente, como aparece na lista do AI Hub. |
| `created_by` | integer | O ID do administrador que criou. |
| `created_at` | string (data e hora) | Quando o agente foi criado, em UTC. |

```json
{
  "id": 5001,
  "name": "Bia - Loja Exemplo",
  "created_by": 10001,
  "created_at": "2026-09-15 13:20:00"
}
```

### 400 Requisição inválida

A mudança não foi aceita: confira os campos do corpo.

### 401 Chave inválida

A chave de API não veio no cabeçalho ou não vale (foi excluída ou está incompleta). Veja [Autenticação](https://docs.nextags.com.br/comecar/autenticacao/).

```json
{
  "error": {
    "code": 401,
    "message": "No valid API key provided."
  }
}
```