Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.maia.ai/llms.txt

Use this file to discover all available pages before exploring further.

Public preview provides you with a kanban-style dashboard, where you can create, track, and manage tasks being executed by . In , you can chat with about any of your tasks across any of your projects without needing to navigate between those projects. create a new branch for each task in . This branch is based on the source branch you select when creating the task. Once a branch has been created, you can see it in your project and open it in to see the work that have done so far. When you’re talking to about a task in , each task has its own chat interface. You can switch between tasks and conversations without losing the context of your existing chats with .

​
Viewing tasks

To access , in the left navigation, click the AI Agents icon. The board contains four columns. The column title indicates the status of each task on your board:
  • Backlog: Tasks that have been created but not started.
  • In progress: Tasks that are currently working on.
  • Needs attention: Tasks that require your input—for example, if have asked a question.
  • Completed: Tasks that have finished working on.
A maximum of 10 tasks can be in progress at any time. When there are already 10 tasks in the In progress column, the following restrictions apply:
  • Creating a new task: You cannot create a new task and tell to start working on it immediately. You can create the task, but it will be added to the Backlog column.
  • Starting an existing task: You cannot tell to start a task in the Backlog column. The task will remain in the Backlog column.
  • Responding to : Responses to questions from about tasks in the Needs attention column will not be processed, because cannot continue working on the task.
To perform any of these actions, you need to wait until fewer than 10 tasks are in progress. You can then tell to start a task or respond to a question. If doing this means there are 10 tasks in the In progress column again, the same restrictions will apply until fewer than 10 tasks are in progress.
Above the columns, you can filter or search for specific tasks in three ways:
  • Use the Projects drop-down to filter the whole board so that it only shows tasks belonging to the selected projects.
  • Use the Period drop-down to filter the Completed column so that it only shows tasks that have been completed within the selected time period. Tasks in the Backlog, In progress, and Needs attention columns are not affected by this filter.
  • Use the search field to search for tasks by their title.

​
Creating tasks

To create a new task, either in the backlog or for immediate action:
  1. In the Backlog column, click + Add task. This opens the New task dialog.
  2. In the Project drop-down, select the project in which you want to work on this task.
  3. In the Branch drop-down, select the branch that you want to use as the base for this new task.
    1. Select the Create new branch checkbox if you want to create a new branch for this task. If you don’t check this box, will work on the task in the branch you selected.
  4. In the Environment drop-down, select the environment you want to use as your data warehouse connection.
  5. In the Knowledge Graph drop-down, select the knowledge graph you want to use for this task. This is the knowledge graph that will use to inform their work on this task. Knowledge graphs are a way to organize and represent information about your data, projects, and workflows, and selecting the most relevant knowledge graph helps to work more effectively on your task. Read to learn more.
  6. In Prompt, describe the task that you want to complete for you. The following controls are also available in the prompt area:
    • Click + to attach an image or PDF and give additional context.
    • Click @ to reference an attached file in your prompt.
    • Click Plan mode to start in plan mode.
    • Click Ask permission to toggle between Ask permission and Bypass permissions modes.
  7. Select one of the following options:
    • Click Create to add the new task to the backlog without working on it.
    • Click Start task to tell to start working on it immediately.
Your new task appears in the Backlog column. If you clicked Start task, the task automatically moves to the In progress column (if you don’t already have 10 tasks in progress) once have finished creating the task and assigning it a title.

​
Working on tasks in Mission Control

The process of working on a task in is made up of four steps:
  1. Tell to start working on a task.
  2. Monitor the task and provide any additional information that need. You may need to do this multiple times, particularly for complex tasks.
  3. Review ’ work in .
  4. Move the task to the Completed column once you’re happy with the finished product.

​
Starting a task

If you click Start task when creating a task, begin working on this task immediately. To tell to start working on a task in the Backlog column, click the task. In the Edit task dialog, click Start task.

​
Monitoring a task in progress

While a task is in the In progress column, click the task to open the chat interface about this task. Here, you can:
  • See ’ progress on the task
  • Send a follow-up message to give additional information
  • Switch to plan mode.

​
Responding to

When require information from you to work on a task, the task moves to the Needs attention column. Click a task to open the chat interface about this task and provide the required information. may ask for input in a range of situations, including:
  • Asking what you’d like a new table to be called.
  • Checking the authentication method you want to use when configuring a connector.
  • Asking whether you want to use hardcoded values or a project or pipeline variable.
After you answer any outstanding questions, the task automatically moves back to the In progress column until either more information is needed or the task is completed.

​
Reviewing ’ work in

You can review the work that have done when the task is in the In progress or Needs attention column. To do this, click the task to open the chat interface about this task, then:
  • If the task is in the In progress column, in the top right, click Open in .
  • If the task is in the Needs attention column, at the bottom of the chat, click Review in .
This opens the branch created for this task in . Your conversation with also opens, so you can continue the conversation from . You can work on the branch in and then return to — are aware of any changes you’ve made.

​
Completing a task

After you’ve reviewed the work and are happy with the finished product, mark the task as Completed in . To do this, click the task to open its chat interface, then click Move to completed. Completed tasks stay in the Completed column of your board until you delete them, or until the Period drop-down filters them out. To remove a task from the Completed column, delete the task.
Completing a task in does not make any changes to the task branch, or make these changes visible on any other branches. To see these changes in your project, you need to commit, push, and merge the changes from the task branch to the source branch.First, commit and push the task branch changes. You can tell to do this in your conversation in or , or you can do this yourself in .Next, merge the changes from the task branch to the source branch in . can’t merge changes—this ensures that only reviewed, approved work is merged to your source branch.

​
Editing tasks

You can only edit tasks in the Backlog column of your board. Once have started working on a task, you can’t edit it. To edit a task, click the task to open the Edit task dialog. You can edit the project, source branch, environment, knowledge graph, and task description (prompt). The same prompt controls available when creating a task are also available here. After editing a task, either:
  • Click Update to save your changes and leave the task in the Backlog column.
  • Click Start task to save these changes and tell to start working on the task (if 10 tasks are not already in progress).

​
Attaching images and PDFs

When creating or editing a task, you can attach images and PDFs to the prompt to give additional context. To attach a file, click + in the prompt area and select the file you want to attach. work directly from the content of your attachments. You can attach:
  • Images: such as diagrams, screenshots, mockups, and whiteboard photos
  • PDFs: such as specifications, requirements documents, and reports
To reference an attachment in your prompt, click @ in the prompt area, or type @ followed by the filename.
Text files (.txt, .md, etc.) aren’t supported as attachments. These file types belong in the project itself, where can already read them.

​
Bypassing permissions

By default, run in Ask permission mode. In this mode, pause before executing tool calls and ask you to approve them before proceeding. Bypass permissions mode is the opposite: execute tool calls immediately, with no approvals, decisions, or check-ins required. To enable it, click Ask permission in the prompt area to toggle to Bypass permissions before creating or editing a task. Bypass permissions is useful for trusted, hands-off runs such as prototyping or clearing a backlog in a sandbox environment. We recommend keeping Ask permission as your default and enabling Bypass permissions only for tasks where you know what are doing and have scoped your environment accordingly.

​
Deleting tasks

You can’t restore a task that has been deleted.
You can only delete tasks from the Backlog and Completed columns of your board. You can’t delete tasks that have started working on. To delete a task, hover over the task and click the Delete icon in the top right of the task. In the Delete task dialog, click Delete.