Automação de Navegador Skyvern -- Procedimento de Julgamento CLI

Skyvern usa IA para navegar e interagir com sites. Cada comando abaixo é uma invocação executável de skyvern <command>.

Quando Usar Esta Habilidade

• Use quando precisar de automação de navegador assistida por IA para navegação, extração, preenchimento de formulários, fluxos de login ou fluxos de trabalho de sites reutilizáveis.
• Use quando seletores determinísticos não estiverem disponíveis e o raciocínio visual/a11y do Skyvern puder identificar controles da página.
• Use quando uma tarefa de navegador única se tornar um fluxo de trabalho repetível com histórico de execução e verificação.

Etapa 1: Classifique Sua Tarefa (SEMPRE faça isso primeiro)

Nota MCP: se você estiver usando o Skyvern MCP em vez do CLI, prefira observe + execute para trabalhos de UI de várias etapas na mesma página. O CLI não expõe esse par diretamente.

Etapa 2: Aplique Estas Regras de Decisão

1. Se o prompt incluir um seletor, ID, XPath ou alvo de campo exato, use primitivas do navegador -- não act.
2. Se você precisar apenas de uma resposta sim/não, use validate -- não extract ou act.
3. Se o trabalho permanecer em uma página e os rótulos forem claros, use act ou uma cadeia primitiva.
4. Se o usuário disser try this once, see if this works, ou claramente quiser uma tentativa exploratória única, use run-task.
5. Se a tarefa abranger várias páginas e for destinada a ser reutilizável, agendada, repetível ou explicitamente set up como automação, use workflow create.
6. Nunca digite senhas. Sempre use credenciais armazenadas com skyvern browser login.

Etapa 3: Crie uma Sessão

Todo comando do navegador precisa de uma sessão. Crie uma primeiro:

# Cloud session (default -- works for public URLs)
skyvern browser session create --timeout 30

# Local session (for localhost URLs or self-hosted mode)
skyvern browser session create --local --timeout 30

# Connect to existing browser via CDP
skyvern browser session connect --cdp "ws://localhost:9222"

O estado da sessão persiste entre os comandos. Após session create, os comandos subsequentes se anexam automaticamente. Substitua com --session pbs_.... Feche quando terminar: skyvern browser session close.

Etapa 4: Execute por Classificação

Verificação rápida (sim/não)

skyvern browser validate --prompt "Is the user logged in? Look for a dashboard or avatar."

Retorna verdadeiro/falso. Opção de IA mais barata -- prefira sobre extrair ou agir para verificações booleanas.

Inspeção rápida

skyvern browser extract \
  --prompt "Extract all product names and prices" \
  --schema '{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"price":{"type":"string"}}}}}}'

Usa capturas de tela + LLM de extração dedicado. Melhor do que captura de tela+leitura porque o LLM do Skyvern interpreta a página.

Ação única (alvo conhecido)

skyvern browser click --selector "#submit-btn"
skyvern browser type --text "user@co.com" --selector "#email"
skyvern browser select --value "US" --intent "the country dropdown"

Determinístico. Sem IA. Três modos de segmentação:

…