🎉NOVOCapSolver para agentes de IA
Selenium CAPTCHA solver landing page hero section with code snippet and CTA buttons
Selenium CAPTCHA solver landing page hero section with code snippet and CTA buttons

Automação de Agentes · SDK de Agentes OpenAI

Resolva CAPTCHAs em seu aplicativo OpenAI Agents SDK

Adicione CapSolver como uma ferramenta funcional para agentes habilitados para navegador. Quando um CAPTCHA compatível aparece, o agente pode ligar para o CapSolver, receber o resultado e continuar o fluxo de trabalho autorizado. As chamadas de ferramentas também podem ser revisadas por meio do rastreamento do SDK dos agentes.

OpenAI Agents SDK · agent runner

agent → browser.navigate("signup")
agent → form.fill(profile)
CAPTCHA detected
tool_call: solve_recaptcha()span: tools.solve_recaptcha · sitekey + page_url
token returned → agent.resume()
final_output: signup complete
CapSolver function tool

Solving captcha…

Como funciona a resolução de CAPTCHA

Quando aparece um CAPTCHA suportado, o agente chama o CapSolver e recebe o resultado necessário para continuar.

01

CAPTCHA aparece

O desafio aparece

02

Coletar

URL da página, chave do site e tipo de CAPTCHA

03

Resolver

Envie uma solicitação para CapSolver

04

Retorno

Resultado enviado de volta ao agente

05

Continuar

O agente retoma o fluxo de trabalho

Integração

Como o CapSolver se encaixa em um fluxo de trabalho de agente OpenAI

OpenAI Agents SDK gerencia o loop do agente e as chamadas da ferramenta de função. Uma ferramenta de navegador separada lida com as interações do site, enquanto o CapSolver processa solicitações CAPTCHA suportadas e retorna o resultado ao agente.

Componente

Função principal

Quando um CAPTCHA aparece

Agente OpenAI

Planeja a tarefa, seleciona ferramentas e gerencia o estado.

Decide quando chamar a ferramenta de função CapSolver.

Ferramenta de navegador

Navega, clica, digita e lê a página.

Fornece o contexto da página e continua as ações do navegador.

CapSolver

Processa solicitações CAPTCHA suportadas.

Retorna o resultado do CAPTCHA ao agente.

Rastreamento do SDK de agentes

Registra execuções de agentes e chamadas de ferramentas.

Ajuda a revisar atividades e erros da ferramenta.

Cobertura CAPTCHA

Quais tipos de CAPTCHA o CapSolver suporta para agentes OpenAI?

A cobertura atual inclui reCAPTCHA v2 e v3, incluindo variantes Enterprise, e Cloudflare Turnstile.

reCAPTCHA v2

Desafios padrão, invisíveis e corporativos do reCAPTCHA v2.

reCAPTCHA v3

Desafios baseados em pontuação e Enterprise reCAPTCHA v3 com suporte à ação.

Torniquete Cloudflare

Widgets de catraca gerenciados, não interativos e invisíveis.

Mais tipos de CAPTCHA

Explore tipos adicionais de tarefas CAPTCHA disponíveis por meio da API CapSolver.

Início rápido

Adicione CapSolver a um agente OpenAI como uma ferramenta de função

Embrulhe o CapSolver com@function_tool, adicione-o às ferramentas do seu agente e deixe o SDK dos agentes gerenciar o loop de chamada da ferramenta.

openai_agent.py
# pip install capsolver-agent openai-agents
# export CAPSOLVER_API_KEY=CAP-XXXXXX
# export OPENAI_API_KEY=sk-XXXXXX

import json
import os
from agents import Agent, Runner, function_tool, set_default_openai_api, set_tracing_disabled
from capsolver_agent.schema import create_executor
from _env import load_example_env  # demo only: reads repo-root .env

load_example_env()
set_tracing_disabled(True)
if os.environ.get("OPENAI_BASE_URL"):  # OpenAI-compatible gateway (DeepSeek, ...)
    set_default_openai_api("chat_completions")

executor = create_executor()  # wraps a capsolver-core engine; key from CAPSOLVER_API_KEY

@function_tool
async def solve_captcha(
    captcha_type: str,
    website_url: str,
    website_key: str,
    proxy: str | None = None,   # pass a proxy for proxy-bound challenges
) -> str:
    """Solve a captcha (reCaptchaV2 / reCaptchaV3 / cloudflare) and return the result as JSON.

    Call this whenever a page blocks the task with a CAPTCHA. Provide the
    captcha type, the page URL, and the site key from the challenge widget.
    """
    args = {"captcha_type": captcha_type, "website_url": website_url, "website_key": website_key}
    if proxy:
        args["proxy"] = proxy
    result = await executor.execute("solve_captcha", args)
    return json.dumps(result, ensure_ascii=False)

