OpenAI Agents SDK · agent runner


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.
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.
CAPTCHA aparece
O desafio aparece
Coletar
URL da página, chave do site e tipo de CAPTCHA
Resolver
Envie uma solicitação para CapSolver
Retorno
Resultado enviado de volta ao agente
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.
# 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)
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.
Testes de controle de qualidade autorizados
RPA aprovado
Fluxos de trabalho de dados públicos
Tarefas de agente autorizado pelo usuário
Automação revisada por conformidade
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.
Uso do navegador
Adicione CapSolver como uma ação para agentes de IA baseados em navegador.
LangChain
Use CapSolver como uma ferramenta que pode ser chamada em agentes LangChain.

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.
