{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":24398,"path":"intelligent-experiences/sam-microsoft-license-assignment-ai-agent.md","title":"Microsoft license assignment AI agent","bundle":null,"doc_type":null,"release":"australia","body":"\n# Microsoft license assignment AI agent\n\nThis Software Asset Management agent assigns a Microsoft license to a user for a given request item, handling integration profile selection, reservation order creation, and Entra ID group assignment.\n\n## Workflow\n\n1.  Run the Microsoft License Assignment tool with the request item number. If it returns an error, stop immediately.\n2.  If there are multiple integration profiles for Microsoft 365 available, prompt the user to select one and re-run the tool with the selection. If there is only one, the system automatically proceeds with that.\n3.  If licenses aren't currently available but entitlement details exist, offer to create a reservation order. Show the draft order for review and allow date adjustments \\(validated against the entitlement date range\\). Create the order in the ServiceNow instance, and inform the customer they must complete the order creation on the Microsoft portal.\n4.  Review existing Entra ID groups that carry the same license. If multiple groups are found, prompt the user to select one. If only one exists, use it automatically.\n5.  Assign the license to the user, including the selected group if applicable.\n6.  If there are no existing Entra ID groups, ServiceNow adds a license to the user at the user level. This applies if the customer is using user-level licensing rather than managing through Entra ID groups.\n\n<table><thead><tr><th>\n\nField\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nAllow third party to access this AI agent\n\n</td><td>\n\nWhen enabled, third-party AI agents can use this agent. This value is off \\(false\\) by default. This setting is defined in the AI Agent configs \\[sn\\_aia\\_agent\\_config\\] table on the External discoverable field.\n\n</td></tr><tr><td>\n\nAllow AI specialists to access this AI agent\n\n</td><td>\n\nWhen enabled, AI specialists can use this agent. This value is off \\(false\\) by default. When set to true, more configuration options for tools become available so that an AI specialist can map inputs and response templates to tool outputs. This setting is defined in the AI Agent configs \\[sn\\_aia\\_agent\\_config\\] table on the Specialist enabled field.\n\n</td></tr><tr><td>\n\nManage long-term memory\n\n</td><td>\n\nWhen enabled, all previous user interactions are used as context for the LLM. This value is off \\(false\\) by default. This setting is defined by the **sn\\_aia.ltm.enable\\_long\\_term\\_memory** system property. For more information, see [ServiceNow Otto AI agents reference](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/intelligent-experiences/na-aia-reference.md).\n\n</td></tr><tr><td>\n\nTools\n\n</td><td>\n\n-   **Scripts**\n\nAssignLicenseToUser\n\nMicrosoft License Assignment\n\nReviewExistingEntraIDGroups\n\n\n</td></tr><tr><td>\n\nAllowed user roles The specific user roles that can access this AI agent.\n\n</td><td>\n\nprocurement\\_user\n\n</td></tr><tr><td>\n\nData access roles The specific user identity roles that determine which data the AI agent can access and what actions it can take.\n\n</td><td>\n\nprocurement\\_user, itil, now\\_assist\\_panel\\_user\n\n</td></tr><tr><td>\n\nTriggers\n\n</td><td>\n\nOptional. None defined by default. An admin can specify triggers if desired. For more information, see [Add a trigger to an AI agent](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/intelligent-experiences/add-trigger-aia.md).\n\n</td></tr><tr><td>\n\nChannels\n\n</td><td>\n\nConfigure an assistant for Virtual Agent or ServiceNow Otto panel using [Assistant Designer](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/conversational-interfaces/configure-now-assist-va.md).\n\n</td></tr><tr><td>\n\nUsed in agentic workflows\n\n</td><td>\n\nHelp manage software requests\n\n</td></tr></tbody>\n</table>Learn more about Software Asset Management at [Software Asset Management](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/it-asset-management/c_SoftwareAssetMgmt.md).\n\n**Parent Topic:**[Software Asset Management AI agents](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/intelligent-experiences/sam-ai-agents-overview.md)\n\n"}}