接口 IAgent

命名空间

Microsoft.AutoGen.Contracts

程序集

Microsoft.AutoGen.Contracts.dll

表示运行时环境中的一个代理，它可以处理消息、维护状态，并在不再需要时关闭。

public interface IAgent : ISaveState

继承的成员

ISaveState.DefaultSaveStateAsync()

ISaveState.SaveStateAsync()

ISaveState.LoadStateAsync(JsonElement)

属性

Id

获取代理的唯一标识符。

AgentId Id { get; }

属性值

AgentId

Metadata

获取与代理关联的元数据。

AgentMetadata Metadata { get; }

属性值

AgentMetadata

方法

OnMessageAsync(object, MessageContext)

处理代理的传入消息。 这应该只由运行时调用，而不是由其他代理调用。

ValueTask<object?> OnMessageAsync(object message, MessageContext messageContext)

参数

message object

接收到的消息。 类型应与预期订阅类型之一匹配。

messageContext MessageContext

消息的上下文，提供附加元数据。

返回值

ValueTask<object>

表示异步操作的任务，返回消息的响应。 如果不需要回复，则响应可以为 null。

异常

OperationCanceledException

如果消息被取消，则抛出此异常。

CantHandleException

如果代理无法处理消息，则抛出此异常。