Langchain •agent runner


Automação de Agentes · LangChain
Adicione CapSolver ao seu agente LangChain – resolva CAPTCHAs em uma chamada de ferramenta
CapSolver Agent adiciona LangChain BaseTools prontos via get_langchain_tools() ao seu agente ReAct ou LangGraph. Quando um CAPTCHA aparece, ele chama o solucionador, obtém um token e continua – alimentado por um SDK nativo para LangChain, ferramentas de navegador e MCP.
Fluxo de trabalho do agente CAPTCHA
Detectar
CAPTCHA ou verificação aparece
Extrair
URL, chave do site, metadados
Resolver
Tarefa CapSolver
Retorno
Solução devolvida ao agente
Continuar
O agente retoma o fluxo de trabalho
Adicione resolução CAPTCHA aos seus agentes LangChain
Criado para loops de agente
Um solucionador LangChain CAPTCHA é útil quando um fluxo de trabalho de agente atinge sites reais e pode ser interrompido pela validação de tráfego ou desafios de CAPTCHA.
Padrão nativo da ferramenta
Exponha o CapSolver como uma ferramenta LangChain que pode ser chamada com entradas claras, para que o agente possa solicitar a resolução de CAPTCHA apenas quando necessário.
Recuperação da produção
Lide com novas tentativas, erros, IDs de solicitação e tempos limite sem interromper o fluxo de trabalho do agente.
Limites claros da ferramenta
Seu agente controla o fluxo de trabalho. CapSolver trata da tarefa de resolução e retorna o resultado.
Por que os agentes LangChain precisam de recuperação CAPTCHA na produção
LangChain foi projetado para agentes que agem por meio de ferramentas. Em fluxos de trabalho de automação de navegador, esse ciclo é frequentemente interrompido pelo reCAPTCHA ou Cloudflare Turnstile. A solução certa não é transformar o CapSolver em uma estrutura de agente – é tornar o CapSolver a camada de infraestrutura CAPTCHA pronta para agente que todo agente de navegador do mundo real pode chamar quando necessário.
Camada de fluxo de trabalho
Função no fluxo de trabalho LangChain
O que CapSolver adiciona
Agente LangChain
Planeja a tarefa, seleciona ferramentas e mantém o estado.
Uma ferramenta de recuperação CAPTCHA que pode ser chamada somente quando necessário.
API CapSolver
Cria tarefas específicas para desafios e retorna soluções.
Lida com reCAPTCHA v2/v3, Cloudflare Challenge/Turnstile e outros desafios suportados por meio da API.
Observabilidade
Rastreia chamadas de ferramentas, erros e status do fluxo de trabalho
IDs de tarefas CAPTCHA, tipo de desafio, status de resolução e códigos de erro/novas tentativas.
Arquitetura
Mantenha as responsabilidades claras: LangChain orquestra, CapSolver resolve CAPTCHAs
Use CapSolver como uma ferramenta focada em seu fluxo de trabalho LangChain. O agente fornece o URL do site, a chave do site e os detalhes do desafio. A ferramenta cria uma tarefa, verifica o resultado e retorna a solução. LangChain gerencia o fluxo de trabalho do agente, enquanto CapSolver cuida da resolução de CAPTCHA.
Detectar
Um desafio CAPTCHA está presente na página de destino.
Extrair
Colete websiteURL, websiteKey e tipo de desafio.
Criar
Chame CapSolver createTask com o objeto de tarefa correto.
Enquete
Verifique getTaskResult até que a tarefa esteja pronta ou expire. Use atrasos de repetição para erros de limite de taxa.
Continuar
A ferramenta retorna um token estruturado e o agente LangChain retoma a tarefa original.
Observe
Registre o ID da tarefa, o status e os códigos/novas tentativas de erro.
Início rápido
Crie uma ferramenta Python LangChain com a API CapSolver
Enrole o CapSolvercreateTask+getTaskResultem uma ferramenta: entra informação estruturada, sai um resultado estruturado. A pesquisa usa um intervalo fixo com um tempo limite geral.
# pip install "capsolver-agent[langchain]" langchain-openai langgraph
# export CAPSOLVER_API_KEY=CAP-XXXXXX
# export OPENAI_API_KEY=sk-XXXXXX
import asyncio
import os
from langchain_core.tools import tool
from langchain_openai import ChatOpenAI
from langgraph.prebuilt import create_react_agent
from capsolver_agent.schema import create_executor
from _env import load_example_env # demo only: reads repo-root .env
load_example_env()
# 1. Wrap CapSolver as one LangChain tool.
# createTask + result polling are handled inside capsolver-agent.
executor = create_executor() # key from CAPSOLVER_API_KEY
@tool
async def solve_captcha(captcha_type: str, website_url: str, website_key: str) -> dict:
"""Solve a captcha (reCaptchaV2 / reCaptchaV3 / cloudflare) and return its token.
captcha_type: captcha family, e.g. reCaptchaV2
website_url: full URL of the page that loads the captcha
website_key: site key found on that page
"""
result = await executor.execute(
"solve_captcha",
{"captcha_type": captcha_type, "website_url": website_url, "website_key": website_key},
)
if not result.get("success"):
return {"ok": False, "error": result.get("error", "unknown error")}
return {"ok": True, "token": result["solution"]["token"]}
# 2. Any OpenAI-compatible chat model works; the LLM decides when to call the tool.
llm = ChatOpenAI(model=os.environ.get("OPENAI_MODEL", "gpt-4o"), temperature=0)
# 3. Give the tool to a ReAct agent.
agent = create_react_agent(llm, [solve_captcha])
# 4. Run.
PROMPT = (
"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."
)
result = asyncio.run(agent.ainvoke({"messages": [("user", PROMPT)]}))
print(result["messages"][-1].content)
Adicione as ferramentas a um agente LangChain
get_langchain_tools()retorna BaseTools padrão que ficam ao lado do navegador, extração de dados ou ferramentas de fluxo de trabalho que seu agente já usa.
# pip install "capsolver-agent[langchain]" langchain-openai langgraph
# export CAPSOLVER_API_KEY=CAP-XXXXXX
# export OPENAI_API_KEY=sk-XXXXXX
import asyncio
import os
from langchain_openai import ChatOpenAI
from langgraph.prebuilt import create_react_agent
from capsolver_agent.langchain_tools import get_langchain_tools
from _env import load_example_env # demo only: reads repo-root .env
load_example_env()
# CapSolver's ready-made LangChain BaseTools, backed by capsolver-core:
# solve_captcha, detect_captchas, solve_on_page, get_balance, get_supported_captchas
tools = get_langchain_tools(api_key=os.environ["CAPSOLVER_API_KEY"])
llm = ChatOpenAI(model=os.environ.get("OPENAI_MODEL", "gpt-4o"), temperature=0)
# The solver tools sit beside the browser / data / workflow tools your agent already uses
agent = create_react_agent(llm, tools)
result = asyncio.run( # CapSolver tools are async, so use ainvoke
agent.ainvoke(
{
"messages": [
{
"role": "user",
"content": "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["messages"][-1].content)
e importe as ferramentas diretamente – nenhum pacote JavaScript ou TypeScript é necessário.
Melhores práticas de produção
Crie soluções CAPTCHA prontas para produção para agentes LangChain
01
Gerenciamento secreto
Armazene CAPSOLVER_API_KEY em variáveis de ambiente ou em um gerenciador de segredos.
Por que
Evita a exposição acidental de chaves em prompts, logs e repositórios.
02
Esquema de ferramenta
Mantenha a entrada da ferramenta restrita e digitada (website_url, website_key).
Por que
Reduz a confusão do modelo e a geração de argumentos inseguros.
03
Detecção
Leia o tipo de desafio e a chave do site no contexto da página.
Por que
O modelo não deve adivinhar os parâmetros da página a partir do texto bruto.
04
Enquete e tente novamente
Verifique o status da tarefa em intervalos definidos e pare após um tempo limite. Tente novamente erros de API com espera.
Por que
Evita loops desnecessários de carga e agente descontrolado.
05
Registro
Registre task_id, tipo de desafio, status e códigos de erro/novas tentativas.
Por que
Facilita a depuração e o suporte.
06
Tratamento de erros
Evite falhas repetidas e envie a tarefa para revisão humana quando necessário.
Por que
Evita novas tentativas cegas em fluxos de trabalho sensíveis ou incertos.
07
Conformidade
Revise os termos do site, autorização do usuário, requisitos de privacidade e limites de taxas.
Por que
Mantém a automação alinhada com os casos de uso aprovados.
Ajuste ao ecossistema
CapSolver funciona com a infraestrutura do seu navegador – ele não a substitui
01
Base do navegador / Aço
02
Dramaturgo / Marionetista
03
LangChain / LangGraph
Trabalho principal
Execução de navegador hospedado e gerenciamento de sessão.
Controle do navegador e interação DOM.
Orquestração de agentes e uso de ferramentas.
Sem CapSolver
A sessão do navegador pode continuar em execução, mas um CAPTCHA pode interromper o fluxo de trabalho.
A automação pode detectar e interagir com a página, mas ainda precisa de lógica de resolução de CAPTCHA.
O agente pode chamar ferramentas, mas não possui nenhuma ferramenta integrada para resolver CAPTCHAs.
Com CapSolver
CapSolver lida com a tarefa CAPTCHA enquanto a sessão do navegador permanece ativa.
A automação envia os dados do desafio para o CapSolver e utiliza a solução retornada.
O agente chama o CapSolver como ferramenta e continua o fluxo de trabalho com o resultado.
Casos de uso mais adequados
Criado para equipes de agentes B2B que executam fluxos de trabalho de navegador em produção
Automação de vendas
A pesquisa de vendas autorizada e os fluxos de trabalho de CRM podem encontrar CAPTCHA ou verificações de verificação durante as tarefas do navegador.
Tecnologia de RH
Os fluxos de trabalho de recrutamento aprovados podem ser pausados quando a verificação aparece durante tarefas de navegação em várias etapas.
Ferramentas de controle de qualidade e teste
Testes ponta a ponta para inscrição, checkout e formulários precisam de um tratamento claro de CAPTCHA para reduzir falhas nas execuções de testes.
RegTech e conformidade
As verificações de registros públicos e os fluxos de trabalho de coleta de evidências precisam de confiabilidade, registros de auditoria e comportamento alternativo claro.
Automação de Pesquisa
Os fluxos de trabalho de dados públicos autorizados podem ser pausados quando uma fonte mostra um CAPTCHA ou uma verificação de verificação.
RPA Interna
Fluxos de trabalho repetitivos autorizados pelo usuário se beneficiam de uma camada de recuperação CAPTCHA clara quando a validação de tráfego bloqueia uma tarefa.
Uso responsável
Use CapSolver para automação legal e legal
CapSolver destina-se a usos legais e autorizados, incluindo testes de controle de qualidade aprovados, RPA interno, tarefas de agentes autorizados pelo usuário e fluxos de trabalho de dados públicos compatíveis. Antes de automatizar um site, revise seus termos, regras de privacidade aplicáveis, limites de taxas e requisitos de conformidade da sua organização.
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 de comércio eletrônico
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.
SDK de agentes OpenAI
Adicione resolução CAPTCHA por meio de ferramentas funcionais e fluxos de trabalho de agentes.

Se o seu agente LangChain funciona em demonstrações, mas para na produção, adicione uma camada de recuperação CAPTCHA.
Comece com o wrapper da ferramenta acima, revise a documentação do CapSolver e entre em contato com a equipe quando precisar de suporte empresarial, volume maior ou um caminho de integração SDK nativo.
