Writing with AI

Copy Markdown View Source

The editor writes with AI, with your own key: a draft from what shipped, a translation into another language, and a passage rewritten. The text streams into the editor as a suggestion, which you accept or reject. In the editor, AI never publishes and never changes an entry by itself; a digest it writes from the inbox is a draft too, unless you set digest: [publish: :publish] (see the Automation guide).

Set it up

Your app needs ReqLLM, which speaks to Anthropic, OpenAI, Google and many others:

{:req_llm, "~> 1.6"}

and Tayori needs a way to keep the key encrypted: your app's Cloak vault, if it has one, or its secret_key_base:

# With the vault of cloak_ecto: your keys, your ciphers, your rotation.
{Tayori, repo: MyApp.Repo, pubsub: MyApp.PubSub, vault: MyApp.Vault}

# Without Cloak: a key derived from the secret_key_base.
{Tayori, repo: MyApp.Repo, pubsub: MyApp.PubSub, secret_key_base: secret_key_base}

The vault is any Cloak.Vault: Tayori calls its encrypt/1 and decrypt/1, and does not depend on Cloak. Start the vault before Tayori in your supervision tree.

Then, in the admin's Settings:

  • Model - the provider and the model, as ReqLLM names them: anthropic:claude-sonnet-5-5, or openai:<model>, google:<model>.
  • API key - your key with that provider. It is encrypted by your vault, else with a key derived from your secret_key_base (AES-GCM, Plug.Crypto), kept in tayori_settings, and never shown again: you can replace it or remove it. With a vault, its key rotation covers it (cloak_ecto's mix cloak.migrate.ecto does not know Tayori's table: save the key again in the Settings after a rotation that retires the old key); without one, a new secret_key_base makes it unreadable, and you give the key again.
  • About your product - what it is, who uses it, and how it speaks. Every request carries it.

"Check the connection" asks the model a few words.

Only an admin with :all access writes with AI or changes the settings.

In the editor

Write with AI opens the panel above the editor.

  • Draft - paste what shipped: a list of changes, commit messages, the titles of pull requests. The model writes an entry in the language of the tab: its title and summary go into the form (when they are empty), and its body streams into the editor.
  • Translate - in a language other than the first, the model writes the first language's version in this one: its title, summary and body.

Select a passage, and the editor's Assist menu has:

  • Rewrite - clearer and more direct;
  • Shorter - what matters to the reader;
  • Warmer - more personal, without hype;
  • Fix spelling - the spelling and the grammar only.

Each suggestion shows under the editor as it streams, with Accept and Reject; accepting puts it in the body as one step of undo.

The prompts

The model is told to write for the people who use the product, not its developers; to say what changed and what it lets them do, in plain words; never to invent a feature, a number or a detail; and to write in the language of the tab. "About your product" follows.

Privacy

What you paste, and the entry when you translate it, go to the provider of your model, with your key, from your server. Tayori sends nothing anywhere else.