---
title: "Listar agentes de IA"
method: GET
path: "/api/management/ai/agents"
tags: ["ai-agents", "agents"]
---

# Listar agentes de IA

`GET /api/management/ai/agents`

Lista os agentes de IA da empresa, cada um já acompanhado da contagem e do custo somado de suas execuções e das etapas de funil em que atua como assistente. A lista vem inteira, sem paginação; use `search` para filtrar pelo nome.

## Query parameters

- `search` string

## Response `200`

Sucesso

- object — Lista completa dos agentes de IA da empresa.
  - `response` boolean — Indicador de sucesso da requisição; sempre verdadeiro nesta resposta.
  - `agents` object[] — Agentes de IA da empresa, sem paginação.
    - `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.
    - `executions_count` integer — Quantidade de execuções já registradas para o agente.
    - `executions_sum_cost` string, nullable — Custo somado das execuções do agente, em dólares e com nove casas decimais; nulo quando o agente ainda não foi executado.
    - `step_assistants` object[] — Etapas de funil em que o agente atua como assistente.
      - `id` string, uuid — ID (UUID) do assistente de etapa.
      - `funnel_step_id` integer — ID da etapa de funil em que o agente atua.
      - `ai_agent_id` string, uuid — ID (UUID) do agente vinculado à etapa.
      - `name` string — Nome do assistente de etapa.
      - `funnel_step` object — Etapa de funil em que o assistente está configurado.
        - `id` integer — ID da etapa de funil.
        - `name` string — Nome da etapa de funil.
    - `creator` object — Usuário que criou o agente; nulo quando o agente foi criado por uma integração.
      - `id` string, uuid — ID (UUID) do usuário.
      - `name` string — Nome do usuário.
      - `avatar_url` string, nullable — Endereço da foto de perfil do usuário.

## Changes

- **2026-09-22** `d71b18b1685d` — 7 breaking, 28 warning, 3 info
  - the response property `agents/items/base_prompt` became nullable for the status `200`
  - the response property `agents/items/created_by` became nullable for the status `200`
  - the response property `agents/items/default_model` became nullable for the status `200`
  - the response property `agents/items/default_provider` became nullable for the status `200`
  - …34 more
- **2026-09-22** `b43a04f35145` — 3 warning
  - removed the optional property `agents/items/creator/avatar_url` from the response with the `200` status
  - removed the optional property `agents/items/deleted_at` from the response with the `200` status
  - removed the optional property `agents/items/structured_output` from the response with the `200` status
- **2026-09-18** `0abcbb399fb0` — 2 info
  - added the new optional `query` request parameter `search`
  - added the media type `application/json` for the response with the status `200`

[Change history](https://skmtc.dev/olie-ai/apis/olie-api/changes/api/management/ai/agents/get.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)