Agent

Ayoh Agent

The AI agent built into Ayoh, one per workspace. You talk to it in Chat; it reads your mail, calendar, boards, notes and contacts, reads the files you give it, uses the apps you connect, and writes from your own addresses. It has no address of its own, and nothing is ever sent to it.

On this page · 9 sections

Setting it up
The agent and your mail
Giving it work
Your conversations
What it may do to your mail
What it can do
Agents and people
Connectors
Settings

Ayoh

New chat

Scheduled

Pinned

Q4 planning

All chats

This week

Onboarding call

Stripe payout

Photo picks from Maya

Berlin lease questions

This week

What's on this week, and did Priya need anything?

Thought for 2s· 4 steps

Three meetings, the first on Tuesday at 10. Priya needs your sign-off on the Berlin lease by Friday, so I put it on Launch › To do.

Ask a follow up…

9:41

Chat

What's on this week, and did Priya need anything?

Thought for 2s· 4 steps

Three meetings, the first on Tuesday at 10. Priya needs your sign-off on the Berlin lease by Friday, so I put it on Launch › To do.

Ask a follow up…

ChatMailBoardsNotesMore

9:41

Chat

What's on this week, and did Priya need anything?

Thought for 2s· 4 steps

Three meetings, the first on Tuesday at 10. Priya needs your sign-off on the Berlin lease by Friday, so I put it on Launch › To do.

Ask a follow up…

ChatMailBoardsNotesMore

Ask in plain words; it searches, reads and acts across the workspace, and says what it did.

Setting it up

There is nothing to set up: open Chat and ask — Chat and tasks is the everyday guide. Settings → Agent is where you shape it.

Pick a Model, or keep the one marked Default. Every model runs on Cloudflare Workers AI, so there is nothing to sign up for and no key to paste. Each card carries the maker's logo, what the model is for, its context window, its price per million tokens, and chips: Instant, Quick or Thinks first for how soon it answers, then Tools (which the agent needs to act at all) and Vision. A model that thinks first is stronger on tangled work and slower on all of it, which you feel in every answer. Another model takes any Workers AI model id.
Fill in About you: who you are, how to write, what never to promise. It starts empty. Home city is where it looks when a question depends on place (showtimes, restaurants, the weather) and you name nowhere. Press Save, which is lit only while there is something to save; Discard changes puts back what was there.
Choose whether it may send email for you, and whether it may file and trash mail. These switches and the model save the moment you set them.

The agent and your mail

It works in your mailboxes, not one of its own. It searches and reads every address's mail when a task needs it. Nothing is addressed to it and nothing it does arrives in an inbox of its own.
What it writes is yours to send. A reply, a new message, a message with a file from the chat attached: each lands as a draft in your mailbox, in the conversation it answers, for you to read and send.
Sending, when you allow it. With May send email for you on, it can send when you ask it to — from your first address unless you name another, at most five emails a task. What it sends carries Auto-Submitted: auto-generated, agent headers and a line underneath saying Ayoh Agent wrote it for you, so the person reading it knows.
An address a workspace gave its agent before it worked this way is an ordinary mailbox now: it keeps receiving mail in Mail, and the agent no longer answers it.

Giving it work

In Chat: Chat opens on a new conversation every time, with the cursor in the box. Ask anything; Enter sends and Shift+Enter makes a new line. While it works, one line says what it is doing — searching the mail, reading a page — and Stop ends the answer where it is.
Files: Files or Photos under the + beside the box (and Camera on a phone), a drop onto the box, or a paste attaches up to five files of 10 MB each to a question — a PDF, a Word or Excel file, a spreadsheet, an image, text or code. Each is read as it uploads: text as it is, documents and spreadsheets into text, images into a description. Ask about them, or ask for a draft with one attached. They stay in the conversation, and a click on one opens or downloads it.
Your voice: the microphone writes what you say into the box as you speak. The square stops it and leaves the words to read over; the ✓ stops it and sends them as they stand. The words come from your device's own dictation (the browser's speech recognition), not from Ayoh: nothing is recorded or sent to your workspace. Your browser asks for the microphone the first time. It listens in your browser's language. Leaving the app while it listens stops it and keeps what you said. Firefox has no dictation, so it shows no microphone.
From a letter you are writing: the composer's Describe your message line hands it the message on your screen. There it can read and look things up but only write that letter — it cannot send it, file your mail or write to anyone else. See Writing and sending.
Follow-ups: ask it to remind you, or to check on something later, and it schedules a follow-up for itself; when it is due it does what the note says and posts the outcome in the conversation you asked in, and your devices are told (with notifications on — see Notifications). It counts from your workspace's clock — the time zone under General — so “in two hours” and “tomorrow at 09:00” both land where you expect. Up to 25 can be waiting at once. They are listed at the foot of Settings → Agent, with a Cancel each.

