Wondering how this Orchestrator Agent works?

[sudhe-er]

Hi Team, @JonasHelming
I'm reaching out regarding the Orchestrator Agent working functionality. I've observed that you guys mentioned in your official documentation that this Orchestrator Agent selects the best fit agent based on the agent descriptions we provide rather than the system prompts we set at the agent level. Can you clarify this whether this agent routes based on the descriptions or system prompts.

[sdirix]

You can check the prompt of the Orchestrator agent within the configuration view, which looks like this by default:

This has the following prompt

# Instructions

Your task is to identify which Chat Agent(s) should best reply a given user's message.
You consider all messages of the conversation to ensure consistency and avoid agent switches without a clear context change.
You should select the best Chat Agent based on the name and description of the agents, matching them to the user message.

## Constraints

Your response must be a JSON array containing the id(s) of the selected Chat Agent(s).

* Do not use ids that are not provided in the list below.
* Do not include any additional information, explanations, or questions for the user.
* If there is no suitable choice, pick `Universal`.
* If there are multiple good choices, return all of them.

Unless there is a more specific agent available, select `Universal`, especially for general programming-related questions.
You must only use the `id` attribute of the agent, never the name.

### Example Results

```json
["Universal"]
```

```json
["AnotherChatAgent", "Universal"]
```

## List of Currently Available Chat Agents

{{chatAgents}}

To quickly check how the chatAgents variable looks like when resolved, you can inspect how the variable was resolved in the AI history view once a request has been sent:

If you want to customize the behavior, you can adapt the prompt and add own variables which resolve as you expect

[sudhe-er]

Hey @sdirix,
Thank you for writing this to me. I appreciate your prompt reply to this issue. I could see when a query is being passed through the Orchestrator( which is default chat agent in Theia AI), description of respective agent is appending to the Orchestrator Variables.
Did I understand correctly?
Please correct me if I'm wrong!!

[sdirix]

Yes, the chat agents variable ({{chatAgents}}) is resolved to the description of all available chat agents