Documentation

AgentOps documentation - agent-safe routes, service discovery, MCP tools, and operation guides.

What is AgentOps?

AgentOps is the agent operations layer for the PlatPhorm News network. It helps humans, agents, IDEs, MCP clients, CLI tools, crawlers, validators, and future agent runtimes understand how to safely operate across the PlatPhorm ecosystem.

Key Features

Agent-safe route documentation
Machine-readable content (llms.txt, OpenAPI, MCP, feeds, graphs)
Human-readable mirrors of machine-readable files
Service capability maps and route safety classes
No database required - adapter-based storage
Public-safe default access (no auth wall)

Documentation

Agent-Safe Routes

Understanding route safety classes and agent behavior

Service Discovery

How to discover and integrate with PlatPhorm services

All Routes

Browse all documented routes

Web Status

Operational readiness status

Network Ops Contracts

AgentOps documents integration contracts for network ops services.

SearchOps

8 routes

SearchOps owns daily crawling, status code capture, canonical detection, title extraction, meta robots extraction, schema extraction, sitemap membership, internal links, image size, content length, feed membership, GSC export comparison, URL labeling, and alerts.

GET/api/searchops/status

GET/api/searchops/crawl-runs

GET/api/searchops/urls

GET/api/searchops/alerts

+4 more routes

SitemapOps

10 routes

SitemapOps owns sitemap generation from index policy, exclusion of noindex/redirected/blocked/duplicate/weak pages, meaningful lastmod, and separate article/tool/docs/report/news sitemaps.

GET/api/sitemapops/status

GET/api/sitemapops/index-policy

GET/api/sitemapops/sitemaps

GET/api/sitemapops/sitemaps/articles

+6 more routes

StoryOps

7 routes

StoryOps owns the indexable story flag, story quality gating, required story fields (author, lede, whyItMatters, sourceMatrix, image, datePublished, dateModified), and thin story quarantine.

GET/api/storyops/status

GET/api/storyops/stories

GET/api/storyops/stories/indexable

GET/api/storyops/quarantine/thin-stories

+3 more routes

TrustOps

9 routes

TrustOps owns author schema, publisher schema, corrections policy, contact policy, AI-use disclosure, and source attribution policy.

GET/api/trustops/status

GET/api/trustops/author-schema

GET/api/trustops/publisher-schema

GET/api/trustops/corrections-policy

+5 more routes

Machine-Readable Files

Discovery files available for agents, IDEs, and automated tools.

/llms.txt

LLM discovery file

/llms-full.txt

Full LLM documentation

/llms-index.json

Structured LLM index

/openapi.json

OpenAPI 3.1 specification

RSS feed

Atom feed

XML sitemap

Service graph

/.well-known/agent-policy.json

Agent policy

/.well-known/trust.json

Trust policy

/.well-known/mcp.json

MCP manifest

Authentication

Public-Safe Access

No authentication required for public-safe routes. This includes homepage, documentation, route docs, service registry, machine-readable files, examples, and Web Status.

Protected Actions

Protected actions require PLATPHORM_API_KEY:

Authorization: Bearer $PLATPHORM_API_KEY