SelectorGroupChat needs for clarification for metadata

[olileger]

What is the doc issue?

According to the SelectorGroupChat documentation:

1. https://microsoft.github.io/autogen/stable/user-guide/agentchat-user-guide/selector-group-chat.html
2. https://microsoft.github.io/autogen/stable/reference/python/autogen_agentchat.teams.html#autogen_agentchat.teams.SelectorGroupChat

It looks like the prompt for the Selector itself can rely on metadata such as: {roles}, {participants} and {history}.

I have 2 suggestions about that:

1. I suggest to add clarification about what are returned by those variables, especially to make distinction between {roles} and {participants}.
The best would be to have the value returned by those variables in the documentation sample at https://microsoft.github.io/autogen/stable/user-guide/agentchat-user-guide/selector-group-chat.html so that we directly know how it works.

2. While we are aware of {roles} {participants} and {history} it's not clear whether we have only those 3 variables or if more others are available (such as for instance {current_turn}, {max_turns} and so on).

Thanks for your help

Link to the doc page, if applicable

https://microsoft.github.io/autogen/stable/user-guide/agentchat-user-guide/selector-group-chat.html

[olileger]

So according to https://github.com/microsoft/autogen/blob/main/python/packages/autogen-agentchat/src/autogen_agentchat/teams/_group_chat/_selector_group_chat.py

• {participants} is a list of agent's Name
• {roles} is a list of "topic: description", one entry per agent
• {history} is a sequential list of all the messages generated by agents in the team

it seems like {speaker} would also be available but not targeted to be used within the selector prompt (but would like confirmation)

[ekzhu]

Thanks for the suggestion. I think it is good for the documentation to make it clear what goes into the variables. Fix this in #6399