pith:FVP4O2IB
Making OpenAPI Documentation Agent-Ready: Detecting Documentation and REST Smells with a Multi-Agent LLM System
OpenAPI documentation valid for microservices often lacks the semantic structure needed for AI agents.
arxiv:2605.14312 v1 · 2026-05-14 · cs.SE
Add to your LaTeX paper
\usepackage{pith}
\pithnumber{FVP4O2IBWQZGDWGK5EXL4JO3HQ}
Prints a linked badge after your title and injects PDF metadata. Compiles on arXiv. Learn more · Embed verified badge
Record completeness
Claims
structural validity within microservice environments does not guarantee semantic readiness for agent-based consumption
That the smells identified by the multi-agent LLM system are the main cause of observed agent failures and that practitioner agreement sufficiently validates their relevance without quantitative before-after agent performance data.
Hermes uses multi-agent LLMs to detect 2450 documentation and REST smells across 600 OpenAPI endpoints, demonstrating that structurally valid microservice APIs are often not semantically ready for agent consumption.
References
Receipt and verification
| First computed | 2026-05-17T23:39:09.982150Z |
|---|---|
| Builder | pith-number-builder-2026-05-17-v1 |
| Signature | Pith Ed25519
(pith-v1-2026-05) · public key |
| Schema | pith-number/v1.0 |
Canonical hash
2d5fc76901b43261d8cae92ebe25db3c07920a78d049ea27c7f84180005bd253
Aliases
· · · · ·Agent API
Verify this Pith Number yourself
curl -sH 'Accept: application/ld+json' https://pith.science/pith/FVP4O2IBWQZGDWGK5EXL4JO3HQ \
| jq -c '.canonical_record' \
| python3 -c "import sys,json,hashlib; b=json.dumps(json.loads(sys.stdin.read()), sort_keys=True, separators=(',',':'), ensure_ascii=False).encode(); print(hashlib.sha256(b).hexdigest())"
# expect: 2d5fc76901b43261d8cae92ebe25db3c07920a78d049ea27c7f84180005bd253
Canonical record JSON
{
"metadata": {
"abstract_canon_sha256": "9c069f8ff2066f2f5340401d1e7175511bead030aa02bf56b9dbd75f9a6959d6",
"cross_cats_sorted": [],
"license": "http://creativecommons.org/licenses/by-nc-nd/4.0/",
"primary_cat": "cs.SE",
"submitted_at": "2026-05-14T03:23:51Z",
"title_canon_sha256": "8d91f7ba1dac19331e8e03876ab4f2521f2ea5b10ddbfd80060feec849dd81d7"
},
"schema_version": "1.0",
"source": {
"id": "2605.14312",
"kind": "arxiv",
"version": 1
}
}