Imejengwa kwa Ajenti wa AI, si Vivinjari Pekee: Jinsi API Inavyofanya Kazi

Kichupo cha kivinjari bado kinafanya kazi: chagua zana, pakia faili, pakua matokeo. Ajenti na hati za maandishi huitisha operesheni zile zile bila kufungua kiolesura. Njia zote mbili hufikia katalogi moja.

Kila ukurasa wa zana pia ni kituo cha API

Unganisha, gawanya, bana, OCR, badilisha muundo: kila zana ya katalogi inaelekea kwenye /api/v1/…. Fungua ukurasa wa zana na usogee hadi Call this from code kwa mfano wa curl uliojengwa kutoka kwa vigezo halisi vya zana hiyo, si kiolezo cha jumla. Maombi bila jina hayahitaji akaunti wala funguo ya API kwenye tovuti ya umma; viambishi vya bila jina ni /api/v1/general/, /api/v1/misc/, /api/v1/security/, /api/v1/convert/ na /api/v1/filter/.

Mfano wa merge ni wa moja kwa moja:

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

OpenAPI inapatikana kwenye /v1/openapi.json. Kazi za hatua nyingi hutumia POST /api/v1/pipeline na orodha ya steps iliyopangwa. Tuma Idempotency-Key wakati jaribio la pili lisipaswe kuendesha kazi inayobadilisha mara mbili. Majibu ya seva iliyopangishwa hutangaza X-RateLimit-Limit, X-RateLimit-Remaining na X-RateLimit-Reset; kwenye HTTP 429, soma Retry-After (kikomo cha maombi bila jina).

OCR kupitia katalogi hiyo hiyo hurudisha Markdown (text/markdown) kutoka /api/v1/misc/ocr-pdf, si PDF yenye tabaka la maandishi lililofichwa. Ajenti wanaotarajia PDF inayoweza kutafutwa kutoka kituo hicho wataishughulikia vibaya faili inayopakuliwa; mkataba ni uchimbaji wa maandishi kwa mitiririko ya kazi, si uandishi upya wa aina ya OCRmyPDF.

MCP kwa wateja wanaozungumza itifaki hiyo

MCP (Model Context Protocol) huwaruhusu wateja wa ajenti kugundua na kuita zana kama vitendakazi badala ya kukwaruza nyaraka. Tovuti hii hutoa seva ya MCP kwenye /mcp kando ya API ya REST, hivyo mteja anayefaa huunganisha mara moja na kupata katalogi kamili.

MCP na REST hushiriki matarajio sawa ya uthibitisho: bila jina pale viambishi vya zana vinaruhusu; funguo za API kwa uendeshaji thabiti wa kiotomatiki na kwa seva za kujipangisha zilizofungwa. Kuelekeza ajenti kwenye /mcp si bidhaa nyingine tofauti na kuelekeza curl kwenye /api/v1/…. Nyaraka: MCP ya Watengenezaji.

Hitilafu zimeundwa kimuundo, si maandishi ya kubuni

Kushindwa hurudisha application/problem+json (mtindo wa RFC 7807), si 500 tupu wala “something went wrong”. Kila jibu lina msimbo thabiti (rate_limited, bad_request, invalid_document, missing_dependency na wengine), kidokezo kinachosomeka, na mara nyingi hatua inayofuata. Watu wanaweza kuipitia kwa haraka; ajenti wanaweza kuamua kujaribu tena, kubadilisha faili, au kusimama bila mtu kuchanganua mrundikano wa wito.

Muundo huo ni muhimu zaidi kuliko ukurasa wa hitilafu wa HTML wenye urafiki wakati mwitaji ni hati ya maandishi. Rejeleo: Hitilafu za Watengenezaji.

llms.txt ni kwa zana, si kwa nafasi ya utafutaji

/llms.txt ni faharasa ya maandishi tupu ya kila zana (jina, maelezo mafupi, URL), iliyotengenezwa kutoka katalogi hiyo hiyo inayoendesha tovuti. Ajenti wa programu na zana za nyaraka wanaweza kuisoma kama README. Si kifaa cha kupandisha nafasi kwenye Google: Utafutaji hupuuza /llms.txt (vyanzo: mwongozo wa Google wa uboreshaji wa AI). Kwa kuwa imetengenezwa kiotomatiki, haiwezi kuzeeka kimya kimya kama faili inayohaririwa kwa mkono.

CLI na ujuzi hushiriki maumbo sawa

pdfx inaweza kuendesha pdf-core ya ndani au --cloud dhidi ya URL ya msingi. Ujuzi wa ajenti wa programu ulio chini ya dist/skills/pdf-toolbox/SKILL.md unaeleza maumbo ya curl ya merge na pipeline ili ajenti wasivumbue mkataba wa pili. Wateja wanne, katalogi moja: Operesheni moja, wateja wanne.

Njia ya kivinjari haijabadilika

Kudondosha faili kwenye kichupo bado kunafanya kazi kama awali. Uso wa ziada ni vituo hivyo hivyo kwa ajenti, hati ya maandishi, au CI: usindikaji sawa, bila mtu katikati. Kujipangisha huweka uso huo kwenye mtandao wako (Kujipangisha); tovuti iliyopangishwa hubaki njia ya majaribio bila jina.

Rejeleo la API: Swagger. Misingi kwa njia yoyote: Msaada na Watengenezaji.