> 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/headless-browser/ai-workflows/agent-skills.md).

# Habilidades do Agente

Configure ferramentas de IA e assistentes de código com as Habilidades do Agente oficiais para Oxylabs Headless Browser.

Habilidades do Agente da Oxylabs (`skills.md`) ensinam LLMs e assistentes de codificação de IA a configurar e interagir com produtos da Oxylabs.

As Agent Skills para Oxylabs Headless Browser vão ajudar seu modelo a controlar sessões remotas de navegador sem interface via Chrome DevTools Protocol (CDP), configurar fingerprints do navegador, lidar com rotação de proxy e gerenciar automação com Playwright ou Puppeteer sem alucinações de sintaxe ou parâmetros.

## Instalação

### Claude Code (marketplace de plugins)

No Claude Code, execute os seguintes comandos:

```
/plugin marketplace add oxylabs/agent-skills
/plugin install oxylabs@oxylabs-agent-skills
```

Isso instala todas as 5 skills como um único plugin:

* [`skills/proxies`](https://github.com/oxylabs/agent-skills/blob/main/skills/proxies/SKILL.md)
* [`skills/web-unblocker`](https://github.com/oxylabs/agent-skills/blob/main/skills/web-unblocker/SKILL.md)
* [`skills/web-scraper-api`](https://github.com/oxylabs/agent-skills/blob/main/skills/web-scraper-api/SKILL.md)
* [`skills/headless-browser`](https://github.com/oxylabs/agent-skills/blob/main/skills/headless-browser/SKILL.md)
* [`skills/video-data`](https://github.com/oxylabs/agent-skills/blob/main/skills/video-data/SKILL.md)

Para atualizar as skills, execute este comando:

```
/plugin marketplace update oxylabs-agent-skills
```

### Outros agentes (genéricos)

Para outros agentes e ambientes personalizados, carregue o repositório em seu workspace do projeto por meio da CLI padrão de skills:

```
npx skills add https://github.com/oxylabs/agent-skills.git
```

## Configuração

Todas as Oxylabs Agent Skills se autenticam por meio de variáveis de ambiente definidas em um `.env` arquivo. Para usar as habilidades do Headless Browser, adicione estas chaves ao seu `.env` arquivo:

| Variável          | Descrição                                          |
| ----------------- | -------------------------------------------------- |
| `OXY_HB_USERNAME` | Seu usuário do Headless Browser `nome de usuário`. |
| `OXY_HB_PASSWORD` | Seu usuário do Headless Browser `senha`.           |

## Como usar

Assim que a skill estiver ativa na sua área de trabalho, você pode pedir ao seu assistente de IA para criar interações automatizadas com o navegador usando Oxylabs Headless Browser.

* **Exemplo 1:** "Escreva um script Python usando `playwright` para se conectar via CDP ao Oxylabs Headless Browser, navegar até um site dinâmico em JavaScript e extrair o HTML renderizado."
* **Exemplo 2:** "Crie um script Node.js usando `puppeteer` que inicializa uma sessão adaptativa do navegador Firefox via Oxylabs Headless Browser a partir de `US` geolocalização."
* **Exemplo 3:** "Gere uma rotina de automação de navegador que abre `example.com`, interage com elementos dinâmicos na página e salva uma captura de tela de página inteira."

## Mais Habilidades do Agente da Oxylabs

Saiba mais sobre as Habilidades do Agente para outras soluções da Oxylabs:

* [Proxies](/products/pt-br/proxies/residential-proxies/agent-skills.md)
* [Web Scraper API](/products/pt-br/web-scraper-api/solutions-for-ai-workflows/agent-skills.md)
* [Web Unblocker](/products/pt-br/web-unblocker/agent-skills.md)
* [Dados de vídeo](/products/pt-br/proxies/high-bandwidth-proxies.md#agent-skills)


---

# 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/headless-browser/ai-workflows/agent-skills.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.