Sonata

Documentation · For everyone

Chatting with agents

An agent reads, reasons, and drafts. When it reaches beyond the conversation, into the web or your connected systems, the rules are simple: reading is open, acting waits for you.

What an agent works from

An agent answers from its instructions, the conversation, and whatever you attach. Agents with web search enabled can also search the open web. Sonata can also connect agents to systems your organization runs, like Google Workspace, under your governance; when an agent uses a connected tool, a quiet line in the conversation names the call, like Google Drive: search files.

Citations and sources

When an answer draws on the web or your documents, its sources are listed with the answer, each a real link. Citations carry into the Word export as footnotes. An answer that rests on sources is one you can check, and Sonata expects you to: treat agent output as a strong draft for your review, not a finished opinion.

When an agent wants to act

Sonata draws a hard line between reading and acting. By design, reading is open, but any action that would change something outside Sonata, like sending an email or creating a file, is built to pause the conversation and show you exactly what the agent wants to do. Nothing happens until you approve that specific action; decline it, and the agent carries on without it. This is not a setting you can turn off, and that is deliberate.

Research in chat

If your organization uses Knowledge collections and in-chat research is available, an agent can research them mid-conversation for small questions, reading up to 15 documents and citing what it finds. For bigger questions, the agent points you to the Research page, which is built for corpus-scale work and always available.

The deterministic agents

How to

Put an agent’s tools to work

  1. For current information, ask an agent that has Web search on. Web search is enabled per agent, so turn it on in the agent’s settings if yours doesn’t have it.
  2. When your organization has connected a system and policy allows it, an agent can also reach into it, for example to find a document in Drive (“find our latest MSA in Drive”).
  3. The agent decides when to use a tool; each call shows as a quiet line in the conversation, named plainly, like Google Drive: search files.

Approve or decline an action

  1. When an agent wants to change something outside Sonata, a card pauses the conversation and names the action, like creating a file on Google Drive.
  2. Review what it will do, then select Approve or Deny.
  3. Approving runs that one action; denying it lets the agent acknowledge and carry on without it. Nothing runs without your decision.

Follow a citation

  1. Select a numbered marker in the answer to jump to its entry in the Sources list beneath it.
  2. Each source is a real link; open it to verify the answer against the material itself before relying on it.

Switch the model

  1. Select the model name in the composer and pick from the quick list.
  2. The change applies to the agent from here on; existing conversations keep the model they started with. You can switch models on your own agents, and admins on approved agents.

All documentation · Everything above describes the product as it ships today. If something here doesn’t match what you see, tell us.

← Back to documentation