---
title: "Obter agente de IA específico"
method: GET
path: "/api/management/ai/agents/{agent}"
tags: ["ai-agents", "agents"]
---

# Obter agente de IA específico

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

Retorna um agente de IA com a contagem e o custo somado de suas execuções e as etapas de funil em que ele atua como assistente.

## Response `200`

Sucesso

- object
  - `response` boolean
  - `agent` object
    - `id` string
    - `name` string
    - `description` string
    - `default_provider` string
    - `default_model` string
    - `base_prompt` string
    - `status` string
    - `tools` string[]
    - `frame_id` string
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `created_by` string
    - `executions_count` integer
    - `executions_sum_cost` string
    - `step_assistants` object[]
      - `id` string
      - `funnel_step_id` integer
      - `ai_agent_id` string
      - `funnel_step` object
        - `id` integer
    - `creator` object
      - `id` string
      - `name` string

## Other responses

- `404` — Agente não encontrado

## Changes

- **2026-09-22** `b43a04f35145` — 3 warning
  - removed the optional property `agent/creator/avatar_url` from the response with the `200` status
  - 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` — 2 info
  - added the media type `application/json` for the response with the status `200`
  - added the non-success response with the status `404`

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