Skip to main content

Generic HTTP Backend Configuration

Purpose​

The Generic HTTP backend is used to send raw HTTP requests to any URL. It does not execute agent skills but serves as a general-purpose HTTP client.

Primary Use Case: MinerU Document Parsing​

The main use of the Generic HTTP backend is to support the MinerU workflow — a PDF document parsing workflow.

MinerU is a document parsing service that converts PDF files to Markdown format. The MinerU workflow sends requests to the MinerU service through the Generic HTTP backend to obtain parsing results.

Configuring MinerU​

  1. Visit mineru.net to register an account, and obtain an API Token from the API → API Management page
  2. Open Tools → Backend Manager
  3. Switch to the Generic HTTP tab
  4. Click Add Generic HTTP Profile from Preset
  5. Choose MinerU Official, then replace the token placeholder with your API Token:
FieldValue
Display NameMinerU Official
Base URLhttps://mineru.net
Authenticationbearer
Auth TokenPaste your API Token
Timeout600000 (10 minutes)
  1. Click Save in the bottom-right corner

Configuration Fields​

FieldRequiredDescription
Display NameYesDisplay name for the backend
Base URLYesBase address of the HTTP service
Bearer TokenNoAuthentication token
TimeoutNoRequest timeout (milliseconds)

Technical Details​

The Generic HTTP backend supports:

  • Single-step requests: generic-http.request.v1 — Send a single HTTP request
  • Multi-step pipelines: generic-http.steps.v1 — Chained requests with JSON path extraction ($.* expressions), extracting values from previous responses as parameters for subsequent requests
  • Multipart uploads: File upload support
  • Polling and retry mechanisms

Next Steps​