OpenAI Agents SDK · agent runner


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.
Cómo funciona la resolución CAPTCHA
Cuando aparece un CAPTCHA compatible, el agente llama CapSolver y recibe el resultado necesario para continuar.
Aparece CAPTCHA
Aparece un desafío
Recolectar
URL de la página, clave del sitio y tipo CAPTCHA
Resolver
Enviar una solicitud a CapSolver
Devolver
Resultado enviado de vuelta al agente.
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.
# 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)
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.
Pruebas de QA autorizadas
RPA aprobado
Flujos de trabajo de datos públicos
Tareas de agentes autorizadas por el usuario
Automatización revisada conforme a la normativa
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.
Playwright
Agregar la resolución CAPTCHA a la automatización personalizada del navegador.
Browser Use
Agregar CapSolver como una acción para agentes de IA basados en navegador.
LangChain
Utilice CapSolver como una herramienta invocable en los agentes LangChain.

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.
