Set a project's default agent
A task runs on the agent picked in its own Agent field. When it picks none, Jaah runs it on the project's Default agent, and when that is unset too, on the first free engine. Set a default agent when most of a project's work should go to one agent, such as the custom agent your team built for it, so nobody has to pick it on each task.
Who can do this: anyone who can edit the project. Without that permission the project's settings are read-only. The agents offered are those your organization's plan lets it run.
-
In the sidebar, select Directory, then the Projects tab.
-
Select the project's name to open its settings. Settings opens on General.
-
Find Default agent, beside Default persona. Hover its label for what it does: Runs tasks that pick no agent.

-
Open the list and pick the agent:
- Any leaves it unset: tasks run on the first free engine.
- Under Built-in, one of Jaah's own runners.
- Under Your agents & catalog, an agent your organization registered or installed, or a catalog connector it turned on. An agent that can't run here is greyed out, with the reason after a dash.
Under the field, a caption names the picked agent's kind, catalog for a connector, and its version.
-
Read under the field once more. If it says the agent is disabled or removed from the catalog, and that tasks using it fail to start, pick another agent or turn that one back on first.
-
Select Save.
-
To check it, start a new task in the project and select Advanced. Leave Agent on Default: the task runs on the agent you just set. Picking any other agent there overrides the default for that one task.
To stop using the default, set Default agent back to Any and save. Disabling or deleting the agent itself is on Change or remove a custom agent: Jaah won't delete an agent that a project still uses as its default.
Related
- How agents work — what an agent is, and how a task's pick and a project's default decide which one runs.
- Choose what a task runs on — override the default on one task: agent, model account and model.
- Projects — every field of the project's Settings › General.