> For the complete documentation index, see [llms.txt](https://developers.oxylabs.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.oxylabs.io/products/pt-br/ai-studio/ai-map.md).

# AI-Map

Saiba como mapear e explorar domínios de forma inteligente para encontrar URLs relevantes.

## Visão geral

AI-Map ajuda você a descobrir páginas relevantes em um site. Ele usa IA para explorar domínios de forma sistemática com base nos seus critérios específicos e retorna uma lista de URLs que correspondem aos seus critérios.

Você pode visualizar a ferramenta [**aqui**](https://aistudio.oxylabs.io/apps/search) e integrá-la aos seus fluxos de trabalho por meio dos nossos SDKs Python/JavaScript, servidor MCP ou uma de nossas integrações de terceiros.

## Como usar

1. **Insira uma URL ou domínio** que você quer mapear.
2. **Descreva suas páginas-alvo** com um prompt em linguagem natural.
3. **Configure os parâmetros de mapeamento** como limite de fontes, profundidade de mapeamento e geolocalização.
4. **Execute a tarefa de mapeamento com IA** para coletar URLs das suas páginas-alvo do domínio.

### Instalação

Para começar, certifique-se de que você tenha acesso a uma chave de API (ou [obtenha uma avaliação gratuita](https://aistudio.oxylabs.io/register) com 1000 créditos) e `Python 3.10` ou superior instalado. Você pode instalar o `oxylabs-ai-studio` pacote usando pip:

```
pip install oxylabs-ai-studio
```

### Exemplo de código (Python)

O exemplo a seguir mostra como usar um agente de busca AI-Map para executar uma tarefa simples de mapeamento de site.

```python
from oxylabs_ai_studio.apps.ai_map import AiMap
import json

# Inicialize a autorização
ai_map = AiMap(api_key="<API_KEY>")

# Defina o payload da requisição
payload = {
    "url": "https://career.oxylabs.io",
    "user_prompt": "job ad pages",
    "return_sources_limit": 10,
    "geo_location": None,
    "render_javascript": False,
}

# Inicie o mapeamento
result = ai_map.map(**payload)

# Exiba os resultados em JSON
print("URLs:")
print(json.dumps(result.data, indent=2))
```

Saiba mais sobre AI-Crawler e o SDK Python da Oxylabs AI Studio em nosso [repositório PyPI](https://pypi.org/project/oxylabs-ai-studio/). Você também pode conferir nosso [SDK JavaScript da AI Studio](broken://pages/a1c9f9159a2e0311501f1107f389ef3517434cfd) guia para usuários de JS.

### Parâmetros da requisição

| Parâmetro                                                  | Descrição                                                 | Valor padrão |
| ---------------------------------------------------------- | --------------------------------------------------------- | ------------ |
| <mark style="background-color:green;">`url`</mark>         | URL ou domínio inicial para mapeamento                    | –            |
| <mark style="background-color:green;">`user_prompt`</mark> | Prompt em linguagem natural para páginas a encontrar      | –            |
| `output_format`                                            | Número máximo de fontes a retornar                        | `25`         |
| `render_javascript`                                        | Ative a renderização de JavaScript para conteúdo dinâmico | `False`      |
| `geo_location`                                             | Localização do proxy no formato ISO2                      | –            |

– parâmetros obrigatórios

### Exemplo de saída

```json
URLs:
[
  "https://career.oxylabs.io/job/247ac098/head-of-marketing",
  "https://career.oxylabs.io/job/2d9ae321/product-owner",
  "https://career.oxylabs.io/job/496841ed/php-developer-golang",
  "https://career.oxylabs.io/job/736ef009/talent-sourcer",
  "https://career.oxylabs.io/job/7a4a4415/senior-python-engineer-webshare-product",
  "https://career.oxylabs.io/job/88f7340c/devops-squad-lead",
  "https://career.oxylabs.io/job/9946db47/junior-project-manager",
  "https://career.oxylabs.io/job/b2e1397e/account-executive-north-america",
  "https://career.oxylabs.io/job/d72db15b/senior-event-marketing-manager",
  "https://career.oxylabs.io/job/e1efecf0/seo-and-growth-marketing-lead"
]
```

## Casos de uso práticos

* **Mapeamento de categorias de produtos** em sites de e-commerce.
* **Listar todas as postagens do blog** do domínio de uma empresa.
* **Documentação de API** endpoints.
* **Descobrir todas as páginas de documentação** ou artigos de ajuda.
* **Encontrar vagas de emprego** em portais de carreiras.
* **E muito mais…**


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://developers.oxylabs.io/products/pt-br/ai-studio/ai-map.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.