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