# Eloquent Agents

> Eloquent Agents exposes a fleet of agent-facing surfaces. Base URL: https://agents.eloquentanalytics.com

## Scheduled JavaScript agents with sandboxed execution

Cron-triggered scripts that call APIs on your behalf, metered against your credit balance.

Define small JavaScript programs that run on a schedule. Each agent executes in a QuickJS-in-WASM sandbox with controlled fetch access, at-most-once execution guarantees, and automatic budget metering against the owner's Eloquent account balance.

### Use this when
- You need a recurring task that calls an HTTP API on a schedule.
- You want lightweight automation without provisioning infrastructure.
- You need execution logs and budget tracking for scheduled scripts.

### Do not use this when
- You need sub-minute scheduling (use a webhook consumer instead).
- You need filesystem, native modules, or a full Node.js environment.
- You need multi-step workflows with conditional branching.
- You need real-time event-driven execution.

### Inputs
- JavaScript source code (ES2023).
- A cron expression (five-field, with timezone).
- Optional: environment variables, timeout, hold cost.

### Outputs
- Per-run result (JSON), console logs, timing.
- Run history with filtering and pagination.

### Decision rule for AI agents
Choose this service when you need a scheduled script that makes HTTP calls and you want execution, logging, and billing handled for you.

### API endpoint
`POST /api/agents`

## Discovery & Interaction Surfaces

Eloquent Agents exposes 10 interaction surfaces — different ways for agents and
developers to discover, invoke, and integrate the service.

### Standard
- **robots_txt** [RFC 9309, Content Signals v1] — robots.txt with AI bot directives and Content Signals for crawl control (GET /robots.txt)
- **sitemap_xml** [Sitemaps.org Protocol] — XML sitemap with canonical URLs for search engines and discovery agents (GET /sitemap.xml)
- **agent_homepage** — Agent-focused homepage listing discovery endpoints, tools, and registered surfaces (GET /)
- **human_homepage** — Human-readable homepage with styled layout, discovery links, and surface overview (GET /?view=human)

### Emerging
- **oauth_discovery** [RFC 8414, RFC 9728, OpenID Connect Discovery 1.0] — OAuth protected resource metadata (RFC 9728) and OIDC discovery (RFC 8414) (GET /.well-known/oauth-protected-resource, GET /.well-known/openid-configuration)
- **api_catalog** [RFC 9727, RFC 9264] — RFC 9727 API catalog for automated API discovery via linkset format (GET /.well-known/api-catalog)
- **mcp_server_card** [SEP-1649, Model Context Protocol] — MCP Server Card (SEP-1649) for Model Context Protocol server discovery (GET /.well-known/mcp/server-card.json)
- **a2a_agent_card** [Google A2A Protocol] — A2A agent card at /.well-known/agent.json (and agent-card.json alias) (GET /.well-known/agent.json, GET /.well-known/agent-card.json)
- **llms_txt** [llms.txt] — LLM-optimized documentation at /llms.txt generated from the surface registry (GET /llms.txt)
- **link_headers** [RFC 8288, RFC 9727] — RFC 8288 Link headers on the homepage for agent resource discovery (Link header on GET /)