OpenAI Agents SDK · agent runner


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.
Cara kerja penyelesaian CAPTCHA
Ketika CAPTCHA yang didukung muncul, agen memanggil CapSolver dan menerima hasil yang diperlukan untuk melanjutkan.
CAPTCHA muncul
Tantangan muncul
Kumpulkan
URL halaman, kunci situs, dan jenis CAPTCHA
Memecahkan
Kirim permintaan ke CapSolver
Kembali
Hasil dikirim kembali ke agen
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.
# 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)
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.
Pengujian QA resmi
RPA yang disetujui
Alur kerja data publik
Tugas agen resmi pengguna
Otomatisasi yang ditinjau kepatuhan
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.
Penggunaan Peramban
Tambahkan CapSolver sebagai tindakan untuk agen AI berbasis browser.

Tambahkan penyelesaian CAPTCHA ke aplikasi OpenAI Agents SDK Anda
Mulailah dengan uji coba gratis, tambahkan CapSolver sebagai alat fungsi, dan ikuti panduan integrasi.
