Skip to content

Cards in chat

A card is a question, a plan to approve, or a quiz inside a conversation. It keeps the question and its answer together in the chat history. The cards Donkit shows in Direct, such as a connection offer, facts or a mail, are described in Direct.

What a card shows

  • Questions show the agent's name, the question and the available answers. Choose an option. A card with several questions shows them one at a time: choosing an answer moves you to the next question, Back returns to the previous one, and Send on the last question sends all your answers together. If a question lets you choose several answers, make your choices, then press Next or Send.
  • Confirmations ask for a yes or no, with Yes and No buttons. A plan can show its steps and description, with Approve plan and Request changes. To request changes, write what should change and press Send.
  • Quizzes appear under Check yourself. Each question has answer options, feedback and an explanation after you answer.
  • Task questions show a scheduled task's question and answer buttons. Their actions are explained in Tasks.

Answer now or later

An agent's question stays in the chat. After a reload you still see the question and your answer. You can return to an open question and answer it on the web, iPhone, Mac or Android, even after the agent's turn has ended or the app was closed. The answer is saved before the agent continues. Answering on one device updates the card on your other connected devices and closes the waiting question there.

Outside a project, every question waits for your answer: the agent does not choose for you.

Once you have answered a question and the chat has moved on, the card folds into one line with the question and your answer. Press the line to open the card. When the agent asks several questions in a row, the answered ones fold together with its steps into one line; open it to see each question with your answer. A question that is still waiting for you always shows in full.

If the agent has already stopped waiting, your answer still reaches it: the agent continues in that conversation by itself. A question the agent has closed or replaced with a newer one no longer takes answers. After you connect an account from a card, the agent continues by itself; you don't need to repeat the request.

Cards that need the agent to be waiting, such as entering a secret, approving a guarded action, or a proposal to create an agent or a project, close when the agent's turn ends and stay in the conversation as a record.

In the chats of the built-in agents, you can answer a question anywhere while the agent waits for it. Once the agent stops waiting, the Android, iPhone, iPad and Mac apps show the question without answer buttons: you see the question and what became of it. On the web you can still answer it, except in the Researcher.

Writing instead of answering

If you send a new message instead of answering, the agent's open questions in that chat close as Dismissed. Your message reaches the agent as a new message, not as the answer. This does not fill in a quiz. A scheduled task's question can be answered in words, as described in Tasks. In a project, answering works as described in Questions in projects.

Important questions

An important question shows Only you can decide. These are questions about money, deleting anything, sending anything outside, or a choice that sets the direction of the whole work. Outside a project it waits for your answer like any other question. A question in a project works differently: see Questions in projects.

Take a quiz

A quiz stands right after the reply it came with.

Choose an answer to see Correct or Not quite, the correct option and an explanation. Press Next to continue, or Back to return to an earlier question. You can change an answer; the latest choice counts toward the score.

After answering every question, press See result to see your score and every question with its correct answer; press a question in that list to open it again. Try again clears your choices and starts a new attempt.

Checking answers does not call an AI model or spend credits. By default, the quiz only saves your result. If the agent has set the quiz to receive a result, it gets one summary per completed attempt: the score and the numbers of the questions you got wrong. Changing answers after completion updates the score without asking the agent to reply again. The score stays in the chat; correct answers and explanations stay inside the quiz card. The result in the chat also names the questions you got wrong, so the agent sees them in the chat history.

Questions in projects

A question from an agent in a project is one card, in the project chat and in Waiting for you.

Answer it with a button on the card, or with a message to that agent in the project chat that includes @agent. An important question, marked Only you can decide — money, publishing, sending code outside the project, or deleting data — is answered only in those two ways. Words without @ do not answer it. A question that is not important can also offer Decide for me.

In Do it all, show me at the end, Donkit answers an ordinary question at once. The card has no buttons under that decision. Change Donkit's choice by telling Donkit in the project chat.

Waiting, the question list and Decide for me are described in Projects.

Cards from tasks

A task can leave a question or a quiz in the chat it writes to, described in Where messages arrive, without waiting for someone to be at the screen. The run does not stop to wait: the question stays in the chat until you answer it, and the task does not answer it for you. Your answer, whenever it comes, continues the conversation in that chat.

The task's result notification or email includes the text of the cards from that run after the main result. Quiz questions and options are included, without the correct answers or explanations.

A scheduled task question keeps your answer in the task history. If you answer it again from another device, the first answer stays and its action is not repeated.

Questions from called agents and the builder

Outside a project, an agent called into your chat asks there under its own name. You can press an answer while it waits. These questions are only active during that wait. Questions in the builder also use a temporary wait; they are not saved cards that you can answer later.

Notifications

If question notifications are enabled and the chat is not open on any device, a question in your chat with Donkit can send a notification with the agent's name and the question.

On iPhone and Mac, you can answer a yes/no question from the notification, or type a reply to a single question with choices. Questions with several parts open the chat instead.

On Android, tap the notification to open the chat and answer there. Quizzes do not send a separate question notification. Permission prompts that work only while the agent waits keep their usual notifications.

Older apps

In older versions of the iPhone, iPad, Mac and Android apps, open the chat to answer a yes/no or multiple-choice question. The chat also keeps the answer if you already sent it. For newer card types such as quizzes, update the app or open the chat on the web. In Windows 0.3.2, use the web app to answer a question from chat history.