Skip to main content
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 panel. You can switch between tasks and conversations without losing the context of your existing chats with . To learn about using alongside other tools such as Slack, read integrations.

​
Video example

Watch this video for an overview of and how to use it to create and manage tasks for .

​
Viewing tasks

To access , in the left navigation, click , then .
is only visible in the left navigation if the Enable AI Agents permission is enabled for your account.
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 search for tasks by their title, and select any combination of the following options in the Filter by drop-down to filter the tasks shown on the board:
  • Projects: Only show tasks belonging to the selected projects.
  • Source app: Only show tasks that were created using the selected applications—the API, , and/or .
  • Source branch: Only show tasks that are working on in branches based on the selected source branch.
  • Period: In the Completed column, only show tasks that were completed in the selected time period. The Backlog, In progress, and Needs attention columns are not affected by this filter.
  • Labels: Only show tasks with the selected labels. You can add new labels when creating or editing a task.

​
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.
  4. Select the Create new branch checkbox if you want to create a new branch for this task, based on the branch you selected. If you don’t check this box, will work on the task in the branch you selected.
  5. In the Environment drop-down, select the environment you want to use as your data warehouse connection.
  6. In the Label drop-down, select up to five labels to add to this task. To create a new label and add it to this task, enter the new label name and click Create.
  7. 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.
  8. 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 Mode: Act to select whether should work on this task in plan mode.
    • Click Ask permission to select a permission level. Ask permission is selected by default. If you select Full access, click Bypass permissions in the confirmation dialog to confirm that you do not want to ask for permission before performing actions.
  9. 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 panel 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 Maia AI Agents

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 panel 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 Maia AI Agents’ work in Designer

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 panel 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 panel, 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.

​
Auto-starting tasks

Enable the Auto-start toggle in the top right of the board to tell to automatically start tasks. When Auto-start is enabled and you have open in your browser, will automatically start working on any tasks that are added to the Backlog column of your board, up to the limit of 10 tasks in progress at a time.

​
Editing tasks

When a task is in the Backlog column of your board, you can edit all the configuration options available when you created the task. Once have started working on a task, you can only change its labels, permission level and mode (Act or Plan). To edit a task in the Backlog column:
  1. Click the task to open the Edit task dialog.
  2. Make the required changes to the task, as described in Creating tasks.
  3. When you’re finished, 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).
To edit a task in any other column:
  1. Click the task to open the chat panel.
  2. To change the task’s permission level or mode, click the current permission level or mode at the bottom of the chat panel and select a different permission level or mode.
  3. To change the task’s labels:
    1. Click the three vertical dots in the top right corner, then click Edit task.
    2. In the Label drop-down, select up to five labels for this task:
      • Select a label to add it to this task.
      • Deselect a selected label to remove it from this task.
      • Type the name of a new label and click Create to add a new label to this task.
    3. Click Finish.
Changes to a task’s permission level and mode are saved immediately. Changes to a task’s labels are saved when you click Finish.

​
Attaching images and PDFs

When creating or editing a task, you can attach images and PDFs to the task prompt to give additional context. can read the content of your attachments directly and use it to inform their decisions. You can attach up to five files to each task, provided they meet the following conditions:
  • Images: JPEG, PNG, GIF or WebP files
    • Maximum file size per image file: 5 MB and 8000 x 8000 px
    • Example files: Diagrams, screenshots, mockups, and whiteboard photos
  • PDFs: Standard PDF files
    • Maximum upload size across all attached PDF files: 32 MB and 100 pages
    • Example files: Specifications, requirements documents, and reports
Text files (.txt, .md, etc.) aren’t supported as attachments. These file types belong in the project itself, where Maia AI Agents can already read them.
To attach a file to a task:
  • When creating a task, in the Prompt field, click +, then click Attach to conversation, and then select the file you want to attach.
  • When chatting to about a task in the Needs attention column, click + in the chat panel, then click Attach to conversation, and then select the file you want to attach.

​
Permission levels

In , you grant a specific permission level for each task, depending on how independently you want them to work. You can select a permission level when creating a task and change the permission level granted for a task by editing the task. Select the appropriate permission level for the task you’ve asked to perform, as described below:
  • Ask permission: This is the default permission level for tasks in . When set to this level, pause and ask for permission before doing anything other than reading and editing files in your project. Use this level when you want to monitor ’ work on a task in detail.
  • Balanced: When set to this level, make read-only queries, sample data in your project, and make reversible changes without asking you for permission. They still ask for permission before pushing any changes and running pipelines. Use this level when you’re confident that are working on a safe task that you’re happy to check less often.
  • Full access: When set to this level, never ask for permission before performing an action. Only use this level for trusted, hands-off tasks such as prototyping or clearing a backlog in a sandbox environment, and make sure that you 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.