Skip to content

v1.1.1

Choose a tag to compare

View all tags
@benbrown benbrown released this 04 Dec 18:13
· 3 commits to release/v1.1 since this release
v1.1.1
8f4918f
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

New

Support for Agentic Identity
Added initial support for Microsoft Agent ID. See: What is Microsoft Entra Agent ID? - Microsoft Entra Agent ID | Microsoft Learn
Further setup documentation will be provided on use of this feature in the future as it moves forward.

Multiple Connections
It is now possible to configure your agent application with multiple parallel application identities. We call these "Connections." When used in conjunction with Agentic Identity, this allows for an agent application to act as any installed instance of the agent across multiple tenants, as well as bind specific routes to different agent configuration within the same app.

# in .env
# define a connection named `serviceConnection`
# the name used in the env variable names must match the name
# specified in the connectionsMap below
connections__serviceConnection__settings__clientId= # App ID of the App Registration used to log in.
connections__serviceConnection__settings__clientSecret= # Client secret of the App Registration used to log in
connections__serviceConnection__settings__tenantId= # Tenant ID of the App Registration used to log in

connectionsMap__0__connection=serviceConnection
connectionsMap__0__serviceUrl=*

Sample here

If nothing is changed in your configuration, the SDK will automatically use the existing settings to create a default Connection for you. No changes are required.

In copilot studio client: sendActivityStreaming, startConversationStreaming
In addition to the sendActivityAsync and startConversationAsync methods, this version introduces new versions that support streaming messages returned as they arrive using AsyncGenerators. These methods will return a stream of Activities as they arrive over the wire and use a new syntax for dealing with AsyncGenerators.

for await (const replyActivity of copilotClient.sendActivityStreaming(activity)) {
  ... process each activity as it arrives, including typing indicators, events, etc
}

Sample here

Breaking Changes

There were some unavoidable changes necessary in the SDK which will require updates to your code if you use any of the following methods:

CloudAdapter.ContinueConversation or AgentApplication.sendProactiveActivity
Both of these methods now require botAppIdOrIdentity to be passed as the first argument. This must either be the agents's app ID, or a JwtPayload object from the incoming request, usually TurnContext.identity

CloudAdapter getAttachment/getAttachmentInfo/uploadAttachment
These methods now require a TurnContext to be passed as the first argument.

CloudAdapter.ConnectorClient and CloudAdapter.UserTokenClient have been removed.
Rather than being members of the CloudAdapter class, these are now available as turncontext.turnstate.get(adapter.ConnectorClientKey) and turncontext.turnstate.get(adapter.UserTokenClientKey)

AgentApplication.authorization.beginOrContinueFlow has been removed

AgentApplication.authorization.authHandlers has been removed

oAuthFlow class removed

What's Changed

New Contributors

Full Changelog: v1.0.13...v1.1.1

Contributors

Stevenic, benbrown, and 7 other contributors
Assets 2
Loading