agent = Agent(
    name="captcha-agent",
    model=os.environ.get("OPENAI_MODEL", "gpt-4o"),
    instructions=(
        "You complete web tasks. When a page shows a CAPTCHA, call solve_captcha "
        "with the captcha type, page URL and site key, then continue."
    ),
    tools=[solve_captcha],
)

result = Runner.run_sync(
    agent,
    "Solve the reCaptchaV2 at https://www.google.com/recaptcha/api2/demo with site key "
    "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ- and report the first 40 characters of the token.",
)
print(result.final_output)
Este exemplo usa o modo token. Veja odocumentaçãopara ferramentas de navegador, parâmetros CAPTCHA e configuração de proxy.

Melhores práticas de produção

Melhores práticas para agentes OpenAI de produção

Mantenha as chaves de API seguras, transmita detalhes CAPTCHA precisos e rastreie todas as solicitações.

Área

Recomendação

Por que isso importa

Segurança da chave API

Armazene CAPSOLVER_API_KEY em variáveis de ambiente ou em um gerenciador de segredos.

Evita a exposição acidental de chaves em prompts, logs e repositórios.

Entradas de ferramentas

Use entradas claras para tipo de CAPTCHA, URL da página e chave do site.

Ajuda o agente a ligar para a ferramenta com as informações corretas.

Detalhes do CAPTCHA

Passe detalhes verificados do CAPTCHA do seu aplicativo ou ferramenta do navegador.

Impede que o modelo adivinhe os parâmetros da página.

Tempos limite e novas tentativas

Use a pesquisa de intervalo fixo com um tempo limite geral. Tente novamente os erros de HTTP separadamente.

Evita longas esperas e solicitações repetidas desnecessárias.

Registro e rastreamento

Use o rastreamento do SDK de agentes para chamadas de ferramentas e registre taskId, status e erros.

Facilita a depuração e o suporte.

Tratamento de falhas

Retorne um erro claro e pause o fluxo de trabalho após falhas repetidas.

Evita novas tentativas cegas e loops inesperados do agente.

Casos de uso mais adequados

Criado para equipes B2B que executam agentes OpenAI em produção

Automação de vendas

Apoie pesquisas aprovadas e fluxos de trabalho de CRM usando dados comerciais públicos ou fornecidos pelo usuário.

Tecnologia de RH

Apoie fluxos de trabalho de recrutamento autorizados em sistemas de empregos e candidatos aprovados.

Ferramentas de controle de qualidade e teste

Teste fluxos de trabalho de inscrição, checkout e formulários que encontrem CAPTCHAs compatíveis.

RegTech e conformidade

As verificações de registros públicos e os fluxos de trabalho de coleta de evidências precisam de registros confiáveis ​​e de auditoria.

Automação de Pesquisa

Ajude os agentes de pesquisa a coletar informações públicas da web quando um CAPTCHA compatível aparecer.

RPA Interna

Dê suporte a fluxos de trabalho internos autorizados pelo usuário que exigem resolução de CAPTCHA.

Uso responsável

Construído para automação legal e autorizada

CapSolver foi projetado para automação responsável, incluindo testes de controle de qualidade autorizados, RPA aprovado, fluxos de trabalho de dados públicos e tarefas de agentes autorizados pelo usuário. Os usuários devem seguir as leis aplicáveis, os termos do site, os requisitos de privacidade e os limites de taxas. CapSolver não oferece suporte a acesso não autorizado ou automação maliciosa.

01

Testes de controle de qualidade autorizados

02

RPA aprovado

03

Fluxos de trabalho de dados públicos

04

Tarefas de agente autorizado pelo usuário

05

Automação revisada por conformidade

06

Automação focada em acessibilidade

Perguntas frequentes

Integrações Relacionadas

Explore mais integrações CapSolver para sua pilha de agentes

Escolha outra integração para adicionar solução CAPTCHA ao fluxo de trabalho do seu agente ou navegador.

01

Servidor MCP

Conecte o CapSolver a outros clientes que suportam ferramentas MCP.

Ver Integração
02

Dramaturgo

Adicione resolução CAPTCHA à automação personalizada do navegador.

Ver Integração
03

Uso do navegador

Adicione CapSolver como uma ação para agentes de IA baseados em navegador.

Ver Integração
04

LangChain

Use CapSolver como uma ferramenta que pode ser chamada em agentes LangChain.

Ver Integração

Adicione a solução CAPTCHA ao seu aplicativo OpenAI Agents SDK

Comece com uma avaliação gratuita, adicione CapSolver como uma ferramenta funcional e siga o guia de integração.