🎉BARUCapSolver untuk agen AI
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

Otomatisasi Agen · SDK Agen OpenAI

Selesaikan CAPTCHA di aplikasi OpenAI Agents SDK Anda

Tambahkan CapSolver sebagai alat fungsi untuk agen yang mendukung browser. Ketika CAPTCHA yang didukung muncul, agen dapat memanggil CapSolver, menerima hasilnya, dan melanjutkan alur kerja resmi. Panggilan alat juga dapat ditinjau melalui pelacakan Agen 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…

Cara kerja penyelesaian CAPTCHA

Ketika CAPTCHA yang didukung muncul, agen memanggil CapSolver dan menerima hasil yang diperlukan untuk melanjutkan.

01

CAPTCHA muncul

Tantangan muncul

02

Kumpulkan

URL halaman, kunci situs, dan jenis CAPTCHA

03

Memecahkan

Kirim permintaan ke CapSolver

04

Kembali

Hasil dikirim kembali ke agen

05

Lanjutkan

Agen melanjutkan alur kerja

Integrasi

Bagaimana CapSolver cocok dengan alur kerja agen OpenAI

OpenAI Agents SDK mengelola loop agen dan panggilan alat fungsi. Alat browser terpisah menangani interaksi situs web, sementara CapSolver memproses permintaan CAPTCHA yang didukung dan mengembalikan hasilnya ke agen.

Komponen

Peran utama

Ketika CAPTCHA muncul

Agen OpenAI

Merencanakan tugas, memilih alat, dan mengelola status.

Memutuskan kapan harus memanggil alat fungsi CapSolver.

Alat peramban

Menavigasi, mengklik, mengetik, dan membaca halaman.

Menyediakan konteks halaman dan melanjutkan tindakan browser.

Pemecah Topi

Memproses permintaan CAPTCHA yang didukung.

Mengembalikan hasil CAPTCHA ke agen.

Pelacakan Agen SDK

Agen rekaman berjalan dan panggilan alat.

Membantu meninjau aktivitas dan kesalahan alat.

cakupan CAPTCHA

Jenis CAPTCHA manakah yang didukung CapSolver untuk agen OpenAI?

Cakupan saat ini mencakup reCAPTCHA v2 dan v3, termasuk varian Enterprise, dan Cloudflare Turnstile.

reCAPTCHA v2

Tantangan reCAPTCHA v2 standar, tidak terlihat, dan Perusahaan.

reCAPTCHA v3

Tantangan berbasis skor dan Enterprise reCAPTCHA v3 dengan dukungan tindakan.

Pintu Putar Cloudflare

Widget Pintu Putar yang terkelola, non-interaktif, dan tidak terlihat.

Lebih banyak jenis CAPTCHA

Jelajahi jenis tugas CAPTCHA tambahan yang tersedia melalui CapSolver API.

Mulai Cepat

Tambahkan CapSolver ke agen OpenAI sebagai alat fungsi

Bungkus CapSolver dengan@function_tool, tambahkan ke alat agen Anda, dan biarkan SDK Agen mengelola putaran panggilan alat.

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)
Contoh ini menggunakan mode token. Lihatdokumentasiuntuk alat browser, parameter CAPTCHA, dan konfigurasi proxy.

Praktik terbaik produksi

Praktik terbaik untuk agen produksi OpenAI

Jaga keamanan kunci API, sampaikan detail CAPTCHA yang akurat, dan lacak setiap permintaan.

Daerah

Rekomendasi

Mengapa itu penting

Keamanan kunci API

Simpan CAPSOLVER_API_KEY dalam variabel lingkungan atau manajer rahasia.

Mencegah paparan kunci yang tidak disengaja dalam prompt, log, dan repositori.

Masukan alat

Gunakan masukan yang jelas untuk jenis CAPTCHA, URL halaman, dan kunci situs.

Membantu agen memanggil alat dengan informasi yang benar.

Detail CAPTCHA

Berikan detail CAPTCHA terverifikasi dari aplikasi atau alat browser Anda.

Mencegah model menebak parameter halaman.

Batas waktu dan percobaan ulang

Gunakan polling interval tetap dengan batas waktu keseluruhan. Coba lagi kesalahan HTTP secara terpisah.

Menghindari menunggu lama dan permintaan berulang yang tidak perlu.

Pencatatan dan penelusuran

Gunakan pelacakan Agen SDK untuk panggilan alat, dan catat taskId, status, dan kesalahan.

Membuat debugging dan dukungan lebih mudah.

Penanganan kegagalan

Kembalikan kesalahan yang jelas dan jeda alur kerja setelah kegagalan berulang kali.

Mencegah percobaan ulang buta dan loop agen yang tidak terduga.

Kasus penggunaan yang paling sesuai

Dibuat untuk tim B2B yang menjalankan agen OpenAI dalam produksi

Otomatisasi Penjualan

Mendukung penelitian yang disetujui dan alur kerja CRM menggunakan data bisnis publik atau yang disediakan pengguna.

Teknologi SDM

Mendukung alur kerja perekrutan resmi di seluruh sistem pekerjaan dan kandidat yang disetujui.

QA dan Alat Pengujian

Uji alur kerja pendaftaran, checkout, dan formulir yang menemukan CAPTCHA yang didukung.

RegTech dan Kepatuhan

Pemeriksaan registri publik dan alur kerja pengumpulan bukti memerlukan keandalan dan log audit.

Otomatisasi Penelitian

Membantu agen penelitian mengumpulkan informasi web publik ketika CAPTCHA yang didukung muncul.

RPA dalaman

Mendukung alur kerja internal resmi pengguna yang memerlukan penyelesaian CAPTCHA.

Penggunaan yang Bertanggung Jawab

Dibangun untuk otomatisasi yang sah dan resmi

CapSolver dirancang untuk otomatisasi yang bertanggung jawab, termasuk pengujian QA resmi, RPA yang disetujui, alur kerja data publik, dan tugas agen resmi pengguna. Pengguna harus mengikuti undang-undang yang berlaku, ketentuan situs web, persyaratan privasi, dan batasan tarif. CapSolver tidak mendukung akses tidak sah atau otomatisasi berbahaya.

01

Pengujian QA resmi

02

RPA yang disetujui

03

Alur kerja data publik

04

Tugas agen resmi pengguna

05

Otomatisasi yang ditinjau kepatuhan

06

Otomatisasi yang berfokus pada aksesibilitas

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.

01

Server MCP

Hubungkan CapSolver ke klien lain yang mendukung alat MCP.

Lihat Integrasi
02

Penulis naskah drama

Tambahkan penyelesaian CAPTCHA ke otomatisasi browser khusus.

Lihat Integrasi
03

Penggunaan Peramban

Tambahkan CapSolver sebagai tindakan untuk agen AI berbasis browser.

Lihat Integrasi
04

LangChain

Gunakan CapSolver sebagai alat yang dapat dipanggil di agen LangChain.

Lihat Integrasi

Tambahkan penyelesaian CAPTCHA ke aplikasi OpenAI Agents SDK Anda

Mulailah dengan uji coba gratis, tambahkan CapSolver sebagai alat fungsi, dan ikuti panduan integrasi.