Dữ liệu Mua sắm Công cho Các Tác nhân Trí tuệ Nhân tạo: Quy trình Mã

TL;DR

• Dữ liệu mua sắm công cho tác nhân AI nên sử dụng tầng giải pháp AI của CapSolver như một lớp phục hồi rõ ràng, không phải logic thử lại ẩn.
• capsolver-core phù hợp với các kịch bản Playwright, capsolver-agent phù hợp với các tác nhân gọi công cụ, và capsolver-mcp phù hợp với các khách hàng tương thích MCP.
• Mẫu an toàn là phát hiện, đọc tham số, giải quyết một lần với số lần thử có giới hạn, điền lại kết quả, sau đó ghi lại trạng thái yêu cầu để xem xét.
• Tác nhân nên dừng lại khi phạm vi nhiệm vụ thay đổi, trang yêu cầu truy cập bị hạn chế, hoặc xử lý thử thách lặp lại mà không có tiến triển.

Giới thiệu

Dữ liệu mua sắm công cho tác nhân AI cần có mã thu thập lặp lại, không phải hứa hẹn mơ hồ rằng tác nhân có thể duyệt trang. CapSolver nên được tích hợp như một khả năng được tài liệu hóa cho tác nhân: trình duyệt hoặc mô hình phát hiện thử thách xác minh, công cụ được phê duyệt xử lý nó, và tác nhân tiếp tục chỉ khi nhiệm vụ được người dùng ủy quyền ban đầu vẫn còn hiệu lực. Tài liệu AI chính thức của CapSolver mô tả ba lớp thực tế: CapSolver cho Tác nhân AI cho kiến trúc, Core SDK chế độ trình duyệt cho luồng Playwright, các lược đồ công cụ tác nhân cho các cuộc gọi được kiểm soát bởi mô hình, và các công cụ dịch vụ MCP cho các khách hàng khám phá công cụ qua Giao thức Bối cảnh Mô hình. Bài viết này biến các tài liệu đó thành quy trình thu thập dữ liệu mua sắm công cho tác nhân AI với mã, quy tắc dừng và trường ghi nhật ký.

Sử dụng Gói AI CapSolver Chính thức

Tài liệu AI của CapSolver mô tả ba lớp. Sử dụng lớp thấp nhất phù hợp với mô hình sở hữu của bạn: Core SDK khi mã của bạn kiểm soát trình duyệt, công cụ tác nhân khi mô hình quyết định khi gọi công cụ, và MCP service khi AI client của bạn nên khám phá công cụ giải quyết tự động.

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"

Giới thiệu và Bắt đầu nhanh giải thích vai trò của các gói: capsolver-core mở rộng động cơ, capsolver-agent bao bọc nó thành công cụ, và capsolver-mcp mở rộng cùng khả năng cho các khách hàng MCP. Giữ khóa API trong cấu hình môi trường và tránh đặt nó vào lời nhắc, nhật ký, hình ảnh chụp màn hình hoặc ví dụ bài viết.

Kiến trúc Tác nhân Mua sắm

Các cổng mua sắm thường hiển thị trang tìm kiếm, trang chi tiết thông báo, tệp đính kèm và cập nhật trao thưởng. Một tác nhân AI nên chuẩn hóa các bước này thành hợp đồng nguồn trước khi xử lý bất kỳ thử thách xác minh nào.

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"])

Hợp đồng này giữ cho dữ liệu mua sắm công cho tác nhân AI tập trung vào hồ sơ công khai và dừng chạy khi mục tiêu thay đổi sang nội dung chỉ dành cho tài khoản hoặc bị hạn chế.

Mẫu SDK Cốt lõi cho Tác nhân Kiểm soát Trình duyệt

Sử dụng capsolver-core khi luồng dữ liệu mua sắm công cho tác nhân AI của bạn đã sở hữu trang Playwright. Đường dẫn SDK Cốt lõi chính thức là phát hiện, đọc thông tin CAPTCHA, giải quyết và điền lại token vào trang. Gọi trình duyệt toàn diện hữu ích khi cấu trúc trang là động.

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())

Chi tiết kỹ thuật quan trọng là giá trị trả về, không chỉ token. Tác nhân của bạn nên tiếp tục chỉ khi nhiệm vụ ban đầu vẫn hợp pháp, hợp lý và được người dùng ủy quyền. Nó nên dừng lại khi trang yêu cầu dữ liệu riêng tư, bị hạn chế, nhạy cảm hoặc không được ủy quyền.

Mẫu Dịch vụ MCP cho Khách hàng AI

