Define tasks
To run the agentic workflow in JetBrains Air, you start by defining a task. The quality of the result depends on how thoroughly you define it: a clear goal, the right level of access, and enough context to work in the correct part of the code.
You define tasks in the Chat tool. This is where you describe the goal, refine the prompt, and configure how the agent will run.
Define a task
Open a project and open the Chat tool.
Describe the goal in the task input.
In the task input, write what you want to achieve and what "done" means. Mention constraints and expected behavior. If you already have an error message or a failing case, include it.
Select an execution environment.
At the top of the Chat tool, open the environment selector (for example, Local Workspace, Git Worktree, or Docker) and choose where the agent will run.
Learn more in Permission modes.
Select an agent and model.
In the task toolbar at the bottom of the Chat tool, open the model selector (for example, Sonnet 4.5) and choose the agent and model for the task.
Learn more in Select agents and models.
Select a permission mode.
In the task toolbar at the bottom of the Chat tool, open the permission selector (for example, Auto-Edit) and choose how the agent requests approval before editing files or running commands.
If the task is broad or risky, start with planning. In plan mode, the agent proposes a plan before it edits files or runs commands.
Learn more in Permission modes and Plan mode.
Add context.
Add the files, symbols, and examples the agent should use, so it does not guess. Use one of the following:
Click Add context to attach files, folders, Git items, terminals, or external tools.
Type @ to mention symbols such as classes, functions, or methods.
Select code in the editor and attach it to the task.
Paste a minimal snippet that reproduces the issue.
Learn more in Task context.
Check project instructions.
If the project includes instruction files such as
CLAUDE.mdorAGENTS.md, keep them aligned with how you want the agent to work.Learn more in Project instructions.
Run the task.
Press Enter or click Send. When the task completes, switch to the Review tool to review changes and iterate.
Learn more in Run tasks and Review and integrate.