---
slug: agentes/mcp/arquivos/document-search
title: "document_search"
description: "Busca o texto indexado de arquivos ativos que esta concessão pode ler."
---

| Ferramenta | Tipo | Descrição |
| :-- | :-- | :-- |
| `document_search` | leitura | Busca o texto indexado de arquivos ativos que esta concessão pode ler. Cada palavra é exigida como palavra inteira; maiúsculas e acentos são ignorados (`rescisao` encontra `rescisão`), mas variações de grafia e plurais não. Cada resultado traz um `snippet` com o trecho que casou; frases vão entre aspas duplas, e `OR` em maiúsculas entre duas palavras ou frases aceita qualquer uma. Com `fileId`, um arquivo sem texto indexado falha com `invalid_input` dizendo isso, em vez de retornar uma lista vazia. `limit` limita os candidatos (padrão 20, máximo 100); resultados inacessíveis são omitidos. Falhas de banco de dados ou autorização retornam erro, não uma lista vazia. |