Your conversations

Chat's column lists your Pinned conversations, then the rest, newest first, under a heading that is a menu: All chats, Shared, Private or Archived. Search chats, the magnifier in the bar, finds one by what was said. Click one to open it where it left off and carry on.
A conversation has its own address, so a reload or a link keeps it open. New chat — at the top of the column, or on a phone the round button beside the box — starts another.
Pin, rename, archive or delete one from the ⋯ on its row, or from its name over the conversation. Deleting asks first, and Delete all chats in the heading's menu clears the whole list (one still being answered is kept). Its messages and files go; whatever it did — drafts, cards, notes, events — stays where it did it.

What it may do to your mail

It always reads the workspace's mailboxes, and it leaves a draft rather than answering as you unless you let it send. Two switches in Settings → Agent decide whether it may also put mail where it belongs, so you can say “archive everything from that newsletter” or “pin the ones waiting on me” and have it done rather than described.

File and tidy, on by default: archive a conversation, move it back to the inbox, mark it read or unread, pin it. All of it reversible, all of it visible in your inbox.
Move mail to Trash, off until you turn it on, and only available with filing on. It also covers marking mail as spam. The Trash is recoverable.
Deleting for good is never granted. No setting gives it, so the worst it can do is put something in the Trash, where you can take it back out.
A task changes at most 50 conversations, and it says in its answer what it moved and where.
Without either switch it reads, drafts and tells you what it would do — it never files anything quietly.

What it can do

