---
title: "Listar ferramentas disponíveis"
method: GET
path: "/api/management/ai/available-tools"
tags: ["ai-agents", "available-tools"]
---

# Listar ferramentas disponíveis

`GET /api/management/ai/available-tools`

Lista as ferramentas que um agente pode usar. O `name` de cada item é exatamente o valor aceito no campo `tools` do agente, `inputSchema` descreve os argumentos que o modelo precisa preencher para chamá-la e `annotations` indica se ela apenas lê dados ou também escreve. O catálogo é o mesmo para todas as empresas e não tem paginação.

## Response `200`

Sucesso

- object — Catálogo de ferramentas dos agentes.
  - `response` boolean — Indicador de sucesso da requisição; sempre verdadeiro nesta resposta.
  - `tools` object[] — Ferramentas disponíveis, na ordem em que são registradas.
    - `name` 'get-project-details-tool' | 'get-project-media-tool' | 'get-project-funnel-metrics-tool' | 'get-form-tool' | 'get-model-dynamic-forms-tool' | 'get-form-answers-tool' | 'set-form-answers-tool' | 'move-project-to-funnel-step-tool' | 'get-projects-in-step-tool' | 'get-user-tool' | 'index-project-funnels-tool' | 'index-projects-tool' | 'web-search-tool' | 'today-tool' | 'save-media-tool' | 'edit-project-tool' | 'create-project-tool' | 'quick-create-project-tool' | 'clone-project-tool' | 'get-project-step-metrics-tool' | 'get-funnel-step-transitions-tool' — Nome da ferramenta; é exatamente o valor aceito no campo `tools` do agente.
    - `title` string — Nome da ferramenta para exibição.
    - `description` string — Explicação de quando usar a ferramenta, escrita para o modelo de IA.
    - `inputSchema` object — Argumentos que o modelo precisa preencher para chamar a ferramenta.
      - `type` string — Tipo do objeto de entrada; sempre `object`.
      - `properties` object — Argumentos aceitos pela ferramenta, um por chave.
      - `required` string[] — Argumentos obrigatórios da ferramenta.
    - `outputSchema` object — Formato do resultado devolvido pela ferramenta; presente apenas nas ferramentas que declaram um.
      - `type` string — Tipo do objeto de saída; sempre `object`.
      - `properties` object — Campos devolvidos pela ferramenta.
    - `annotations` object — Sinais sobre o comportamento da ferramenta, usados pelo modelo para decidir quando chamá-la.
      - `readOnlyHint` boolean — Indica que a ferramenta apenas lê dados, sem alterar nada.
      - `openWorldHint` boolean — Indica que a ferramenta acessa informação externa ao sistema.
      - `destructiveHint` boolean — Indica que a ferramenta pode apagar ou sobrescrever dados.
      - `idempotentHint` boolean — Indica que chamar a ferramenta várias vezes com os mesmos argumentos produz o mesmo efeito.

## Changes

- **2026-09-22** `d71b18b1685d` — 22 warning, 1 info
  - removed the optional property `tools/items/inputSchema/properties/project_identifier` from the response with the `200` status
  - added the new `clone-project-tool` enum value to the `tools/items/name` response property for the response status `200`
  - added the new `create-project-tool` enum value to the `tools/items/name` response property for the response status `200`
  - added the new `edit-project-tool` enum value to the `tools/items/name` response property for the response status `200`
  - …19 more
- **2026-09-18** `e3c5b00568f3` — 1 info
  - 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/available-tools/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/d71b18b1685d?raw)