Data Pengadaan Publik untuk Agen AI: Kode Alur Kerja

TL;DR

• Data lelang publik untuk kerja agen AI harus menggunakan tumpukan agen AI CapSolver sebagai lapisan pemulihan yang jelas, bukan logika ulang tersembunyi.
• capsolver-core cocok untuk skrip Playwright, capsolver-agent cocok untuk agen pemanggil alat, dan capsolver-mcp cocok untuk klien yang kompatibel dengan MCP.
• Pola yang aman adalah mendeteksi, membaca parameter, menyelesaikan sekali dengan ulang terbatas, mengisi kembali, lalu mencatat status permintaan untuk tinjauan.
• Agen harus berhenti ketika lingkup tugas berubah, halaman meminta akses terbatas, atau penanganan tantangan berulang tanpa kemajuan.

Pendahuluan

Data lelang publik untuk agen AI membutuhkan kode pengumpulan yang dapat diulang, bukan janji kabur bahwa agen dapat menjelajah. CapSolver harus dihubungkan sebagai kemampuan agen yang terdokumentasi: browser atau model mendeteksi tantangan verifikasi, alat yang disetujui menanganinya, dan agen melanjutkan hanya ketika tugas yang diizinkan pengguna asli masih valid. Dokumen resmi CapSolver AI menjelaskan tiga lapisan praktis: CapSolver untuk Agen AI untuk arsitektur, Mode SDK inti untuk alur Playwright, skema alat agen untuk pemanggilan yang dikendalikan model, dan alat layanan MCP untuk klien yang menemukan alat melalui Protokol Konteks Model. Artikel ini mengubah dokumen tersebut menjadi alur kerja data lelang publik untuk agen AI yang siap produksi dengan kode, aturan berhenti, dan bidang pencatatan.

Gunakan Paket AI CapSolver Resmi

Dokumen CapSolver AI menjelaskan tiga lapisan. Gunakan lapisan terendah yang sesuai dengan model kepemilikan Anda: SDK inti ketika kode Anda mengontrol browser, alat agen ketika model menentukan kapan memanggil alat, dan layanan MCP ketika klien AI Anda harus menemukan alat penyelesaian secara otomatis.

pip install "capsolver-core[playwright] @ git+https://github.com/capsolver-ai/capsolver-core.git"
pip install git+https://github.com/capsolver-ai/capsolver-agent.git
pip install "capsolver-mcp[browser] @ git+https://github.com/capsolver-ai/capsolver-mcp.git"
playwright install chromium
export CAPSOLVER_API_KEY="your-capsolver-api-key"

Pendahuluan dan Mulai Cepat menjelaskan peran paket: capsolver-core mengekspos mesin, capsolver-agent mengemasnya sebagai alat, dan capsolver-mcp mengekspos kemampuan yang sama ke klien MCP. Simpan kunci API dalam konfigurasi lingkungan dan hindari menempatkannya dalam prompt, log, tangkapan layar, atau contoh artikel.

Arsitektur Agen Lelang

Portal lelang sering menampilkan halaman pencarian, halaman detail pengumuman, lampiran, dan pembaruan pemenang. Agen AI harus menyederhanakan langkah-langkah ini menjadi kontrak sumber sebelum menangani tantangan verifikasi apa pun.

source_contract = {
    "portal": "city-procurement",
    "allowed_paths": ["/bids", "/awards", "/notices"],
    "public_records_only": True,
    "max_challenge_attempts": 1,
}

def in_public_procurement_scope(url):
    return any(path in url for path in source_contract["allowed_paths"])

Kontrak ini menjaga fokus data lelang publik untuk agen AI pada catatan publik dan menghentikan eksekusi ketika target berubah ke konten berlangganan atau terbatas.

Pola SDK Inti untuk Agen yang Mengontrol Browser

Gunakan capsolver-core ketika alur data lelang publik untuk agen AI Anda sudah menguasai halaman Playwright. Jalur SDK Inti resmi adalah mendeteksi, membaca informasi CAPTCHA, menyelesaikan, dan mengisi token kembali ke halaman. Panggilan browser all-in-one berguna ketika struktur halaman dinamis.

import asyncio
from capsolver_core import create_capsolver
from playwright.async_api import async_playwright

TARGET_URL = "https://example.gov/procurement/notices"

async def run_agent_step():
    async with async_playwright() as pw:
        browser = await pw.chromium.launch()
        page = await browser.new_page()
        await page.goto(TARGET_URL, wait_until="domcontentloaded")

        async with create_capsolver(api_key="YOUR_CAPSOLVER_KEY") as cap:
            captcha_types = await cap.detect(page)
            if not captcha_types:
                return "continue_without_challenge"

            results = await cap.solve_on_page(page)
            solved = [r for r in results if r.solution and not r.error]
            if not solved:
                return "stop_for_review"

        return "resume_original_authorized_task"

