Troubleshooting Supervisor-Led Teams

Identify likely causes and fixes for common Select AI supervisor-led team configuration, delegation, context, notification, and human-input problems.

Team Creation Fails

Problem: Team creation fails.

Likely Cause: supervisor_agent does not name an agent with "supervisor": true.

Fix: Recreate the agent with the supervisor attribute, and then create the team again.

The Supervisor Calls the Wrong Worker

Problem: The supervisor calls the wrong worker.

Likely Cause: Worker task descriptions are too vague or overlap.

Fix: Make task instructions more specific and mutually exclusive. The supervisor selects worker agent-task pairs based on agent names, task names, descriptions, and task instructions.

Use these guidelines when defining worker tasks:

• Define a clear domain boundary for each worker.
• Use specific task names such as ACCOUNT_MANAGEMENT_TASK or PAYMENT_LOOKUP_TASK.
• Avoid overlapping instructions between workers.
• Include expected input parameters in the task instruction.
• Specify when the worker should request human input.
• Define the format of the result returned to the supervisor.

A Worker Lacks Context

Problem: A worker lacks context.

Likely Cause: The supervisor did not pass enough detail in the delegated subtask.

Fix: Add instructions telling the supervisor to send self-contained subtasks. Define a clear supervisor role to guide delegation behavior.

Example:

{
  "profile_name": "<AI_PROFILE_NAME>",
  "supervisor": true,
  "role": "You orchestrate requests. Choose the appropriate worker agent-task pair for each subtask. Send self-contained requests with all required context. Return one concise final answer."
}

Email Does Not Send

Problem: Email does not send.

Likely Cause: The credential, network ACL, sender, or recipient configuration is missing or incorrect.

Fix: Verify the SMTP credential, ACL, sender, and recipient settings.

The Prompt Waits for User Input

Problem: The prompt waits for user input.

Likely Cause: A supervisor or worker requested human confirmation.

Fix: Continue the same conversation with the requested information.