Skip to content
This repository has been archived by the owner on Jul 22, 2024. It is now read-only.

Public preview has ended and program is not currently active.

Notifications You must be signed in to change notification settings

SharePoint/Bot-Powered-ACE-Preview

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 

Repository files navigation

Bot Powered Adaptive Card Extensions for Viva Connections (Preview) - Paused

Thank you for your interest for the Bot Powered Adaptive Card Extensions for Viva Connections. We executed this preview from spring 2023 to autumn 2023 and have currently paused the preview as we are addressing all feedback and are getting ready for the first version to be generally available.

Thank you all for your invaluable input. Current plan is to get the feature relased in the first half of the 2024. We will be sharing more updates through the Microsoft 365 Developer blog. Stay tuned!

Reference solutions which were part of the public preview material has been deleted from this repository. We have intentionally left the tutorials and other assets here for anyone who might be interested on checking the model before it's publicly again available.


Why Bot-Driven ACEs?

Problem Statement
Currently, the model for building an ACE works for developers that can both invest resources to build a solution from scratch and possess JavaScript and TypeScript knowledge. As a result, developers who have already invested in bot solutions for Microsoft 365 and are more specialized in server-side programming languages, such as Java or C#, are automatically excluded from being able to reap the benefits of an ACE.

In addition, currently, within SharePoint, there's no way to provide a seamless silent sign-on (SSO) experience where the solution uses external or third party identity providers (IDPs). This limits the third party resources a developer can access or utilize through an ACE.

The Solution: Bot-Driven ACEs
Bot-Driven ACEs reduce the requirements needed to develop cards from scratch and allow bot developers to integrate their existing investments on a bot to create an ACE.

Furthermore, Bot-Driven ACEs prevent bots and other third party code from accessing data from other bots by hosting the bot responses to SharePoint Viva Connections in an iFrame.

Before Getting Started

For more information on the bot builder framework, see the bot builder framework repository.

Please check the known issues page to be informed on any issues blocking any desired use cases.

To get started, ensure the account you use to configure the bot is in the same Azure subscription as your tenant.

Note: we're using a fork of the BotBuilder framework due to anticipating changes in the Bot-Driven ACE schema based on feedback during the preview period. Before this feature hits GA, we'll finalize the schema and work with the BotBuilder framework team to merge our changes.

Repository Folder Structure

  • BotBuilder DotNet
    • This folder contains a fork of the BotBuilder framework for the CSharp language
    • Ignore the ReadMe in this directory and use the instructions in the hands-on-labs as the single source of truth instructions to get started.
  • BotBuilderNodeJs
    • This folder contains a fork of the BotBuilder framework for the JavaScript language
    • Ignore the ReadMe in this directory and use the instructions in the hands-on-labs as the single source of truth instructions to get started.
  • labs
    • This folder contains the available hands-on-labs that will serve as tutorials to key features of Bot-Driven ACEs. The labs are available in both CSharp and JavaScript.
    • Follow the instruction of the labs available here to get started. We'll use also this wiki for sharing any updates, which will also be shared with you in direct messages to reduce the impact of potential breaking changes for your testing.

Feedback

When you find something that looks like a bug or you'd like to provide feedback for the engineering - use the https://github.com/SharePoint/BotPoweredACEPreview/issues list for getting your feedback and findings shared with the engineering.

Due to the time zone differences, there might be small delays on getting you a response, but we'll do the best on our side.

Your input is invaluable for Microsoft around these features.

Thank you 👏🚀

Sharing is caring 🧡

Looking to engage with others who build experiences for hte Microsoft 365 platfrom - join our Microsoft 365 platform community calls and take advantage of our community and open-source efforts, like >1500 open-source samples and different community projects.

About

Public preview has ended and program is not currently active.

Resources

Stars

Watchers

Forks