Sử dụng capsolver-mcp khi tác nhân chạy bên trong khách hàng tương thích MCP. Hướng dẫn Dịch vụ MCP tài liệu giao thức stdin, SSE và HTTP có thể truyền tải và liệt kê các công cụ như solve_captcha, detect_captchas, solve_on_page, get_balance và 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"
      }
    }
  }
}

Đối với dữ liệu mua sắm công cho tác nhân AI, MCP mạnh nhất khi nhiều nhà phát triển sử dụng các khách hàng khác nhau nhưng cần một bề mặt công cụ được xem xét. Giữ tên dịch vụ ổn định, lưu khóa bên ngoài lời nhắc và ghi nhật ký các cuộc gọi công cụ với ID yêu cầu, URL mục tiêu, loại thử thách, số lần thử và trạng thái cuối cùng.

Nhận Mã Thưởng CapSolver

Tăng ngân sách tự động hóa ngay lập tức!
Sử dụng mã thưởng CAP26 khi nạp tiền vào tài khoản CapSolver để nhận thêm 5% thưởng cho mỗi lần nạp tiền — không giới hạn.
Nhận mã thưởng ngay bây giờ trong Bảng điều khiển CapSolver

Các Quy tắc An toàn Nên Có Trong Vòng Lặp Tác nhân

Kiểm tra Phạm vi

Trước khi gọi bất kỳ công cụ thử thách nào, xác nhận rằng nhiệm vụ được người dùng ủy quyền, mục tiêu nằm trong danh sách miền được phê duyệt và dữ liệu đang truy cập là công khai hoặc được phép khác. Một quy trình dữ liệu mua sắm công cho tác nhân AI nên không bao giờ coi khả năng kỹ thuật là sự cho phép.

Giới hạn Thử lại

Sử dụng ngân sách thử lại nhỏ. Một lần thử lại trạng thái trình duyệt và một lần thử lại thời gian chờ thường là đủ. Các sự kiện thử thách lặp lại nên tạo vé xem xét thay vì tiếp tục im lặng.

Khả năng Quan sát

Ghi lại URL, thời gian, loại thử thách, đường dẫn gói CapSolver, số lần thử, trạng thái kết quả và trạng thái trang cuối cùng. Không lưu nội dung trang không liên quan, thông tin đăng nhập, bí mật phiên hoặc dữ liệu cá nhân trừ khi chính sách của bạn cho phép rõ ràng.

Đối với dữ liệu mua sắm công cho tác nhân AI, hãy giữ cho quá trình chạy hợp pháp và dựa trên bằng chứng: tôn trọng hành vi mã trạng thái HTTP, yêu cầu khả năng tiếp cận, quản lý rủi ro riêng tư và quản lý dữ liệu công cộng.

Kết luận

Một bài viết về dữ liệu mua sắm công cho tác nhân AI mạnh mẽ nên hiển thị các con đường triển khai thực tế, và một quy trình sản xuất mạnh mẽ cũng nên làm như vậy. Lựa chọn thực tế đơn giản: sử dụng capsolver-core cho tự động hóa trình duyệt do mã sở hữu, capsolver-agent cho tác nhân gọi công cụ và capsolver-mcp cho khách hàng tương thích MCP. Giữ xử lý thử thách có giới hạn, được ghi nhật ký và liên kết với công việc được người dùng ủy quyền hợp pháp. Khi đội ngũ của bạn sẵn sàng thêm lớp phục hồi vào quy trình tác nhân, bắt đầu với CapSolver và tài liệu chính thức về tác nhân AI.

Câu hỏi Thường gặp

Gói CapSolver nào nên được sử dụng đầu tiên bởi một tác nhân AI?

Sử dụng capsolver-core khi ứng dụng của bạn sở hữu mã trình duyệt, capsolver-agent khi mô hình nên gọi công cụ và capsolver-mcp khi AI client nên khám phá công cụ thông qua MCP.

Mô hình có nên quyết định mọi lần thử lại CAPTCHA không?

Không. Mô hình có thể yêu cầu gọi công cụ, nhưng ứng dụng nên thực thi phạm vi, giới hạn thử lại và điều kiện dừng.

Quy trình này có thể được sử dụng cho dữ liệu riêng tư hoặc bị hạn chế không?

Không. Xử lý CAPTCHA không cấp quyền. Sử dụng nó chỉ cho các quy trình hợp pháp, hợp lý, được người dùng ủy quyền và tôn trọng điều khoản trang và quyền dữ liệu.

Những gì nên được ghi nhật ký để xem xét?

Ghi nhật ký URL nguồn, loại thử thách, đường dẫn công cụ, số lần thử, trạng thái kết quả và trạng thái trang cuối cùng. Giữ thông tin đăng nhập và nội dung trang không liên quan ngoài nhật ký.