Interface IAgent

Stellt einen Agenten innerhalb der Laufzeit dar, der Nachrichten verarbeiten, einen Zustand beibehalten und bei Bedarf geschlossen werden kann.

public interface IAgent : ISaveState

Geerbte Member: ISaveState.DefaultSaveStateAsync()

ISaveState.SaveStateAsync()

ISaveState.LoadStateAsync(JsonElement)

Eigenschaften

Ruft die eindeutige Kennung des Agenten ab.

AgentId Id { get; }

Ruft Metadaten ab, die dem Agenten zugeordnet sind.

AgentMetadata Metadata { get; }

Verarbeitet eine eingehende Nachricht für den Agenten. Dies sollte nur von der Laufzeit und nicht von anderen Agenten aufgerufen werden.

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

message object: Die empfangene Nachricht. Der Typ sollte mit einem der erwarteten Abonnementtypen übereinstimmen.
messageContext MessageContext: Der Kontext der Nachricht, der zusätzliche Metadaten bereitstellt.

ValueTask<object>: Eine Aufgabe, die den asynchronen Vorgang darstellt und eine Antwort auf die Nachricht zurückgibt. Die Antwort kann null sein, wenn keine Antwort erforderlich ist.

OperationCanceledException: Wird ausgelöst, wenn die Nachricht abgebrochen wurde.
CantHandleException: Wird ausgelöst, wenn der Agent die Nachricht nicht verarbeiten kann.