Langchain •agent runner


Otomatisasi Agen · LangChain
Tambahkan CapSolver ke agen LangChain Anda — selesaikan CAPTCHA dalam satu panggilan alat
Agen CapSolver menambahkan LangChain BaseTools yang sudah jadi melalui get_langchain_tools() ke agen ReAct atau LangGraph Anda. Saat CAPTCHA muncul, ia memanggil pemecah, mendapatkan token, dan melanjutkan—didukung oleh SDK asli untuk LangChain, alat browser, dan MCP.
Alur kerja agen CAPTCHA
Deteksi
CAPTCHA atau verifikasi muncul
Ekstrak
URL, kunci situs, metadata
Memecahkan
tugas CapSolver
Kembali
Solusi dikembalikan ke agen
Lanjutkan
Agen melanjutkan alur kerja
Tambahkan penyelesaian CAPTCHA ke agen LangChain Anda
Dibuat untuk loop agen
Pemecah CAPTCHA LangChain berguna ketika alur kerja agen menyentuh situs web nyata dan dapat dihentikan oleh validasi lalu lintas atau tantangan CAPTCHA.
Pola asli alat
Ekspos CapSolver sebagai alat LangChain yang dapat dipanggil dengan masukan yang jelas, sehingga agen dapat meminta penyelesaian CAPTCHA hanya saat diperlukan.
Pemulihan produksi
Tangani percobaan ulang, kesalahan, ID permintaan, dan batas waktu tanpa merusak alur kerja agen.
Batasan alat yang jelas
Agen Anda mengontrol alur kerja. CapSolver menangani tugas penyelesaian dan mengembalikan hasilnya.
Mengapa agen LangChain memerlukan pemulihan CAPTCHA dalam produksi
LangChain dirancang untuk agen yang mengambil tindakan melalui alat. Dalam alur kerja otomatisasi browser, loop ini sering diinterupsi oleh reCAPTCHA atau Cloudflare Turnstile. Solusi yang tepat adalah dengan tidak mengubah CapSolver menjadi kerangka kerja agen — melainkan menjadikan CapSolver sebagai lapisan infrastruktur CAPTCHA yang siap untuk agen yang dapat dihubungi oleh setiap agen browser dunia nyata bila diperlukan.
Lapisan Alur Kerja
Berperan dalam alur kerja LangChain
Apa yang ditambahkan CapSolver
Agen LangChain
Merencanakan tugas, memilih alat, dan memelihara status.
Alat pemulihan CAPTCHA yang dapat dipanggil dan hanya dapat dipanggil bila diperlukan.
API CapSolver
Menciptakan tugas khusus tantangan dan mengembalikan solusi.
Menangani reCAPTCHA v2/v3, Cloudflare Challenge / Turnstile, dan tantangan lain yang didukung melalui API.
Observabilitas
Melacak panggilan alat, kesalahan, dan status alur kerja
ID tugas CAPTCHA, jenis tantangan, status penyelesaian, dan kode kesalahan/percobaan ulang.
Arsitektur
Jaga tanggung jawab tetap jelas: LangChain mengatur, CapSolver memecahkan CAPTCHA
Gunakan CapSolver sebagai alat terfokus dalam alur kerja LangChain Anda. Agen memberikan URL situs web, kunci situs, dan detail tantangan. Alat ini membuat tugas, memeriksa hasilnya, dan mengembalikan solusi. LangChain mengelola alur kerja agen, sementara CapSolver menangani penyelesaian CAPTCHA.
Deteksi
Tantangan CAPTCHA hadir di halaman target.
Ekstrak
Kumpulkan URL situs web, Kunci situs web, dan jenis tantangan.
Buat
Panggil CapSolver createTask dengan objek tugas yang benar.
Jajak pendapat
Periksa getTaskResult hingga tugas siap atau waktu habis. Gunakan penundaan percobaan ulang untuk kesalahan batas kecepatan.
Lanjutkan
Alat ini mengembalikan token terstruktur dan agen LangChain melanjutkan tugas awal.
Amati
Catat ID tugas, status, dan kode kesalahan/percobaan ulang.
Mulai Cepat
Bangun alat Python LangChain dengan CapSolver API
Bungkus CapSolvercreateTask+getTaskResultdalam satu alat: info terstruktur masuk, hasil terstruktur keluar. Pemungutan suara menggunakan interval tetap dengan batas waktu keseluruhan.
# 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)
Tambahkan alat ke agen LangChain
get_langchain_tools()mengembalikan BaseTools standar yang berada di samping browser, ekstraksi data, atau alat alur kerja yang sudah digunakan agen Anda.
# 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)
dan impor alat secara langsung — tidak diperlukan paket JavaScript atau TypeScript.
Praktik Terbaik Produksi
Bangun penyelesaian CAPTCHA siap produksi untuk agen LangChain
01
Manajemen rahasia
Simpan CAPSOLVER_API_KEY dalam variabel lingkungan atau manajer rahasia.
Mengapa
Mencegah paparan kunci yang tidak disengaja dalam prompt, log, dan repositori.
02
Skema alat
Usahakan masukan alat tetap sempit dan diketik (website_url, website_key).
Mengapa
Mengurangi kebingungan model dan pembuatan argumen yang tidak aman.
03
Deteksi
Baca jenis tantangan dan kunci situs dari konteks halaman.
Mengapa
Model tidak boleh menebak parameter halaman dari teks mentah.
04
Jajak pendapat & coba lagi
Periksa status tugas pada interval yang ditentukan dan hentikan setelah waktu habis. Coba lagi kesalahan API dengan backoff.
Mengapa
Mencegah pemuatan yang tidak perlu dan loop agen yang tidak terkendali.
05
Pencatatan
Catat task_id, jenis tantangan, status, dan kode kesalahan/percobaan ulang.
Mengapa
Membuat debugging dan dukungan lebih mudah.
06
Penanganan kesalahan
Hentikan kegagalan berulang dan kirimkan tugas untuk ditinjau manusia bila diperlukan.
Mengapa
Mencegah percobaan ulang secara buta pada alur kerja yang sensitif atau tidak pasti.
07
Kepatuhan
Tinjau persyaratan situs, otorisasi pengguna, persyaratan privasi, dan batas tarif.
Mengapa
Menjaga otomatisasi tetap selaras dengan kasus penggunaan yang disetujui.
Kesesuaian Ekosistem
CapSolver bekerja dengan infrastruktur browser Anda—tidak menggantikannya
01
Basis Peramban / Baja
02
Penulis Drama / Dalang
03
LangChain / LangGraph
Pekerjaan utama
Eksekusi browser yang dihosting dan manajemen sesi.
Kontrol browser dan interaksi DOM.
Orkestrasi agen dan penggunaan alat.
Tanpa CapSolver
Sesi browser dapat tetap berjalan, namun CAPTCHA mungkin menghentikan alur kerja.
Otomatisasi dapat mendeteksi dan berinteraksi dengan halaman, namun masih memerlukan logika penyelesaian CAPTCHA.
Agen dapat memanggil alat, namun tidak memiliki alat bawaan untuk memecahkan CAPTCHA.
Dengan CapSolver
CapSolver menangani tugas CAPTCHA saat sesi browser tetap aktif.
Otomatisasi mengirimkan data tantangan ke CapSolver dan menggunakan solusi yang dikembalikan.
Agen memanggil CapSolver sebagai alat dan melanjutkan alur kerja dengan hasilnya.
Kasus Penggunaan yang Paling Sesuai
Dibuat untuk tim agen B2B yang menjalankan alur kerja browser dalam produksi
Otomatisasi Penjualan
Riset penjualan resmi dan alur kerja CRM mungkin mengalami CAPTCHA atau pemeriksaan verifikasi selama tugas browser.
Teknologi SDM
Alur kerja perekrutan yang disetujui dapat dijeda saat verifikasi muncul selama tugas browser multi-langkah.
QA dan Alat Pengujian
Pengujian menyeluruh untuk pendaftaran, pembayaran, dan formulir memerlukan penanganan CAPTCHA yang jelas untuk mengurangi kegagalan pengujian.
RegTech dan Kepatuhan
Pemeriksaan registri publik dan alur kerja pengumpulan bukti memerlukan keandalan, log audit, dan perilaku fallback yang jelas.
Otomatisasi Penelitian
Alur kerja data publik yang sah mungkin dijeda ketika sumber memperlihatkan CAPTCHA atau pemeriksaan verifikasi.
RPA dalaman
Alur kerja berulang yang diizinkan pengguna mendapat manfaat dari lapisan pemulihan CAPTCHA yang jelas ketika validasi lalu lintas memblokir tugas.
Penggunaan yang Bertanggung Jawab
Gunakan CapSolver untuk otomatisasi yang sah dan resmi
CapSolver ditujukan untuk penggunaan yang sah dan sah, termasuk pengujian QA yang disetujui, RPA internal, tugas agen resmi pengguna, dan alur kerja data publik yang sesuai. Sebelum mengotomatiskan situs web, tinjau persyaratannya, aturan privasi yang berlaku, batas kapasitas, dan persyaratan kepatuhan organisasi Anda.
Pengujian QA resmi
RPA yang disetujui
Alur kerja data publik
Tugas agen resmi pengguna
Otomatisasi yang ditinjau kepatuhan
Otomatisasi e-niaga
Pertanyaan Umum
Integrasi Terkait
Jelajahi lebih banyak integrasi CapSolver untuk tumpukan agen Anda
Pilih integrasi lain untuk menambahkan penyelesaian CAPTCHA ke alur kerja agen atau browser Anda.
Penggunaan Peramban
Tambahkan CapSolver sebagai tindakan untuk agen AI berbasis browser.
SDK Agen OpenAI
Tambahkan penyelesaian CAPTCHA melalui alat fungsi dan alur kerja agen.

Jika agen LangChain Anda berfungsi dalam demo tetapi terhenti dalam produksi, tambahkan lapisan pemulihan CAPTCHA.
Mulailah dengan pembungkus alat di atas, tinjau dokumentasi CapSolver, dan hubungi tim saat Anda memerlukan dukungan perusahaan, volume yang lebih tinggi, atau jalur integrasi SDK asli.