list_mailboxes · search_mail · list_recent · read_thread: Read the workspace's mail, all addresses or one: search by keyword, list a folder, read a conversation.
draft_in_mailbox: Leave a draft in a person's mailbox for them to review and send, with files from the chat attached when asked.
move_threads: Move conversations to a folder — archive, back to the inbox, and with the Trash power, Trash and Spam. Up to 25 at a time, so tidying a folder is one step.
mark_threads: Mark conversations read or unread, pin or unpin them. Also up to 25 at a time.
send_email: Only with May send email for you on: send from one of your addresses, files from the chat attached when asked; at most five per task.
find_contacts: Look someone up in the workspace's address book. Given a name rather than an address, it uses this rather than guessing one.
save_contact · delete_contact: Add someone to the address book or update them, by email address. It removes one only when asked.
list_events: Read the calendar between two dates: events with their guests, contacts' birthdays and board cards that fall due.
create_event · update_event · delete_event: Put an event on the calendar in your workspace's time, change its time, place, details or repeat, or mark it canceled. It removes one, every occurrence of a repeating one, only when asked.
search_notes · read_note · write_note · delete_note: Find notes by words in their title or text and read one whole. Make a note, or change one: add to its end, rewrite one section, or rewrite all of it only when asked. It deletes one only when asked.
write_draft: Write the letter somebody has open in the composer. Only when asked from there, and it is the only thing such a run can change — no sending, no filing.
create_card · create_note: File a card on a board; write a note in Notes, visible to the workspace.
list_boards · read_board · read_card: Read the boards: each board's columns and how many cards they hold, every card on a board, and one card in full with its checklist, files and comments.
update_card · update_checklist · comment_card · archive_card: Change a card — its title, notes, due date, whether it is done, or its column — add, tick or remove checklist items, comment on it, or archive it (it can be put back from the board's archive).
create_column · update_column: Add a column to a board, or rename, move or delete one. Deleting moves its cards to the first remaining column, as in the app.
organize_board: Sort a board into columns in one step: the columns in order, each with its cards. Columns that do not exist are made, cards left out stay where they are, and when asked the old columns left empty are deleted. Cards it could not find, or that are still in other columns, are named in its answer.
file_note · manage_board · delete_board: File a note in a Notes folder (made if there is none) or pin it; make a board with the columns you name, rename one, or delete one — which waits for your yes in Chat.
group_contacts: Put people in a contact list, or take them out. The list is made if there is none, and people not yet in Contacts are added.
list_digests · write_digest: Read your digests and lists, and write a digest or change a draft one. It never sends a digest: you send it from Digest.
list_drafts · edit_draft · delete_draft · send_draft: Read what is in Drafts and Scheduled, change a draft's recipients, subject or text, call a scheduled message back, or throw one away. send_draft sends one, now or later, only with May send email for you on.
read_mail_settings · update_mail_settings: Read and change your signature, blocked senders, spam filtering, and the reading, replying and AI drafting switches. It never blocks the workspace's own addresses.
manage_mail_folder · save_mail_filter · delete_mail_filter: Make, rename, color, nest or delete your mail folders (deleting one moves its mail to Archive), and make, change or delete mail rules, run over the inbox at once when asked.
list_tasks · update_task · delete_task: See its scheduled tasks and follow-ups, rename or reschedule one, pause, resume or run it now, or delete it.
schedule_follow_up: A reminder to itself, posted in the conversation when it is due: a minute to a year ahead, 25 waiting at most.
schedule_task: A scheduled task: something to do on its own once or on a repeat, each run a chat of its own. A run cannot schedule more tasks.
remember · forget · search_conversations: With Memory on, in Chat: keep or drop a fact about you, and look back through earlier chats for what was said or decided.
ask_owner · propose_cleanup: In Chat only: ask you a question with a few answers to pick from, or lay out a set of conversations to archive, trash or mark read, for you to trim and apply yourself.
gather: Hand up to four lookups to helpers that work at the same time, each with the reading tools only, when a question needs several places looked in.
find_app_tools · describe_app_tool · run_app_tool: Find a tool in a connected app, read its parameters, run it — Gmail, Slack, GitHub, calendars and the rest of what Composio offers. On Ayoh's shared Composio key running one costs a credit; on your own key it costs nothing. Finding and reading are free.
web_search · read_url: Search the web and read a page properly. Free, so the agent can look something up rather than guess.
MCP tools: Every tool of every MCP server you connect, offered to the model directly (up to 30).

Tool	What it does
list_mailboxes · search_mail · list_recent · read_thread	Read the workspace's mail, all addresses or one: search by keyword, list a folder, read a conversation.
draft_in_mailbox	Leave a draft in a person's mailbox for them to review and send, with files from the chat attached when asked.
move_threads	Move conversations to a folder — archive, back to the inbox, and with the Trash power, Trash and Spam. Up to 25 at a time, so tidying a folder is one step.
mark_threads	Mark conversations read or unread, pin or unpin them. Also up to 25 at a time.
send_email	Only with May send email for you on: send from one of your addresses, files from the chat attached when asked; at most five per task.
find_contacts	Look someone up in the workspace's address book. Given a name rather than an address, it uses this rather than guessing one.
save_contact · delete_contact	Add someone to the address book or update them, by email address. It removes one only when asked.
list_events	Read the calendar between two dates: events with their guests, contacts' birthdays and board cards that fall due.
create_event · update_event · delete_event	Put an event on the calendar in your workspace's time, change its time, place, details or repeat, or mark it canceled. It removes one, every occurrence of a repeating one, only when asked.
search_notes · read_note · write_note · delete_note	Find notes by words in their title or text and read one whole. Make a note, or change one: add to its end, rewrite one section, or rewrite all of it only when asked. It deletes one only when asked.
write_draft	Write the letter somebody has open in the composer. Only when asked from there, and it is the only thing such a run can change — no sending, no filing.
create_card · create_note	File a card on a board; write a note in Notes, visible to the workspace.
list_boards · read_board · read_card	Read the boards: each board's columns and how many cards they hold, every card on a board, and one card in full with its checklist, files and comments.
update_card · update_checklist · comment_card · archive_card	Change a card — its title, notes, due date, whether it is done, or its column — add, tick or remove checklist items, comment on it, or archive it (it can be put back from the board's archive).
create_column · update_column	Add a column to a board, or rename, move or delete one. Deleting moves its cards to the first remaining column, as in the app.
organize_board	Sort a board into columns in one step: the columns in order, each with its cards. Columns that do not exist are made, cards left out stay where they are, and when asked the old columns left empty are deleted. Cards it could not find, or that are still in other columns, are named in its answer.
file_note · manage_board · delete_board	File a note in a Notes folder (made if there is none) or pin it; make a board with the columns you name, rename one, or delete one — which waits for your yes in Chat.
group_contacts	Put people in a contact list, or take them out. The list is made if there is none, and people not yet in Contacts are added.
list_digests · write_digest	Read your digests and lists, and write a digest or change a draft one. It never sends a digest: you send it from Digest.
list_drafts · edit_draft · delete_draft · send_draft	Read what is in Drafts and Scheduled, change a draft's recipients, subject or text, call a scheduled message back, or throw one away. send_draft sends one, now or later, only with May send email for you on.
read_mail_settings · update_mail_settings	Read and change your signature, blocked senders, spam filtering, and the reading, replying and AI drafting switches. It never blocks the workspace's own addresses.
manage_mail_folder · save_mail_filter · delete_mail_filter	Make, rename, color, nest or delete your mail folders (deleting one moves its mail to Archive), and make, change or delete mail rules, run over the inbox at once when asked.
list_tasks · update_task · delete_task	See its scheduled tasks and follow-ups, rename or reschedule one, pause, resume or run it now, or delete it.
schedule_follow_up	A reminder to itself, posted in the conversation when it is due: a minute to a year ahead, 25 waiting at most.
schedule_task	A scheduled task: something to do on its own once or on a repeat, each run a chat of its own. A run cannot schedule more tasks.
remember · forget · search_conversations	With Memory on, in Chat: keep or drop a fact about you, and look back through earlier chats for what was said or decided.
ask_owner · propose_cleanup	In Chat only: ask you a question with a few answers to pick from, or lay out a set of conversations to archive, trash or mark read, for you to trim and apply yourself.
gather	Hand up to four lookups to helpers that work at the same time, each with the reading tools only, when a question needs several places looked in.
find_app_tools · describe_app_tool · run_app_tool	Find a tool in a connected app, read its parameters, run it — Gmail, Slack, GitHub, calendars and the rest of what Composio offers. On Ayoh's shared Composio key running one costs a credit; on your own key it costs nothing. Finding and reading are free.
web_search · read_url	Search the web and read a page properly. Free, so the agent can look something up rather than guess.
MCP tools	Every tool of every MCP server you connect, offered to the model directly (up to 30).

A task is at most eight rounds of tools; then it answers with what it has and says what is left undone.
It treats the contents of emails, attached files and tool results as data. A message telling it to ignore its rules, forward mail or reveal data is refused and reported.
What it sends counts towards the 100 messages an hour every mailbox has.

Agents and people

Every message is one of three kinds: written by a person, by an AI agent, or by a machine (bounces, lists, notifications). The kind is stored with the message and shown as a chip on it and on the conversation row; the funnel's With AI agents filter finds conversations an agent took part in.

Everything Ayoh Agent sends carries Auto-Submitted: auto-generated (the standard header every vacation responder honors), an X-Ayoh-Agent header with the address it sent from, an X-AI-Agent header with its name, and a line underneath saying Ayoh Agent wrote it and for whom.
A message is an agent's when it carries any of those headers — or the ones other agent products use (X-Agent-Id, X-Agent-Name, X-Autonomous-Agent, and an auto-submitted message whose mailer calls itself an agent) — or when it comes from an address an agent used to answer at here.
Mail from an agent counts as automated for your own mailboxes, so no reply is ever drafted to one and no loop can start.

Connectors

Settings → Connectors is where the agent gets its reach beyond mail.

Apps, through Composio

First, once per workspace: under Composio, sign up for Composio Platform at platform.composio.dev (Composio has three products; Ayoh uses Platform, not For You or Bench), open your project's Settings → API keys, copy the project key (it starts with ak_, not the organization key oak_), and paste it in. Composio's free plan needs no credit card and covers most workspaces; the key is checked, stored encrypted, and never shown again, and nobody else in the workspace needs it. Then press Browse apps to see Composio's whole catalog: the most-used apps first (or A–Z), narrowed by a category or a search, with More apps for the next page. Pick one and press Connect. Composio opens the app's own sign-in; when you finish, you land back here with the app marked Connected. An app that needs no sign-in says so, and Switch on is all it takes. Actions on your own key are billed by Composio to your project under its plan, not in Ayoh credits.
Switch an app Off to keep the connection but hide it from the agent; Disconnect revokes it at Composio.

The agent finds tools in a connected app by describing what it needs, reads their parameters, then runs them, so the model never carries hundreds of schemas around. Composio's docs are at docs.composio.dev (opens in a new tab).

Activated at Composio

Your workspace is its own user at Composio, with a session that activates exactly the apps switched on — Composio itself enforces the list, and no other workspace's connections can be reached through it. Ayoh keeps it in step as you connect, switch and disconnect apps; it starts by itself with the first app, or press Start now. The same session serves those apps as one MCP server: paste its URL into Claude, Cursor or any other MCP client to use the same connections there. The URL is a secret; New URL replaces it and cuts off anything using the old one.

Other MCP servers

Add a server connects the agent to any MCP server over HTTP by URL. Its tools join the agent's directly. A server that wants a sign-in shows Sign in; the sign-in comes back to Ayoh by itself.

Settings

Switches and the model save the moment you set them. About you and Home city wait for Save.

Switched on: Off, Chat says so instead of answering, the composer's describe line falls back to the mailbox's own assistant, and follow-ups it scheduled are skipped.
About you: Who you are and how it should behave. Every task starts from this. Up to 8,000 characters; empty to begin with, and Clear empties it again.
Home city: Where it looks when a question depends on place (showtimes, events, restaurants, the weather) and you name nowhere. Up to 120 characters. Left empty, it uses a city your About you or its memories name, and otherwise asks.
Memory: Remember across conversations, and the facts it has kept — see Memory.
Model: The Workers AI model that does the thinking and calls the tools; it must have Tools. Keeping the card marked Default follows the instance default, Gemma 4 26B: a mixture-of-experts model that answers at the speed of its 4B active parameters, with 256k of context for long threads, run with its thinking pass off so the reply starts at once.
May send email for you: Off (the default), everything it writes to somebody waits as a draft. On, it may send when you ask — from one of your addresses, at most five a task, marked as written by Ayoh Agent.
File and tidy: Whether it may archive a conversation, move it back to the inbox, mark it read or unread, and pin it. On by default; every one of those is reversible and shows in the mailbox.
Move mail to Trash: Whether it may also put mail in the Trash and mark it as spam. Off by default, and available only with File and tidy on. Deleting for good is never granted to it.

Setting	What it does
Switched on	Off, Chat says so instead of answering, the composer's describe line falls back to the mailbox's own assistant, and follow-ups it scheduled are skipped.
About you	Who you are and how it should behave. Every task starts from this. Up to 8,000 characters; empty to begin with, and Clear empties it again.
Home city	Where it looks when a question depends on place (showtimes, events, restaurants, the weather) and you name nowhere. Up to 120 characters. Left empty, it uses a city your About you or its memories name, and otherwise asks.
Memory	Remember across conversations, and the facts it has kept — see Memory.
Model	The Workers AI model that does the thinking and calls the tools; it must have Tools. Keeping the card marked Default follows the instance default, Gemma 4 26B: a mixture-of-experts model that answers at the speed of its 4B active parameters, with 256k of context for long threads, run with its thinking pass off so the reply starts at once.
May send email for you	Off (the default), everything it writes to somebody waits as a draft. On, it may send when you ask — from one of your addresses, at most five a task, marked as written by Ayoh Agent.
File and tidy	Whether it may archive a conversation, move it back to the inbox, mark it read or unread, and pin it. On by default; every one of those is reversible and shows in the mailbox.
Move mail to Trash	Whether it may also put mail in the Trash and mark it as spam. Off by default, and available only with File and tidy on. Deleting for good is never granted to it.

PreviousAI in your mail NextCredits and usage