diff --git a/README.md b/README.md index 3f28a684..15a25da8 100644 --- a/README.md +++ b/README.md @@ -25,9 +25,7 @@ The solution leverages Azure OpenAI Service, Azure Container Apps, Azure Cosmos |![image](./documentation/images/readme/macae-architecture.png)| |---| -### Application interface -|![image](./documentation/images/readme/macae-application.png)| -|---| + ### How to customize If you'd like to customize the solution accelerator, here are some common areas to start: @@ -199,6 +197,6 @@ You must also comply with all domestic and international export laws and regulat You acknowledge that the Software and Microsoft Products and Services (1) are not designed, intended or made available as a medical device(s), and (2) are not designed or intended to be a substitute for professional medical advice, diagnosis, treatment, or judgment and should not be used to replace or as a substitute for professional medical advice, diagnosis, treatment, or judgment. Customer is solely responsible for displaying and/or obtaining appropriate consents, warnings, disclaimers, and acknowledgements to end users of Customer's implementation of the Online Services. -You acknowledge the Software is not subject to SOC 1 and SOC 2 compliance audits. No Microsoft technology, nor any of its component technologies, including the Software, is intended or made available as a substitute for the professional advice, opinion, or judgement of a certified financial services professional. Do not use the Software to replace, substitute, or provide professional financial advice or judgment. +You acknowledge the Software is not subject to SOC 1 and SOC 2 compliance audits. No Microsoft technology, nor any of its component technologies, including the Software, is intended or made available as a substitute for the professional advice, opinion, or judgment of a certified financial services professional. Do not use the Software to replace, substitute, or provide professional financial advice or judgment. -BY ACCESSING OR USING THE SOFTWARE, YOU ACKNOWLEDGE THAT THE SOFTWARE IS NOT DESIGNED OR INTENDED TO SUPPORT ANY USE IN WHICH A SERVICE INTERRUPTION, DEFECT, ERROR, OR OTHER FAILURE OF THE SOFTWARE COULD RESULT IN THE DEATH OR SERIOUS BODILY INJURY OF ANY PERSON OR IN PHYSICAL OR ENVIRONMENTAL DAMAGE (COLLECTIVELY, "HIGH-RISK USE"), AND THAT YOU WILL ENSURE THAT, IN THE EVENT OF ANY INTERRUPTION, DEFECT, ERROR, OR OTHER FAILURE OF THE SOFTWARE, THE SAFETY OF PEOPLE, PROPERTY, AND THE ENVIRONMENT ARE NOT REDUCED BELOW A LEVEL THAT IS REASONABLY, APPROPRIATE, AND LEGAL, WHETHER IN GENERAL OR IN A SPECIFIC INDUSTRY. BY ACCESSING THE SOFTWARE, YOU FURTHER ACKNOWLEDGE THAT YOUR HIGH-RISK USE OF THE SOFTWARE IS AT YOUR OWN RISK. \ No newline at end of file +BY ACCESSING OR USING THE SOFTWARE, YOU ACKNOWLEDGE THAT THE SOFTWARE IS NOT DESIGNED OR INTENDED TO SUPPORT ANY USE IN WHICH A SERVICE INTERRUPTION, DEFECT, ERROR, OR OTHER FAILURE OF THE SOFTWARE COULD RESULT IN THE DEATH OR SERIOUS BODILY INJURY OF ANY PERSON OR IN PHYSICAL OR ENVIRONMENTAL DAMAGE (COLLECTIVELY, "HIGH-RISK USE"), AND THAT YOU WILL ENSURE THAT, IN THE EVENT OF ANY INTERRUPTION, DEFECT, ERROR, OR OTHER FAILURE OF THE SOFTWARE, THE SAFETY OF PEOPLE, PROPERTY, AND THE ENVIRONMENT ARE NOT REDUCED BELOW A LEVEL THAT IS REASONABLY, APPROPRIATE, AND LEGAL, WHETHER IN GENERAL OR IN A SPECIFIC INDUSTRY. BY ACCESSING THE SOFTWARE, YOU FURTHER ACKNOWLEDGE THAT YOUR HIGH-RISK USE OF THE SOFTWARE IS AT YOUR OWN RISK. diff --git a/docs/azure_app_service_auth_setup.md b/docs/azure_app_service_auth_setup.md index 62c11834..6026b69e 100644 --- a/docs/azure_app_service_auth_setup.md +++ b/docs/azure_app_service_auth_setup.md @@ -53,6 +53,6 @@ ![Web](./images/azure-app-service-auth-setup/Web.png) 8. Enter the `web app URL` (Provide the app service name in place of XXXX) and Save. Then go back to [Step 1](#step-1-add-authentication-in-azure-app-service-configuration) and follow from _Point 4_ choose `Pick an existing app registration in this directory` from the Add an Identity Provider page and provide the newly registered App Name. -E.g. https://appservicename.azurewebsites.net/.auth/login/aad/callback +E.g. <>.azurewebsites.net/.auth/login/aad/callback>> ![Add Details](./images/azure-app-service-auth-setup/WebAppURL.png) diff --git a/documentation/CustomizeSolution.md b/documentation/CustomizeSolution.md index 8e1423c3..160550a0 100644 --- a/documentation/CustomizeSolution.md +++ b/documentation/CustomizeSolution.md @@ -1,3 +1,18 @@ +# Table of Contents + +- [Table of Contents](#table-of-contents) + - [Accelerating your own Multi-Agent - Custom Automation Engine MVP](#accelerating-your-own-multi-agent---custom-automation-engine-mvp) + - [Technical Overview](#technical-overview) + - [Adding a New Agent to the Multi-Agent System](#adding-a-new-agent-to-the-multi-agent-system) + - [API Reference](#api-reference) + - [Models and Datatypes](#models-and-datatypes) + - [Application Flow](#application-flow) + - [Agents Overview](#agents-overview) + - [Persistent Storage with Cosmos DB](#persistent-storage-with-cosmos-db) + - [Utilities](#utilities) + - [Summary](#summary) + + # Accelerating your own Multi-Agent - Custom Automation Engine MVP As the name suggests, this project is designed to accelerate development of Multi-Agent solutions in your environment. The example solution presented shows how such a solution would be implemented and provides example agent definitions along with stubs for possible tools those agents could use to accomplish tasks. You will want to implement real functions in your own environment, to be used by agents customized around your own use cases. Users can choose the LLM that is optimized for responsible use. The default LLM is GPT-4o which inherits the existing responsible AI mechanisms and filters from the LLM provider. We encourage developers to review [OpenAI’s Usage policies](https://openai.com/policies/usage-policies/) and [Azure OpenAI’s Code of Conduct](https://learn.microsoft.com/en-us/legal/cognitive-services/openai/code-of-conduct) when using GPT-4o. This document is designed to provide the in-depth technical information to allow you to add these customizations. Once the agents and tools have been developed, you will likely want to implement your own real world front end solution to replace the example in this accelerator. @@ -15,21 +30,6 @@ This application is an AI-driven orchestration system that manages a group of AI This code has not been tested as an end-to-end, reliable production application- it is a foundation to help accelerate building out multi-agent systems. You are encouraged to add your own data and functions to the agents, and then you must apply your own performance and safety evaluation testing frameworks to this system before deploying it. Below, we'll dive into the details of each component, focusing on the endpoints, data types, and the flow of information through the system. -# Table of Contents - -- [Table of Contents](#table-of-contents) - - [Accelerating your own Multi-Agent - Custom Automation Engine MVP](#accelerating-your-own-multi-agent---custom-automation-engine-mvp) - - [Technical Overview](#technical-overview) - - [Adding a New Agent to the Multi-Agent System](#adding-a-new-agent-to-the-multi-agent-system) - - [API Reference](#api-reference) - - [Models and Datatypes](#models-and-datatypes) - - [Application Flow](#application-flow) - - [Agents Overview](#agents-overview) - - [Persistent Storage with Cosmos DB](#persistent-storage-with-cosmos-db) - - [Utilities](#utilities) - - [Summary](#summary) - - ## Adding a New Agent to the Multi-Agent System This guide details the steps required to add a new agent to the Multi-Agent Custom Automation Engine. The process includes registering the agent, defining its capabilities through tools, and ensuring the PlannerAgent includes the new agent when generating activity plans. diff --git a/documentation/DeploymentGuide.md b/documentation/DeploymentGuide.md index 4abae395..4d2eb2b5 100644 --- a/documentation/DeploymentGuide.md +++ b/documentation/DeploymentGuide.md @@ -257,7 +257,7 @@ The files for the dev container are located in `/.devcontainer/` folder. 4. **Deploy the Bicep template:** - - You can use the Bicep extension for VSCode (Right-click the `.bicep` file, then select "Show deployment plane") or use the Azure CLI: + - You can use the Bicep extension for VSCode (Right-click the `.bicep` file, then select "Show deployment plan") or use the Azure CLI: ```bash az deployment group create -g -f deploy/macae-dev.bicep --query 'properties.outputs' ``` diff --git a/documentation/azure_app_service_auth_setup.md b/documentation/azure_app_service_auth_setup.md index 62c11834..8829e8a9 100644 --- a/documentation/azure_app_service_auth_setup.md +++ b/documentation/azure_app_service_auth_setup.md @@ -18,7 +18,7 @@ ![Add Provider](./images/azure-app-service-auth-setup/AppAuthIdentityProviderAdd.png) -5. Accept the default values and click on `Add` button to go back to the previous page with the idenity provider added. +5. Accept the default values and click on `Add` button to go back to the previous page with the identity provider added. ![Add Provider](./images/azure-app-service-auth-setup/AppAuthIdentityProviderAdded.png) @@ -40,7 +40,7 @@ ![Add Details](./images/azure-app-service-auth-setup/AddDetails.png) -5. After application is created sucessfully, then click on `Add a Redirect URL`. +5. After application is created successfully, then click on `Add a Redirect URL`. ![Redirect URL](./images/azure-app-service-auth-setup/AddRedirectURL.png) @@ -53,6 +53,6 @@ ![Web](./images/azure-app-service-auth-setup/Web.png) 8. Enter the `web app URL` (Provide the app service name in place of XXXX) and Save. Then go back to [Step 1](#step-1-add-authentication-in-azure-app-service-configuration) and follow from _Point 4_ choose `Pick an existing app registration in this directory` from the Add an Identity Provider page and provide the newly registered App Name. -E.g. https://appservicename.azurewebsites.net/.auth/login/aad/callback +E.g. <>.azurewebsites.net/.auth/login/aad/callback>> ![Add Details](./images/azure-app-service-auth-setup/WebAppURL.png) diff --git a/documentation/images/DeleteRG.png b/documentation/images/DeleteRG.png new file mode 100644 index 00000000..75a0c5e4 Binary files /dev/null and b/documentation/images/DeleteRG.png differ diff --git a/documentation/images/deleteservices.png b/documentation/images/deleteservices.png new file mode 100644 index 00000000..1885633b Binary files /dev/null and b/documentation/images/deleteservices.png differ diff --git a/documentation/images/resource-groups.png b/documentation/images/resource-groups.png new file mode 100644 index 00000000..9694f669 Binary files /dev/null and b/documentation/images/resource-groups.png differ diff --git a/documentation/images/resourcegroup.png b/documentation/images/resourcegroup.png new file mode 100644 index 00000000..67b058bc Binary files /dev/null and b/documentation/images/resourcegroup.png differ