Docs for AI agents

Rightbrain publishes a version router and version-specific documentation indexes for AI consumption. It also provides a public Markdown endpoint for each task.

Documentation endpoints

Use the root router to select a documentation version, then use that version’s index to discover pages. Use the task endpoint to read one task’s contract.

Select a documentation version

https://docs.rightbrain.ai/llms.txt

The root file lists available documentation versions. The default version currently points to:

https://docs.rightbrain.ai/v-1/llms.txt

The version-specific file is the complete index for that version. Its page links already target Markdown resources and should be fetched unchanged.

A single task

https://app.rightbrain.ai/api/v1/public/{project_key}/llms/task/{task_id}

Markdown documentation for one task: what it takes, what it returns, and how to call it.

The router, version index, and task endpoint are public. The task endpoint returns the variables the task takes, its output shape, and the run and token endpoints needed to call it — not the prompts themselves, and not any run history.

Machine discovery

Give a coding assistant or autonomous agent the root llms.txt URL as the entry point. It should follow the selected version link, choose relevant page URLs from that version’s index, and fetch those URLs unchanged. The root file routes versions; it is not the complete page index.

Per-task documentation

To teach an agent how to call one specific task, fetch that task’s Markdown docs. Replace {project_key} and {task_id} with your values:

1
import requests
2
3
url = "https://app.rightbrain.ai/api/v1/public/{project_key}/llms/task/{task_id}"
4
task_docs = requests.get(url).text

The response describes the task’s inputs, output schema, and how to invoke it, formatted for an LLM to act on directly.

Next steps