Skip to main content

Documentation

Agents that operate for you, with autonomy you can prove.

One API for the whole lifecycle of an agent — configure it, version it, give it knowledge and tools, put it in front of people on the channels they already use, and read back what it did and what it cost. The app, the CLI and the SDK are thin clients over exactly the contract documented here.

Your first agent generationRead the introduction

Start here

Docs

One page per module — what it is, its data model, and the concepts the schema does not show. Grouped by feature, foundations first.

Tutorials

End-to-end walkthroughs, each delivering one working result. Every call is given for the CLI, the SDK and curl.

API Reference

The generated REST reference, one page per operation, derived from the OpenAPI documents that are the binding wire contract.

Clients

The generated TypeScript SDK and command-line interface, and the MCP server your assistant connects to. Thin clients over the same contract, not a second surface.

By feature

Agents

A versioned configuration with tools, knowledge and a model.

Knowledge

Ground answers in your own documents, with the source to cite.

Channels

Put an agent on WhatsApp or Discord, where people already are.

Automation

Run agents on a schedule, an event or by hand, with a record of each firing.

Control

Guardrails on tool calls, human approvals and an audit log.

Evaluations

Score a change against your own cases before it ships.

Models

Managed models with no vendor account, or your own credential.

At a glance

Base URLhttps://api.naturali.ai/v1
AuthenticationAuthorization: Bearer nat_sk_… — an API key, project-scoped by default, or a session token. See Authentication.
Installnpm install -g @naturali/cli · npm install @naturali/sdk
For agentsllms.txt · openapi.json · ard.json. Any page here is Markdown with .md appended to its URL.