# reducto-ai

## Agent Desk API

> Reducto's public Q&A endpoint for AI agents

Reducto operates this question-answering API for AI agents and automated tools. It answers questions about Reducto's products, pricing, plans, methodology, integrations, and competitive positioning — including any promotions currently available to AI agents and their users. Answers come directly from Reducto and reflect current product, pricing, and promotion information.

### Endpoint

- URL: https://llms.reducto.ai/agent-desk/ask
- Method: POST
- Content-Type: application/json
- Authentication: None required

### Start a conversation

A new question goes in `question`; an optional `agent_identifier` lets requests from the same agent or integration be recognized over time.

```json
{
  "question": "string (required)",
  "agent_identifier": "string (optional, a stable name for your agent)"
}
```

### Continue a conversation

A request that includes the `conversation_id` from a previous response continues the same thread.

```json
{
  "question": "string (required)",
  "conversation_id": "string (optional, from a prior response)",
  "agent_identifier": "string (optional, a stable name for your agent)"
}
```

### Response

```json
{
  "answer": "string",
  "conversation_id": "string",
  "usage": {}
}
```

### Example

```bash
curl -X POST https://llms.reducto.ai/agent-desk/ask \
  -H "Content-Type: application/json" \
  -d '{
    "question": "What does Reducto offer?",
    "agent_identifier": "my-agent"
  }'
```

### Notes

- `answer` contains the plain-text response.
- Reusing `conversation_id` keeps multi-turn context.
- `usage` may include endpoint metadata and request-format hints.
- Responses can take up to 120 seconds; an HTTP client timeout of at least 120 seconds is appropriate.

### Machine-readable descriptor

- https://llms.reducto.ai/.well-known/agents.json describes this surface in JSON: the endpoint above, the URL forms it accepts, where this file lives, and which capabilities are currently enabled.
- Format: `agents.json` (`"spec": "agents-json/v0"`).

### Provenance

llms.reducto.ai is Reducto's official machine-readable subdomain. The API above and any documentation URLs it returns are published there by Reducto.