asyncio.run(run_agent_step())

Detail teknik penting adalah nilai kembalian, bukan hanya token. Agen Anda harus melanjutkan hanya ketika tugas asli masih sah, wajar, dan diizinkan pengguna. Harus berhenti ketika halaman meminta data pribadi, terbatas, sensitif, atau tidak diizinkan.

Pola Layanan MCP untuk Klien AI

Gunakan capsolver-mcp ketika agen berjalan di dalam klien yang kompatibel dengan MCP. Panduan Layanan MCP mendokumentasikan transport stdio, SSE, dan HTTP yang dapat disiarkan serta daftar alat seperti solve_captcha, detect_captchas, solve_on_page, get_balance, dan get_supported_captchas.

capsolver-mcp --transport streamable-http --host 127.0.0.1 --port 8000

{
  "mcpServers": {
    "capsolver": {
      "command": "capsolver-mcp",
      "env": {
        "CAPSOLVER_API_KEY": "YOUR_CAPSOLVER_KEY"
      }
    }
  }
}

Untuk data lelang publik untuk agen AI, MCP paling kuat ketika beberapa pengembang menggunakan klien berbeda tetapi membutuhkan permukaan alat yang direview. Pertahankan nama layanan stabil, simpan kunci di luar prompt, dan catat pemanggilan alat dengan ID permintaan, URL target, jenis tantangan, jumlah percobaan, dan status akhir.

Klaim Kode Bonus CapSolver Anda

Tingkatkan anggaran otomasi Anda secara instan!
Gunakan kode bonus CAP26 saat menambahkan dana ke akun CapSolver Anda untuk mendapatkan tambahan 5% bonus pada setiap penyetoran — tanpa batas.
Klaim sekarang di Dashboard CapSolver Anda

Pembatas yang Harus Ada di Loop Agen

Pemeriksaan Ruang Lingkup

Sebelum memanggil alat tantangan apa pun, konfirmasi bahwa tugas diizinkan pengguna, target berada dalam daftar domain yang disetujui, dan data yang diakses adalah publik atau diizinkan. Alur kerja data lelang publik untuk agen AI tidak boleh pernah menganggap kemampuan teknis sebagai izin.

Batas Ulang

Gunakan anggaran ulang kecil. Satu ulang state browser dan satu ulang cooldown biasanya cukup. Peristiwa tantangan berulang harus menciptakan tiket tinjauan alih-alih terus berjalan diam-diam.

Observabilitas

Catat URL, timestamp, jenis tantangan, jalur paket CapSolver, jumlah percobaan, status hasil, dan status halaman akhir. Jangan menyimpan konten halaman yang tidak relevan, kredensial, rahasia sesi, atau data pribadi kecuali kebijakan Anda secara eksplisit mengizinkannya.

Untuk data lelang publik untuk agen AI, pertahankan eksekusi yang sah dan berdasarkan bukti: hormati perilaku kode status HTTP, persyaratan aksesibilitas, manajemen risiko privasi, dan stewardship data publik.

Kesimpulan

Artikel tentang data lelang publik untuk agen AI yang kuat harus menunjukkan jalur implementasi nyata, dan alur kerja produksi yang kuat harus melakukan hal yang sama. Pilihan praktis sederhana: gunakan capsolver-core untuk otomasi browser yang dikuasai kode, capsolver-agent untuk agen pemanggil alat, dan capsolver-mcp untuk klien yang kompatibel dengan MCP. Pertahankan penanganan tantangan yang terbatas, dicatat, dan terkait dengan pekerjaan yang sah dan diizinkan pengguna. Ketika tim Anda siap menambahkan lapisan pemulihan ke alur kerja agen, mulai dengan CapSolver dan dokumen agen AI resmi.

FAQ

Paket CapSolver mana yang harus digunakan oleh agen AI terlebih dahulu?

Gunakan capsolver-core ketika aplikasi Anda menguasai kode browser, capsolver-agent ketika model harus memanggil alat, dan capsolver-mcp ketika klien AI harus menemukan alat melalui MCP.

Apakah model harus memutuskan setiap ulang CAPTCHA?

Tidak. Model dapat meminta pemanggilan alat, tetapi aplikasi harus menerapkan ruang lingkup, batas ulang, dan kondisi berhenti.

Apakah alur ini bisa digunakan untuk data pribadi atau terbatas?

Tidak. Penyelesaian CAPTCHA tidak memberikan izin. Gunakan hanya untuk alur kerja yang sah, wajar, dan diizinkan pengguna yang menghormati ketentuan situs dan hak data.

Apa yang harus dicatat untuk tinjauan?

Catat URL sumber, jenis tantangan, jalur alat, jumlah percobaan, status hasil, dan status halaman akhir. Hindari menyimpan kredensial dan konten halaman yang tidak relevan di log.