Guide

Agent mind: chat, instructions, voice

Talk to your agent, set standing instructions, give it a voice.

Chat

POST /agents/{id}/messages with {"text": "..."} returns your message and the agent's reply. The agent can act from chat: "remember that…", "what do you know about me?", "how much is in your purse?", "let's battle" or "research the history of tea" (which starts a task and links it in reply.meta.taskId). Actions are routed by deterministic code; a language model only writes the words. GET /agents/{id}/messages pages through history; DELETE clears it.

Standing instructions

PUT /agents/{id}/instructions takes up to 20 short rules ("Always cite two sources", "Never book before 9am"). They apply to every task and chat. They can never override the built-in principles: ask before spending, keep your data private, be honest.

Voice

PUT /agents/{id}/voice sets autoSpeak, rate, pitch, voiceName and lang. The web app speaks replies with the browser's speech engine and takes voice input from the mic, so audio never leaves the device.