🎉NUEVOCapSolver 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

Automatización de agentes · OpenAI Agents SDK

Resuelve CAPTCHAs en tu aplicación OpenAI Agents SDK

Agregue CapSolver como una herramienta funcional para agentes habilitados para navegador. Cuando aparezca un CAPTCHA compatible, el agente puede llamar CapSolver, recibir el resultado y continuar con el flujo de trabajo autorizado. Las llamadas a la herramienta también se pueden revisar mediante el seguimiento Agents SDK.

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…

Cómo funciona la resolución CAPTCHA

Cuando aparece un CAPTCHA compatible, el agente llama CapSolver y recibe el resultado necesario para continuar.

01

Aparece CAPTCHA

Aparece un desafío

02

Recolectar

URL de la página, clave del sitio y tipo CAPTCHA

03

Resolver

Enviar una solicitud a CapSolver

04

Devolver

Resultado enviado de vuelta al agente.

05

Continuar

El agente reanuda el flujo de trabajo.

Integración

Cómo se integra CapSolver en el flujo de trabajo de un agente de OpenAI

OpenAI Agents SDK gestiona el bucle del agente y las llamadas a las herramientas de funciones. Una herramienta de navegador independiente se encarga de las interacciones con los sitios web, mientras que CapSolver procesa las solicitudes CAPTCHA compatibles y devuelve el resultado al agente.

Componente

Función principal

Cuando aparece un CAPTCHA

Agente de OpenAI

Planifica la tarea, selecciona las herramientas y gestiona el estado.

Decide cuándo llamar a la herramienta de función CapSolver.

Herramienta de navegador

Navega, hace clic, escribe y lee la página.

Proporciona el contexto de la página y continúa con las acciones del navegador.

CapSolver

Procesa solicitudes de CAPTCHA compatibles.

Devuelve el resultado CAPTCHA al agente.

Rastreo Agents SDK

Registra las ejecuciones del agente y las llamadas a la herramienta.

Ayuda a revisar la actividad y los errores de la herramienta.

Cobertura CAPTCHA

¿Qué tipos CAPTCHA admite CapSolver para los agentes de OpenAI?

La cobertura actual incluye reCAPTCHA v2 y v3, incluidas las variantes Enterprise, y Cloudflare Turnstile.

reCAPTCHA v2

Desafíos reCAPTCHA v2 estándar, invisible y empresarial.

reCAPTCHA v3

Desafíos reCAPTCHA v3 empresariales y basados en puntuación con soporte para acciones.

Cloudflare Turnstile

Widgets de Turnstile gestionados, no interactivos e invisibles.

Más tipos CAPTCHA

Explore otros tipos de tareas CAPTCHA disponibles a través de la API CapSolver.

Inicio rápido

Agregar CapSolver a un agente de OpenAI como herramienta de función

Encapsule CapSolver con@function_tool, agréguelo a las herramientas de su agente y deje que Agents SDK gestione el bucle de llamadas a herramientas.

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 ejemplo utiliza el modo token. Consulte ladocumentaciónpara obtener información sobre las herramientas de navegador, los parámetros de CAPTCHA y la configuración del proxy.

Mejores prácticas de producción

Mejores prácticas para agentes de OpenAI en producción

Mantenga las claves API seguras, proporcione detalles CAPTCHA precisos y realice un seguimiento de cada solicitud.

Área

Recomendación

Por qué es importante

Seguridad de la clave API

Almacene CAPSOLVER_API_KEY en variables de entorno o en un gestor de secretos.

Evita la exposición accidental de claves en mensajes, registros y repositorios.

Entradas de la herramienta

Utilice entradas claras para el tipo de CAPTCHA, la URL de la página y la clave del sitio.

Ayuda al agente a llamar a la herramienta con la información correcta.

Detalles CAPTCHA

Proporcione los detalles CAPTCHA verificados desde su aplicación o herramienta de navegador.

Impide que el modelo adivine los parámetros de la página.

Tiempos de espera y reintentos

Utilice sondeos a intervalos fijos con un tiempo de espera general. Reintente los errores HTTP por separado.

Evita largas esperas y solicitudes repetidas innecesarias.

Registro y seguimiento

Utilice el seguimiento Agents SDK para las llamadas a herramientas y registre taskId, el estado y los errores.

Facilita la depuración y el soporte técnico.

Manejo de fallas

Devuelve un mensaje de error claro y pausa el flujo de trabajo tras varios fallos.

Evita reintentos a ciegas y bucles inesperados del agente.

Casos de uso más adecuados

Diseñado para equipos B2B que utilizan agentes de OpenAI en producción.

Automatización de ventas

Brindar soporte a los flujos de trabajo de investigación y CRM aprobados, utilizando datos comerciales públicos o proporcionados por el usuario.

Tecnología de Recursos Humanos

Brindar soporte a los flujos de trabajo de reclutamiento autorizados en todos los sistemas de empleo y candidatos aprobados.

Herramientas de QA y pruebas

Pruebe los flujos de registro, pago y formularios que encuentran CAPTCHAs compatibles.

RegTech y Cumplimiento

Los procesos de verificación de registros públicos y de recopilación de pruebas necesitan fiabilidad y registros de auditoría.

Automatización de la investigación

Ayudar a los agentes de investigación a recopilar información web pública cuando aparezca un CAPTCHA compatible.

RPA interna

Admite flujos de trabajo internos autorizados por el usuario que requieren la resolución CAPTCHA.

Uso responsable

Diseñado para la automatización legal y autorizada.

CapSolver está diseñado para la automatización responsable, incluyendo pruebas QA autorizadas, RPA aprobada, flujos de trabajo con datos públicos y tareas de agentes autorizadas por el usuario. Los usuarios deben cumplir con las leyes aplicables, los términos del sitio web, los requisitos de privacidad y los límites de uso. CapSolver no admite el acceso no autorizado ni la automatización maliciosa.

01

Pruebas de QA autorizadas

02

RPA aprobado

03

Flujos de trabajo de datos públicos

04

Tareas de agentes autorizadas por el usuario

05

Automatización revisada conforme a la normativa

06

Automatización centrada en la accesibilidad

Preguntas frecuentes

Integraciones relacionadas

Explore más integraciones de CapSolver para su conjunto de herramientas de agentes

Elija otra integración para agregar la resolución CAPTCHA al flujo de trabajo de su agente o navegador.

01

Servidor MCP

Conecte CapSolver con otros clientes que admitan herramientas MCP.

Ver integración
02

Playwright

Agregar la resolución CAPTCHA a la automatización personalizada del navegador.

Ver integración
03

Browser Use

Agregar CapSolver como una acción para agentes de IA basados en navegador.

Ver integración
04

LangChain

Utilice CapSolver como una herramienta invocable en los agentes LangChain.

Ver integración

Agrega la resolución CAPTCHA a tu aplicación OpenAI Agents SDK

Comience con una prueba gratuita, agregue CapSolver como herramienta de funciones y siga la guía de integración.