diff --git a/docs/integrations/builtin/cluster-nodes/root-nodes/n8n-nodes-langchain.microsoftagent365trigger/index.md b/docs/integrations/builtin/cluster-nodes/root-nodes/n8n-nodes-langchain.microsoftagent365trigger/index.md new file mode 100644 index 000000000..cf681b07f --- /dev/null +++ b/docs/integrations/builtin/cluster-nodes/root-nodes/n8n-nodes-langchain.microsoftagent365trigger/index.md @@ -0,0 +1,62 @@ +--- +title: Microsoft Agent 365 Trigger node documentation +description: Learn how to use the Microsoft Agent 365 Trigger node in n8n. Follow technical documentation to integrate Microsoft Agent 365 Trigger node into your workflows. +contentType: [integration, reference] +priority: medium +--- + +# Microsoft Agent 365 Trigger node + +/// warning | Early preview +This is an early preview for building agents with Microsoft Agent 365 and n8n. You need to be part of the [Frontier preview program](https://adoption.microsoft.com/copilot/frontier-program/) to get early access to Microsoft Agent 365. +/// + +Use the Microsoft Agent 365 Trigger node to receive messages from Microsoft Agent 365 and respond with AI-powered agent capabilities. This node allows n8n to act as the backend for your Agent 365 agents. + +/// note | Credentials +You can find authentication information for this node [here](/integrations/builtin/credentials/microsoftagent365.md). +/// + +## Node connectors + +The Microsoft Agent 365 Trigger node can connect to the following sub-nodes: + +- **Model**: Connect a language model (Chat model sub-node) to process incoming messages +- **Memory**: Connect a memory sub-node to maintain conversation context +- **Tool**: Connect tool sub-nodes to give your agent additional capabilities + +## Node options + +### Enable Microsoft MCP Tools + +Toggle this option to give your agent access to Microsoft 365 tools through the Model Context Protocol (MCP). Default: Off. + +When enabled, select one of: + +- **All**: Enable all available Microsoft MCP tools +- **Selected**: Choose specific tools from the list: + - Calendar + - Mail + - SharePoint + - Teams + - Word + - and more + +## Getting started + +We recommend following these resources to set up your Agent 365 integration: + +1. [n8n Sample Agent Documentation](https://github.com/microsoft/Agent365-Samples/tree/main/nodejs/n8n/sample-agent): Example n8n agent implementation with Microsoft Agent 365 +2. [Agent 365 CLI Documentation](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/agent-365-cli): Cross-platform command-line tool for deploying and managing Agent 365 applications on Azure + +## Known limitations + +### No conversation context in metadata + +Currently, incoming messages don't include metadata to link memory to a specific user or conversation context. This functionality is coming soon. + +## Related resources + +Refer to [Microsoft Agent 365 developer documentation](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/) for more information about the service. + +--8<-- "_snippets/integrations/builtin/cluster-nodes/langchain-overview-link.md" diff --git a/docs/integrations/builtin/credentials/microsoftagent365.md b/docs/integrations/builtin/credentials/microsoftagent365.md new file mode 100644 index 000000000..af0f5f3a4 --- /dev/null +++ b/docs/integrations/builtin/credentials/microsoftagent365.md @@ -0,0 +1,46 @@ +--- +title: Microsoft Agent 365 credentials +description: Documentation for Microsoft Agent 365 credentials. Use these credentials to authenticate Microsoft Agent 365 in n8n, a workflow automation platform. +contentType: [integration, reference] +priority: medium +--- + +# Microsoft Agent 365 credentials + +You can use these credentials to authenticate the following nodes: + +- [Microsoft Agent 365 Trigger](/integrations/builtin/cluster-nodes/root-nodes/n8n-nodes-langchain.microsoftagent365trigger/index.md) + +/// warning | Early preview +Microsoft Agent 365 is an early preview feature. You need to be part of the [Frontier preview program](https://adoption.microsoft.com/copilot/frontier-program/) to get early access. +/// + +## Prerequisites + +- Enrollment in the [Microsoft Frontier preview program](https://adoption.microsoft.com/copilot/frontier-program/) +- A [Microsoft Azure](https://azure.microsoft.com/) account +- An Agent 365 blueprint created using the Agent 365 CLI + +## Supported authentication methods + +- OAuth2 (App Registration) + +## Related resources + +Refer to [Microsoft Agent 365 developer documentation](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/) for more information about the service. + +## Using OAuth2 + +To configure this credential, you'll need: + +- **Tenant ID**: Your Microsoft Entra tenant ID +- **Client ID**: The Application (client) ID from your Azure app registration +- **Client Secret**: The secret generated for your app registration + +To set up the credential: + +1. Find your Tenant ID in [Microsoft Entra ID](https://entra.microsoft.com/#home) and copy it into n8n as the **Tenant ID**. +2. Open the [Microsoft Application Registration Portal](https://aka.ms/appregistrations) and follow the [custom client app registration guide](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/custom-client-app-registration) for Microsoft Agent 365. Once your custom client app is created, copy the Application (client) ID into n8n as the **Client ID**. +3. Follow the [credentials guide](https://learn.microsoft.com/en-us/entra/identity-platform/how-to-add-credentials?tabs=client-secret) to generate a client secret and copy the **Secret** in the **Value** column and paste it into n8n as the **Client Secret**. + +We recommend using [Agent 365 CLI](https://learn.microsoft.com/en-us/microsoft-agent-365/developer/agent-365-cli) to create your agent blueprint and manifest. You can find more details in the [n8n Sample Agent repository](https://github.com/microsoft/Agent365-Samples/tree/main/nodejs/n8n/sample-agent) for Microsoft Agent 365. diff --git a/nav.yml b/nav.yml index 788f5aff1..ccb2e9762 100644 --- a/nav.yml +++ b/nav.yml @@ -723,6 +723,7 @@ nav: - Text Classifier: integrations/builtin/cluster-nodes/root-nodes/n8n-nodes-langchain.text-classifier.md - Sentiment Analysis: integrations/builtin/cluster-nodes/root-nodes/n8n-nodes-langchain.sentimentanalysis.md - LangChain Code: integrations/builtin/cluster-nodes/root-nodes/n8n-nodes-langchain.code.md + - Microsoft Agent 365 Trigger: integrations/builtin/cluster-nodes/root-nodes/n8n-nodes-langchain.microsoftagent365trigger/index.md - Azure AI Search Vector Store: integrations/builtin/cluster-nodes/root-nodes/n8n-nodes-langchain.vectorstoreazureaisearch.md - Simple Vector Store: integrations/builtin/cluster-nodes/root-nodes/n8n-nodes-langchain.vectorstoreinmemory.md - Milvus Vector Store: integrations/builtin/cluster-nodes/root-nodes/n8n-nodes-langchain.vectorstoremilvus.md @@ -972,6 +973,7 @@ nav: - integrations/builtin/credentials/microsoftazuremonitor.md - integrations/builtin/credentials/microsoftentra.md - integrations/builtin/credentials/microsoftsql.md + - integrations/builtin/credentials/microsoftagent365.md - integrations/builtin/credentials/milvus.md - integrations/builtin/credentials/mindee.md - integrations/builtin/credentials/miro.md