A programming framework for agentic AI
// Copyright (c) Microsoft Corporation. All rights reserved.
// RoundRobinGroupChat.cs
using System.Text.Json;
using Microsoft.AutoGen.AgentChat.Abstractions;
using Microsoft.AutoGen.AgentChat.State;
using Microsoft.AutoGen.Contracts;
namespace Microsoft.AutoGen.AgentChat.GroupChat;
/// <summary>
/// A group chat manager that selects the next speaker in a round-robin fashion.
/// </summary>
public class RoundRobinGroupChatManager : GroupChatManagerBase, ISaveState
{
private readonly List<string> participantTopicTypes;
private int nextSpeakerIndex;
public RoundRobinGroupChatManager(GroupChatOptions options) : base(options)
{
this.participantTopicTypes = [.. from candidateTopic in options.Participants.Values
select candidateTopic.TopicType];
this.nextSpeakerIndex = 0;
}
public override ValueTask<string> SelectSpeakerAsync(List<AgentMessage> thread)
{
string result = this.participantTopicTypes[this.nextSpeakerIndex].ToString();
this.nextSpeakerIndex = (this.nextSpeakerIndex + 1) % this.participantTopicTypes.Count;
return ValueTask.FromResult(result);
}
ValueTask<JsonElement> ISaveState.SaveStateAsync()
{
RoundRobinManagerState state = new RoundRobinManagerState
{
NextSpeakerIndex = this.nextSpeakerIndex,
CurrentTurn = this.CurrentTurn,
MessageThread = this.MessageThread
};
return ValueTask.FromResult(SerializedState.Create(state).AsJson());
}
ValueTask ISaveState.LoadStateAsync(JsonElement state)
{
RoundRobinManagerState parsedState = new SerializedState(state).As<RoundRobinManagerState>();
this.MessageThread = parsedState.MessageThread;
this.CurrentTurn = parsedState.CurrentTurn;
this.nextSpeakerIndex = parsedState.NextSpeakerIndex;
return ValueTask.CompletedTask;
}
}
/// <summary>
/// A team that runs a group chat with a participants taking turns in a round-robin fashion to publish
/// a message to all.
///
/// If a single participant is in the team, the participant will be the only speaker.
/// </summary>
public class RoundRobinGroupChat : GroupChatBase<RoundRobinGroupChatManager>
{
/// <summary>
/// Initializes a new round-robin group chat.
/// </summary>
/// <param name="participants">The participants in the group chat.</param>
/// <param name="terminationCondition">
/// The termination condition for the group chat. Defaults to <c>null</c>. Without a termination
/// condition, the group chat will run indefinitely.
/// </param>
/// <param name="maxTurns">
/// The maximum number of turns for the group chat. Defaults to <c>null</c>, meaning no limit.
/// Note that the <see cref="ITerminationCondition"/> gets first priority for checking the termination
/// if both are provided.
/// </param>
public RoundRobinGroupChat(List<IChatAgent> participants, ITerminationCondition? terminationCondition = null, int? maxTurns = null) : base(participants, terminationCondition, maxTurns)
{
}
}