# AI-Map

## Visão geral

AI-Map ajuda você a descobrir páginas relevantes dentro de 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 de Python/JavaScript, servidor MCP ou uma das nossas integrações de terceiros.

## Como usar

1. **Digite 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 do mapeamento e geolocalização.
4. **Execute a tarefa de mapeamento com IA** para coletar URLs das suas páginas-alvo no domínio.

### Instalação

Para começar, certifique-se de que você tem acesso a uma chave de API (ou [obtenha um teste gratuito](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 realizar uma tarefa simples de mapeamento de site.

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

# Initialize authorization
ai_map = AiMap(api_key="<API_KEY>")

# Define the payload for request
payload = {
    "url": "https://career.oxylabs.io",
    "user_prompt": "job ad pages",
    "return_sources_limit": 10,
    "geo_location": None,
    "render_javascript": False,
}

# Start the mapping
result = ai_map.map(**payload)

# Output the results in JSON
print("URLs:")
print(json.dumps(result.data, indent=2))
```

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

### Parâmetros da solicitaçã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 as páginas a encontrar     | –            |
| `output_format`                                            | Número máximo de fontes a retornar                          | `25`         |
| `render_javascript`                                        | Habilitar renderização de JavaScript para conteúdo dinâmico | `False`      |
| `geo_location`                                             | Localização do proxy no formato ISO2                        | –            |

&#x20;    – 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** de um domínio de empresa.
* **Documentação de endpoints de API** .
* **Descobrir todas as páginas de documentação** ou artigos de ajuda.
* **Encontrar vagas de emprego** em portais de carreira.
* **E muito mais…**


---

# Agent Instructions: 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:

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

The question should be specific, self-contained, and written in natural language.
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.