Operesheni Moja, Wateja Wanne: Kivinjari, curl, MCP, pdfx

Wateja wanne huonekana kama bidhaa nne. Hushiriki katalogi moja. Chukua Unganisha kama kazi halisi: unganisha PDF kwa mpangilio wa upakiaji bila kubadilisha kurasa kuwa picha. Mfumo huo huo unashikilia kila zana nyingine ya katalogi (bana, OCR, badilisha muundo na zingine): kitambulisho kimoja cha operesheni, njia nne za kuiita.

Kivinjari

Fungua /merge, ongeza faili kwa mpangilio unaotaka, Process, pakua. Hakuna akaunti kwa zana za katalogi. Sehemu ya “Call this from code” ya ukurasa hujenga curl kutoka sehemu zile zile ambazo fomu hutuma, hivyo kiolesura na mkataba wa HTTP hubaki vikilingana.

Sehemu hiyo si maandishi ya matangazo. Imetengenezwa kutoka kwa ufafanuzi wa zana ambao jukwaa linatumia tayari kwa fomu, ndiyo sababu kubadilisha jina la kigezo huonekana mahali pote pamoja. Kama fomu inapokea sortType=byFileName ya hiari, mfano wa curl unaweza kubeba sehemu hiyo hiyo.

curl / REST

curl -fsS -X POST "$API_BASE/api/v1/general/merge-pdfs" \
  -F "[email protected]" \
  -F "[email protected]" \
  -o merged.pdf

Simu za katalogi bila jina hazihitaji funguo. Funguo kutoka Watengenezaji hupa uendeshaji wa kiotomatiki utambulisho thabiti (na seva zilizojipangisha lango). OpenAPI iko kwenye /v1/openapi.json.

Kwa kazi za hatua nyingi, POST /api/v1/pipeline hupokea operesheni zilizopangwa katika sehemu ya steps (kwa mfano merge, kisha muhuri wa maji, kisha kubana). Tuma Idempotency-Key wakati majaribio ya pili hayapaswi kuendesha kazi mara mbili; mwitikio uliorudiwa uliofanikiwa unaweza kurudi na Idempotency-Replayed. Kushindwa hutumia application/problem+json yenye misimbo thabiti kama rate_limited na bad_request (Hitilafu za Watengenezaji).

Majibu yaliyopangishwa pia hutangaza X-RateLimit-Limit, X-RateLimit-Remaining na X-RateLimit-Reset; HTTP 429 hujumuisha Retry-After. Chukua vichwa hivyo kama bajeti hai, si namba iliyokaririwa kutoka kwa blogu (kikomo cha maombi bila jina).

MCP

Ajenti wanaozungumza Model Context Protocol huunganisha kwenye /mcp, hugundua merge kama zana, na kuiita kwa hadithi hiyo hiyo ya funguo ya API kama REST. Nyaraka: MCP ya Watengenezaji.

MCP si katalogi ya pili. Ni itifaki ya ugunduzi na uitaji juu ya operesheni hizo hizo ambazo OpenAPI huorodhesha. Kama operesheni haipo kwenye MCP, hilo ni hitilafu ya seva, si ramani tofauti ya bidhaa. Unganisha MCP na /llms.txt unapotaka faharasa ya maandishi ya zana kabla mteja kuunganisha.

pdfx CLI

pdf-core ya ndani:

pdfx merge a.pdf b.pdf -o merged.pdf

Au seva hiyo hiyo ambayo jukwaa linatumia:

pdfx --cloud --api-base "$API_BASE" --api-key "$KEY" merge a.pdf b.pdf -o merged.pdf

Hali ya ndani haipaki kamwe; hali ya wingu hugusa URL yako ya msingi kwa umbo hilo hilo la sehemu nyingi kama curl. Ujuzi wa ajenti wa programu ulio chini ya dist/skills/pdf-toolbox/SKILL.md unaeleza maumbo hayo ya merge na pipeline ili ajenti wasivumbue OpenAPI ya pili.

OCR kupitia yeyote wa wateja hawa bado hurudisha Markdown kutoka /api/v1/misc/ocr-pdf, si tabaka la maandishi lililofichwa. Ukweli huo ni sehemu ya mkataba unaoshirikiwa: kubadilisha aina ya kurudisha kwenye mteja mmoja bila wengine kungevunja ahadi ya “operesheni moja.” Kubana hubaki kwenye /api/v1/misc/compress-pdf kwa ubanaji upya wa mitiririko; ni operesheni tofauti na merge, inayofikiwa kwa njia hizo hizo nne.

Kwa nini usawa ni muhimu

Kama merge ya kivinjari na merge ya API zingetofautiana, uendeshaji wa kiotomatiki ungerudi nyuma kimya kimya wakati ukurasa wa maonyesho bado unaonekana mzuri. Operesheni moja, vishikio vinne, ndilo lengo. Jukwaa ni mteja wa urahisi, si utekelezaji wa pili wa merge, compress au OCR.

Ndiyo sababu pia hakuna tawi la mezani: mti wa tano wa kiolesura ungerejea tatizo la kutofautiana chini ya jina lingine la program. Muafaka mpana: Imejengwa kwa ajenti wa AI, si vivinjari pekee. Kwa uamuzi wa mezani, ona Kwa nini tuliruka programu ya mezani. Kwa kusimamisha API kwenye mtandao wako, ona Kujipangisha.