# AI Chat Assistant Zaphiri's built-in AI chat assistant, **Ask Zaphiri**, lives in the right sidebar and stays with you as you move around the app. Open it once and it stays open across views: no switching tabs, no losing your context. > [!quote] Work smarter without working elsewhere > > The assistant is right where your tasks are. Ask it to take action, get answers to how-do-I questions or refine your writing, all without leaving the app. ## Opening the assistant ![[ask-zaphiri-panel.png|376]] Ask Zaphiri opens from the sparkle icon in the right rail. Prompts are grouped by scope (**Today**, **This Week** and **Insights**), so you can start from a suggestion instead of a blank box. The assistant panel stays open as you move between views. To close it, select the icon again or press the close button at the top of the panel. ## Two modes The assistant has two distinct modes, each with its own entry point. ### Tasks mode Tasks mode is for working with your data. You can ask the assistant to: - Complete, move, or create tasks - Discuss specific tasks or projects using `/task` or `/project` slash commands - Get schedule insights and ask questions about your workload Actions run immediately. If you ask the assistant to complete a task, it updates on your board right away. > [!tip] Use slash commands for context > Type `/task` to select a specific task and bring it into the conversation, or `/project` to discuss everything in a project. The assistant uses that context to give you relevant, specific responses. ### Ask about your task history In personal Tasks mode, ask questions such as "How long do my writing tasks usually take?" or "How much time did I spend on client reviews?" Ask Zaphiri can compare similar past tasks and use their tracked time to help you estimate future work. - **Actual time** comes from tracked sessions; planned time is shown separately - **Coverage** tells you how many matching tasks have tracked time and how many do not - **Sources** let you open the tasks behind the answer and check the details - **Repeating tasks**: Ask about a repeating task or recurring calendar event by its exact title to get its total, average, median, and range of tracked time for the period. If more than one series shares the title, Ask Zaphiri asks which one you mean The usual lookback is 90 days. Ask for a different period when needed, up to 365 days. An answer based on a few tracked examples gives you less evidence than one based on a larger history. ![[ask-zaphiri-task-history.png]] ### Ask about your labels In personal Tasks mode, ask **Which labels do I have?** or **Which of my labels fits this task?** Ask Zaphiri can look up the labels in your current Work or Personal view, including which ones have habit tracking enabled. Use `/task` to bring a specific task into the conversation. Its Work or Personal view and current label help ground the recommendation. Ask Zaphiri compares your existing options and identifies any suggestion for a new label as a new idea. You apply the recommendation yourself. This lookup reads labels; it does not apply, create, rename, or delete them. See [[Projects & Labels]] to manage your options. Personal label lookup is separate from team-scoped conversations. ![[ask-zaphiri-labels.png|376]] ### Help mode Help mode is for how-do-I questions about Zaphiri. Access it from the question mark icon in the sidebar rail. The assistant searches your help documentation and gives you answers grounded in the actual docs, not guesses. Ask it about Daily Planning, settings, integrations or features, and it finds the relevant information and walks you through it. - **Quick help cards** surface common questions so you can get answers without typing - **Conversational follow-ups** work naturally: ask a follow-up and the assistant keeps the context - See [[Help Chat]] for more detail on how Help mode works ## Ask Zaphiri in Team Projects > [!note] Part of Team Projects > Team Project scoping is part of [[Team Projects]]. Open Ask Zaphiri inside a Team Project and it scopes itself to that project. A **"Team Project: [name]"** chip shows the scope clearly. Scoped conversations only see that project's own tasks, members and activity. Your personal tasks, projects and labels do not appear in a team-scoped answer, and team work does not appear in a personal one. - **Follows you automatically**: The scope switches when you open a Team Project and stays until you navigate elsewhere - **Its own conversation history per project**: Each Team Project keeps its own history, separate from your personal history and from other projects - **Ask about a specific task**: Ask Zaphiri can read a task's full description, not just its title, so you can ask detailed questions about the work itself - **Cites Project Docs too**: Answers in a Team Project can reference that project's Docs as well as its Tasks ## Conversation threads Each conversation is organised into a thread, and every location (personal or a specific Team Project) keeps its own history of past threads, not just the latest one. You can: - Select **New** to start a genuinely empty thread without changing the current task or project scope - Browse and search past threads for that location to continue an earlier conversation - Delete threads you no longer need You can return to a conversation while you still have access to its context. Access changes can make older conversations unavailable, including conversations that were open when access changed. Restoring access does not restore those conversations; start a new one to use your current access. If Zaphiri asks you to start again after a connection or context change, check whether an earlier action already happened before asking it to repeat that action. Threads have a 25 message pair limit. When a thread reaches the limit, start a new one to continue. ## Response features The assistant renders responses with structure when the content calls for it: - **Task chips**: Referenced tasks appear as styled chips you can select - **Task, Note, and Project Doc references**: When a response mentions a specific task, personal Note, or Project Doc, a recognisable blue link opens it directly and provides a hover preview - **Callout cards**: NOTE, WARNING, and TIP blocks are rendered visually for easy scanning - **Message actions**: Hover a message to copy it, or turn it straight into a task - **Response feedback**: Rate any response with thumbs up or down ## Follow a reply and control the panel A status line shows what Ask Zaphiri is doing while it replies. When it finishes, expand **Finished in N steps** to inspect the steps and any failures. ![[ask-zaphiri-live-steps.jpg|480]] Choose **Stop** to stop receiving the current reply. Text already shown stays in the current conversation view, but stopped partial replies are not kept after reload. A task change already saved remains saved. Check the task before asking for the same action again. On desktop, drag the edge beside Ask Zaphiri to resize the panel. Focus the resize handle and use Left or Right, Home, or End for keyboard control. Double-click the handle to reset its width. Smaller screens use the available Widen control instead of the drag handle. The width is remembered in this browser. Notes keeps its own width setting. ## Draft first, then approve a note change Open the relevant Team task and select **Task** grounding in Ask Zaphiri. Ask for a draft here and say **Do not update the task** when you want to review wording first. After reviewing the draft, give a separate instruction such as **Add that at the top of the task as a quote**. Open the task to check the result. You can request a further draft without authorising another edit. See [[AI Configuration]] to choose a personal or project AI provider for the conversation. ## Researching a task hierarchy Ask Zaphiri can search a team task and its direct subtasks for a requirement, decision, or exact value. Be explicit when the request needs every direct subtask checked. For a complete hierarchy request, the response reports how many accessible direct subtasks were checked and distinguishes an exact match from related wording. If a limit prevents complete coverage, Ask Zaphiri states that limitation instead of implying a complete result. Task, Note, and Project Doc links in the response identify the source of each material finding so you can open and verify it. ## Choosing your AI provider By default, the assistant uses Zaphiri's built-in key. If you want to use your own Anthropic or OpenAI account, you can configure that in [[AI Configuration|Settings: AI Configuration]]. The provider selector in the chat panel lets you switch between your key and Zaphiri's key on a per-conversation basis. Each plan includes some requests on Zaphiri's key: 25 in total on Solo, and 100 a month on Solo Pro and for every member of a Team or Team Pro workspace. See [[Plans & Billing#AI requests]]. > [!note] Team Project keys take priority > If a Team Project owner has set a project-level AI key (see [[AI Configuration]]), that key is used by default for team-scoped conversations, shown as a **"(team)"** badge in the provider picker. You can still pick one of your own personal keys instead. Your explicit choice takes priority over the project's key. --- **Next:** Learn how to configure your own AI keys in [[AI Configuration]].