Share via

Agent Class

A stateful implementation of ChatPrompt with persistent memory.

Agent extends ChatPrompt by providing default memory management, making it easier to maintain conversation context across multiple interactions without manually passing memory each time.

Initialize Agent with model and persistent memory.

Constructor

Agent(model: AIModel, *, memory: Memory | None = None, functions: list[microsoft.teams.ai.function.Function[Any]] | None = None, plugins: list[microsoft.teams.ai.plugin.AIPluginProtocol] | None = None)

Parameters

Name Description
model
Required

AI model implementation for text generation
memory
Required

Memory for conversation persistence. Defaults to InMemory ListMemory
functions
Required

Optional list of functions the model can call
plugins
Required

Optional list of plugins for extending functionality

Keyword-Only Parameters

Name Description
memory
Default value: None
functions
Default value: None
plugins
Default value: None

Methods

send

Send a message using the agent's persistent memory.

Note

If no memory is provided, uses the agent's default memory,

making conversation state persistent across calls.

send

Send a message using the agent's persistent memory.

Note

If no memory is provided, uses the agent's default memory,

making conversation state persistent across calls.

async send(input: str | UserMessage | ModelMessage | SystemMessage | FunctionMessage, *, instructions: str | SystemMessage | None = None, memory: Memory | None = None, on_chunk: Callable[[str], Awaitable[None]] | Callable[[str], None] | None = None) -> ChatSendResult

Parameters

Name Description
input
Required

Message to send (string will be converted to UserMessage)
instructions
Required

Optional system message to guide model behavior
memory
Required

Optional memory override. Defaults to agent's persistent memory
on_chunk
Required

Optional callback for streaming response chunks

Keyword-Only Parameters

Name Description
instructions
Default value: None
memory
Default value: None
on_chunk
Default value: None

Returns

Type Description

ChatSendResult containing the final model response