Agent.InvokeAsync Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Overloads
| InvokeAsync(ICollection<ChatMessageContent>, AgentThread, AgentInvokeOptions, CancellationToken) |
Invoke the agent with the provided message and arguments. |
| InvokeAsync(String, AgentThread, AgentInvokeOptions, CancellationToken) |
Invoke the agent with the provided message and arguments. |
| InvokeAsync(AgentThread, AgentInvokeOptions, CancellationToken) |
Invoke the agent with no message assuming that all required instructions are already provided to the agent or on the thread. |
| InvokeAsync(ChatMessageContent, AgentThread, AgentInvokeOptions, CancellationToken) |
Invoke the agent with the provided message and arguments. |
InvokeAsync(ICollection<ChatMessageContent>, AgentThread, AgentInvokeOptions, CancellationToken)
Invoke the agent with the provided message and arguments.
public abstract System.Collections.Generic.IAsyncEnumerable<Microsoft.SemanticKernel.Agents.AgentResponseItem<Microsoft.SemanticKernel.ChatMessageContent>> InvokeAsync(System.Collections.Generic.ICollection<Microsoft.SemanticKernel.ChatMessageContent> messages, Microsoft.SemanticKernel.Agents.AgentThread? thread = default, Microsoft.SemanticKernel.Agents.AgentInvokeOptions? options = default, System.Threading.CancellationToken cancellationToken = default);abstract member InvokeAsync : System.Collections.Generic.ICollection<Microsoft.SemanticKernel.ChatMessageContent> * Microsoft.SemanticKernel.Agents.AgentThread * Microsoft.SemanticKernel.Agents.AgentInvokeOptions * System.Threading.CancellationToken -> System.Collections.Generic.IAsyncEnumerable<Microsoft.SemanticKernel.Agents.AgentResponseItem<Microsoft.SemanticKernel.ChatMessageContent>>Public MustOverride Function InvokeAsync (messages As ICollection(Of ChatMessageContent), Optional thread As AgentThread = Nothing, Optional options As AgentInvokeOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As IAsyncEnumerable(Of AgentResponseItem(Of ChatMessageContent))Parameters
- messages
- ICollection<ChatMessageContent>
The messages to pass to the agent.
- thread
- AgentThread
The conversation thread to continue with this invocation. If not provided, creates a new thread.
- options
- AgentInvokeOptions
Optional parameters for agent invocation.
- cancellationToken
- CancellationToken
The CancellationToken to monitor for cancellation requests. The default is None.
Returns
An async list of response items that each contain a ChatMessageContent and an AgentThread.
Remarks
To continue this thread in the future, use an AgentThread returned in one of the response items.
Applies to
InvokeAsync(String, AgentThread, AgentInvokeOptions, CancellationToken)
Invoke the agent with the provided message and arguments.
public virtual System.Collections.Generic.IAsyncEnumerable<Microsoft.SemanticKernel.Agents.AgentResponseItem<Microsoft.SemanticKernel.ChatMessageContent>> InvokeAsync(string message, Microsoft.SemanticKernel.Agents.AgentThread? thread = default, Microsoft.SemanticKernel.Agents.AgentInvokeOptions? options = default, System.Threading.CancellationToken cancellationToken = default);abstract member InvokeAsync : string * Microsoft.SemanticKernel.Agents.AgentThread * Microsoft.SemanticKernel.Agents.AgentInvokeOptions * System.Threading.CancellationToken -> System.Collections.Generic.IAsyncEnumerable<Microsoft.SemanticKernel.Agents.AgentResponseItem<Microsoft.SemanticKernel.ChatMessageContent>>
override this.InvokeAsync : string * Microsoft.SemanticKernel.Agents.AgentThread * Microsoft.SemanticKernel.Agents.AgentInvokeOptions * System.Threading.CancellationToken -> System.Collections.Generic.IAsyncEnumerable<Microsoft.SemanticKernel.Agents.AgentResponseItem<Microsoft.SemanticKernel.ChatMessageContent>>Public Overridable Function InvokeAsync (message As String, Optional thread As AgentThread = Nothing, Optional options As AgentInvokeOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As IAsyncEnumerable(Of AgentResponseItem(Of ChatMessageContent))Parameters
- message
- String
The message to pass to the agent.
- thread
- AgentThread
The conversation thread to continue with this invocation. If not provided, creates a new thread.
- options
- AgentInvokeOptions
Optional parameters for agent invocation.
- cancellationToken
- CancellationToken
The CancellationToken to monitor for cancellation requests. The default is None.
Returns
An async list of response items that each contain a ChatMessageContent and an AgentThread.
Remarks
The provided message string will be treated as a user message.
To continue this thread in the future, use an AgentThread returned in one of the response items.
Applies to
InvokeAsync(AgentThread, AgentInvokeOptions, CancellationToken)
Invoke the agent with no message assuming that all required instructions are already provided to the agent or on the thread.
public virtual System.Collections.Generic.IAsyncEnumerable<Microsoft.SemanticKernel.Agents.AgentResponseItem<Microsoft.SemanticKernel.ChatMessageContent>> InvokeAsync(Microsoft.SemanticKernel.Agents.AgentThread? thread = default, Microsoft.SemanticKernel.Agents.AgentInvokeOptions? options = default, System.Threading.CancellationToken cancellationToken = default);abstract member InvokeAsync : Microsoft.SemanticKernel.Agents.AgentThread * Microsoft.SemanticKernel.Agents.AgentInvokeOptions * System.Threading.CancellationToken -> System.Collections.Generic.IAsyncEnumerable<Microsoft.SemanticKernel.Agents.AgentResponseItem<Microsoft.SemanticKernel.ChatMessageContent>>
override this.InvokeAsync : Microsoft.SemanticKernel.Agents.AgentThread * Microsoft.SemanticKernel.Agents.AgentInvokeOptions * System.Threading.CancellationToken -> System.Collections.Generic.IAsyncEnumerable<Microsoft.SemanticKernel.Agents.AgentResponseItem<Microsoft.SemanticKernel.ChatMessageContent>>Public Overridable Function InvokeAsync (Optional thread As AgentThread = Nothing, Optional options As AgentInvokeOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As IAsyncEnumerable(Of AgentResponseItem(Of ChatMessageContent))Parameters
- thread
- AgentThread
The conversation thread to continue with this invocation. If not provided, creates a new thread.
- options
- AgentInvokeOptions
Optional parameters for agent invocation.
- cancellationToken
- CancellationToken
The CancellationToken to monitor for cancellation requests. The default is None.
Returns
An async list of response items that each contain a ChatMessageContent and an AgentThread.
Remarks
To continue this thread in the future, use an AgentThread returned in one of the response items.
Applies to
InvokeAsync(ChatMessageContent, AgentThread, AgentInvokeOptions, CancellationToken)
Invoke the agent with the provided message and arguments.
public virtual System.Collections.Generic.IAsyncEnumerable<Microsoft.SemanticKernel.Agents.AgentResponseItem<Microsoft.SemanticKernel.ChatMessageContent>> InvokeAsync(Microsoft.SemanticKernel.ChatMessageContent message, Microsoft.SemanticKernel.Agents.AgentThread? thread = default, Microsoft.SemanticKernel.Agents.AgentInvokeOptions? options = default, System.Threading.CancellationToken cancellationToken = default);abstract member InvokeAsync : Microsoft.SemanticKernel.ChatMessageContent * Microsoft.SemanticKernel.Agents.AgentThread * Microsoft.SemanticKernel.Agents.AgentInvokeOptions * System.Threading.CancellationToken -> System.Collections.Generic.IAsyncEnumerable<Microsoft.SemanticKernel.Agents.AgentResponseItem<Microsoft.SemanticKernel.ChatMessageContent>>
override this.InvokeAsync : Microsoft.SemanticKernel.ChatMessageContent * Microsoft.SemanticKernel.Agents.AgentThread * Microsoft.SemanticKernel.Agents.AgentInvokeOptions * System.Threading.CancellationToken -> System.Collections.Generic.IAsyncEnumerable<Microsoft.SemanticKernel.Agents.AgentResponseItem<Microsoft.SemanticKernel.ChatMessageContent>>Public Overridable Function InvokeAsync (message As ChatMessageContent, Optional thread As AgentThread = Nothing, Optional options As AgentInvokeOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As IAsyncEnumerable(Of AgentResponseItem(Of ChatMessageContent))Parameters
- message
- ChatMessageContent
The message to pass to the agent.
- thread
- AgentThread
The conversation thread to continue with this invocation. If not provided, creates a new thread.
- options
- AgentInvokeOptions
Optional parameters for agent invocation.
- cancellationToken
- CancellationToken
The CancellationToken to monitor for cancellation requests. The default is None.
Returns
An async list of response items that each contain a ChatMessageContent and an AgentThread.
Remarks
To continue this thread in the future, use an AgentThread returned in one of the response items.