OpenAIAssistantAgent.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(ICollection<ChatMessageContent>, AgentThread, OpenAIAssistantAgentInvokeOptions, CancellationToken) |
Invoke the agent with the provided message and arguments. |
| InvokeAsync(String, KernelArguments, Kernel, CancellationToken) |
Obsolete.
Invokes the assistant on the specified thread. |
| InvokeAsync(String, RunCreationOptions, KernelArguments, Kernel, CancellationToken) |
Obsolete.
Invokes the assistant on the specified thread. |
InvokeAsync(ICollection<ChatMessageContent>, AgentThread, AgentInvokeOptions, CancellationToken)
Invoke the agent with the provided message and arguments.
public override 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);override this.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 Overrides 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.
Applies to
InvokeAsync(ICollection<ChatMessageContent>, AgentThread, OpenAIAssistantAgentInvokeOptions, CancellationToken)
Invoke the agent with the provided message and arguments.
public 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.OpenAI.OpenAIAssistantAgentInvokeOptions? options = default, System.Threading.CancellationToken cancellationToken = default);override this.InvokeAsync : System.Collections.Generic.ICollection<Microsoft.SemanticKernel.ChatMessageContent> * Microsoft.SemanticKernel.Agents.AgentThread * Microsoft.SemanticKernel.Agents.OpenAI.OpenAIAssistantAgentInvokeOptions * System.Threading.CancellationToken -> System.Collections.Generic.IAsyncEnumerable<Microsoft.SemanticKernel.Agents.AgentResponseItem<Microsoft.SemanticKernel.ChatMessageContent>>Public Function InvokeAsync (messages As ICollection(Of ChatMessageContent), Optional thread As AgentThread = Nothing, Optional options As OpenAIAssistantAgentInvokeOptions = 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.
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, KernelArguments, Kernel, CancellationToken)
Caution
Use InvokeAsync with AgentThread instead. This method will be removed after May 1st 2025.
Invokes the assistant on the specified thread.
[System.Obsolete("Use InvokeAsync with AgentThread instead. This method will be removed after May 1st 2025.")]
public System.Collections.Generic.IAsyncEnumerable<Microsoft.SemanticKernel.ChatMessageContent> InvokeAsync(string threadId, Microsoft.SemanticKernel.KernelArguments? arguments = default, Microsoft.SemanticKernel.Kernel? kernel = default, System.Threading.CancellationToken cancellationToken = default);[<System.Obsolete("Use InvokeAsync with AgentThread instead. This method will be removed after May 1st 2025.")>]
override this.InvokeAsync : string * Microsoft.SemanticKernel.KernelArguments * Microsoft.SemanticKernel.Kernel * System.Threading.CancellationToken -> System.Collections.Generic.IAsyncEnumerable<Microsoft.SemanticKernel.ChatMessageContent>Public Function InvokeAsync (threadId As String, Optional arguments As KernelArguments = Nothing, Optional kernel As Kernel = Nothing, Optional cancellationToken As CancellationToken = Nothing) As IAsyncEnumerable(Of ChatMessageContent)Parameters
- threadId
- String
The thread identifier.
- arguments
- KernelArguments
Optional arguments to pass to the agents's invocation, including any PromptExecutionSettings.
- cancellationToken
- CancellationToken
The CancellationToken to monitor for cancellation requests. The default is None.
Returns
An asynchronous enumeration of response messages.
- Attributes
Remarks
The "arguments" parameter is not currently used by the agent, but is provided for future extensibility.
Applies to
InvokeAsync(String, RunCreationOptions, KernelArguments, Kernel, CancellationToken)
Caution
Use InvokeAsync with AgentThread instead. This method will be removed after May 1st 2025.
Invokes the assistant on the specified thread.
[System.Obsolete("Use InvokeAsync with AgentThread instead. This method will be removed after May 1st 2025.")]
public System.Collections.Generic.IAsyncEnumerable<Microsoft.SemanticKernel.ChatMessageContent> InvokeAsync(string threadId, OpenAI.Assistants.RunCreationOptions? options, Microsoft.SemanticKernel.KernelArguments? arguments = default, Microsoft.SemanticKernel.Kernel? kernel = default, System.Threading.CancellationToken cancellationToken = default);[<System.Obsolete("Use InvokeAsync with AgentThread instead. This method will be removed after May 1st 2025.")>]
override this.InvokeAsync : string * OpenAI.Assistants.RunCreationOptions * Microsoft.SemanticKernel.KernelArguments * Microsoft.SemanticKernel.Kernel * System.Threading.CancellationToken -> System.Collections.Generic.IAsyncEnumerable<Microsoft.SemanticKernel.ChatMessageContent>Public Function InvokeAsync (threadId As String, options As RunCreationOptions, Optional arguments As KernelArguments = Nothing, Optional kernel As Kernel = Nothing, Optional cancellationToken As CancellationToken = Nothing) As IAsyncEnumerable(Of ChatMessageContent)Parameters
- threadId
- String
The thread identifier.
- options
- OpenAI.Assistants.RunCreationOptions
Optional invocation options.
- arguments
- KernelArguments
Optional arguments to pass to the agents's invocation, including any PromptExecutionSettings.
- cancellationToken
- CancellationToken
The CancellationToken to monitor for cancellation requests. The default is None.
Returns
An asynchronous enumeration of response messages.
- Attributes
Remarks
The "arguments" parameter is not currently used by the agent, but is provided for future extensibility.