---
title: "Atualizar agente de IA"
method: PUT
path: "/api/management/ai/agents/{agent}"
tags: ["ai-agents", "agents"]
---

# Atualizar agente de IA

`PUT /api/management/ai/agents/{agent}`

Atualiza os dados de um agente de IA. Apenas os campos enviados são alterados, e `tools` substitui por inteiro a lista de ferramentas habilitadas — enviar uma lista vazia desabilita todas.

## Request body

- object — Campos do agente a alterar; apenas os enviados são gravados.
  - `name` string — Novo nome do agente.
  - `description` string — Nova descrição curta do agente.
  - `default_provider` 'openrouter' | 'google' | 'openai' | 'anthropic' — Novo provedor de IA padrão do agente.
  - `default_model` string — Novo identificador do modelo padrão, conforme o `id` devolvido pelo catálogo de modelos disponíveis.
  - `base_prompt` string, nullable — Novo prompt base do agente.
  - `tools` string[], nullable — Nova lista de ferramentas habilitadas; substitui a anterior por inteiro.

## Response `200`

Sucesso

- object — Agente já com as alterações aplicadas.
  - `response` boolean — Indicador de sucesso da requisição; sempre verdadeiro nesta resposta.
  - `agent` object — Agente de IA atualizado.
    - `id` string, uuid — ID (UUID) do agente.
    - `name` string — Nome do agente.
    - `description` string, nullable — Descrição curta do agente, exibida na interface.
    - `default_provider` 'openrouter' | 'google' | 'openai' | 'anthropic' | 'null', nullable — Provedor de IA usado por padrão nas execuções do agente.
    - `default_model` string, nullable — Identificador do modelo de IA usado por padrão nas execuções do agente.
    - `base_prompt` string, nullable — Prompt base que define o comportamento do agente.
    - `status` 'active' | 'inactive' — Situação do agente.
    - `tools` string[], nullable — Ferramentas habilitadas para o agente.
    - `structured_output` object, nullable — Formato estruturado de saída configurado para o agente; nulo quando a resposta é texto livre.
    - `frame_id` string, uuid — ID (UUID) da empresa dona do agente.
    - `created_at` string, date-time — Data e hora de criação do agente.
    - `updated_at` string, date-time — Data e hora da última alteração do agente.
    - `deleted_at` string, date-time, nullable — Data e hora da exclusão lógica; nulo enquanto o agente está ativo.
    - `created_by` string, uuid, nullable — ID (UUID) do usuário que criou o agente.

## Other responses

- `404` — Agente não encontrado
- `422` — Erro de validação

## Changes

- **2026-09-22** `d71b18b1685d` — 9 breaking, 31 warning, 29 info
  - request property `default_provider` was restricted to a list of enum values
  - request property `tools/items/` was restricted to a list of enum values
  - the `tools/items/` request property type changed from no type to `string`
  - the response property `agent/base_prompt` became nullable for the status `200`
  - …65 more
- **2026-09-22** `b43a04f35145` — 2 warning
  - removed the optional property `agent/deleted_at` from the response with the `200` status
  - removed the optional property `agent/structured_output` from the response with the `200` status
- **2026-09-18** `3202abfa17f9` — 3 info
  - added the media type `application/json` for the response with the status `200`
  - added the non-success response with the status `404`
  - added the non-success response with the status `422`

[Change history](https://skmtc.dev/olie-ai/apis/olie-api/changes/api/management/ai/agents/:agent/put.md)

---

[API](https://skmtc.dev/olie-ai/apis/olie-api.md) · [All operations](https://skmtc.dev/olie-ai/apis/olie-api/llms.txt) · [OpenAPI document](https://skmtc.dev/olie-ai/apis/olie-api/revisions/d7bda7d32f67?raw)