Replace an agent removed from the catalog
Jaah can withdraw a connector from the shared catalog. Your organization then can't turn it on again, and every task that would run on it fails to start: it waits in the queue with the reason, and ends failed once its attempts run out. Nothing moves to another agent by itself. Do this to point each project and task that named the connector at an agent that can run.
Who can do this: anyone who can edit the project, for its Default agent, and anyone who can edit the task, for its Agent field.
- In the sidebar, select Settings, then Agents under Customize, then the Catalog tab. In the Catalog section, the connector's row is marked Removed from catalog. Hover the mark to read Removed from catalog. Tasks using it fail to start. Pick another agent for them.
- Pick the agent that takes its place. On the same tab, find one marked Enabled whose facts line takes the same personas, under Built-in, Your agents or Catalog. See Check which agents can take work.
- In the sidebar, select Directory, then the Projects tab, and select a project that used the connector as its default. In Settings › General, select Advanced.
- Default agent shows the connector's name followed by "was removed from the catalog — tasks using it will fail to start", or by (removed from catalog) when your organization no longer offers it. Open the list and pick the new agent under Built-in or Your agents & catalog, or Any to let Jaah pick. Select Save. Repeat for each project that used it.
- On the task board, hover the state of each queued task. A task still bound to the connector reads that it was removed from the catalog. Select its title to open it.
- Select ⋯, then Edit, then Advanced. In Agent, pick the new agent, or Default to use the project's default agent you just set. Select Save.
- For a task that already ended failed, change its Agent the same way, then open ⋯ and select Start. See Stop, restart or reset a task.
Tasks that picked no agent of their own follow the project's Default agent, so step 4 alone fixes them. The connector's past runs keep their record.
Related
- Set a project's default agent: what Default agent decides and the choices it offers.
- Choose the agent and account a task runs on: every choice in a task's Agent field.
- Contribute a catalog connector: how connectors reach the catalog, and how your organization turns one on.