{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":23020,"path":"intelligent-experiences/components-installed-with-agentic-desktop.md","title":"Components installed with AI Desktop Actions","bundle":null,"doc_type":null,"release":"australia","body":"\n# Components installed with AI Desktop Actions\n\nSeveral types of components are installed with activation of the sn\\_desktop\\_agents plugin, including user roles and tables.\n\n## Roles used\n\n<table id=\"table_y3j_1x3_hhc\"><thead><tr><th>\n\nRole title \\[name\\]\n\n</th><th>\n\nDescription\n\n</th><th>\n\nContains roles\n\n</th></tr></thead><tbody><tr><td>\n\nAI Agent Admin\\[sn\\_aia.admin\\]\n\n</td><td>\n\nEnables you to create, manage, and test desktop actions in AI Desktop Actions and deploy them as tools in AI Agent Studio.\n\n</td><td>\n\n-   agent\\_role\\_config\\_admin\n-   sn\\_skill\\_builder.admin\n-   connection\\_admin\n-   flow\\_designer\n-   sn\\_aia.viewer\n-   sn\\_mcp\\_client.admin\n-   sn\\_ace.ace\\_user\n\n</td></tr><tr><td>\n\nServiceNow Otto panel user\\[now\\_assist\\_panel\\_user\\]\n\n</td><td>\n\nEnables you to trigger desktop actions from ServiceNow Otto panel and execute desktop actions in the desktop environment using Execution workspace.\n\n</td><td>\n\nsn\\_nowassist\\_admin.user\n\n</td></tr><tr><td>\n\nDesktop action user\\[sn\\_desktop\\_core.desktop\\_action\\_user\\]\n\n</td><td>\n\nEnables you to create desktop actions using the **Record with AI** feature in AI Desktop Actions.\n\n</td><td>\n\n-   sn\\_aia.admin\n-   sn\\_nowassist\\_admin.user\n\n</td></tr><tr><td>\n\nWeb Agent Runtime\\[sn\\_naa.web\\_agent\\_runtime\\]\n\n</td><td>\n\nGrants the Web Automation Agent's service account read and write access to data required during execution.Assign this role only to the service account the agent runs as \\(not to end users\\). Without this role, the agent can't read or write any data at runtime.\n\n</td><td>\n\nNone\n\n</td></tr></tbody>\n</table>## Tables installed\n\n<table id=\"table_cjj_1x3_hhc\"><thead><tr><th>\n\nTable\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nDesktop action\\[sn\\_desktop\\_core\\_action\\]\n\n</td><td>\n\nStores details, such as input and output parameters and number of screens for on-screen desktop actions.\n\n</td></tr><tr><td>\n\nDesktop action application\\[sn\\_desktop\\_core\\_action\\_application\\]\n\n</td><td>\n\nStores the desktop application associated with the desktop action.\n\n</td></tr><tr><td>\n\nDesktop action execution \\[sn\\_desktop\\_core\\_action\\_execution\\]\n\n</td><td>\n\nStores the execution details of a desktop action, such as request, response, tool execution, and execution plan.\n\n</td></tr><tr><td>\n\nDesktop action parameter\\[sn\\_desktop\\_core\\_action\\_parameter\\]\n\n</td><td>\n\nStores the desktop action parameter records as parent records.\n\n</td></tr><tr><td>\n\nDesktop action parameter value\\[sn\\_desktop\\_core\\_action\\_parameter\\_value\\]\n\n</td><td>\n\nStores the desktop action parameter value records as child records.\n\n</td></tr></tbody>\n</table>## Plugins installed\n\n<table id=\"table_xq5_tgy_whc\"><thead><tr><th>\n\nPlugin\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nAI Desktop Actions\\[com.sn\\_desktop\\_agents\\]\n\n</td><td>\n\nContains configuration of desktop action tool used by AI Agent Studio to discover available desktop actions while creating AI agents and invoke desktop actions via AI agents during execution.\n\n</td></tr><tr><td>\n\nAI Desktop Actions Core\\[com.sn\\_desktop\\_core\\]\n\n</td><td>\n\nPackages tables, custom functionality specific to AI Desktop Actions application, and AI Desktop Actions download interface within a scoped application.\n\n</td></tr><tr><td>\n\nServiceNow Otto AI web agents\\[sn\\_naa\\]\n\n</td><td>\n\nContains system properties, default AI agent and agentic workflow named Web Automation Agent and Web Automation respectively, and functionality to perform adaptive automation on web.\n\n</td></tr></tbody>\n</table>## System properties installed\n\n<table id=\"table_hkb_zvg_ljc\"><thead><tr><th>\n\nProperty\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nsn\\_desktop\\_core.record\\_with\\_ai\n\n</td><td>\n\nMakes **Record with AI** the default recording option. Turn off this property to set the manual recorder as the default recording option.-   Type: true \\| false\n-   Default: true\n\n</td></tr><tr><td>\n\nsn\\_desktop\\_core.max\\_action\\_events\n\n</td><td>\n\nModifies the limit of maximum number of events processed during a single Desktop action execution in AI Desktop Actions.-   Type: Integer\n-   Default: 200\n\n</td></tr><tr><td>\n\nsn\\_naa.ai\\_web\\_agent.enabled\n\n</td><td>\n\nEnables or disables the adaptive desktop actions on the instance. Set to 'true' to enable the web agent, or 'false' to disable it.-   Type: true \\| false\n-   Default: true\n\nRoles and permissions\n\nadmin: Read\n\n</td></tr><tr><td>\n\nsn\\_naa.allowed\\_websites\n\n</td><td>\n\nStores a list of websites that AI agents configured with adaptive desktop actions are permitted to open and perform tasks.Type: String\n\nRoles and permissions\n\n-   admin: Read and Write\n-   sn\\_naa\\_admin: Read and Write\n\n</td></tr><tr><td>\n\nsn\\_naa.context\\_closing\\_frequency\n\n</td><td>\n\nSpecifies, in hours, how long to wait before closing orphaned, running `sn_naa_context` records in the database.-   Type: integer\n-   Default: 24\n\nRoles and permissions\n\n-   admin: Read and Write\n-   sn\\_naa\\_admin: Read and Write\n\n</td></tr><tr><td>\n\nsn\\_naa.keep\\_tab\\_open\n\n</td><td>\n\nKeeps the browser tabs that open during goal execution open after the goal completes.\n\n Whenever you update the value, select the **ServiceNow Web Automation** extension icon, and save the instance provided in the extension.\n\n -   Type: true \\| false\n-   Default: true\n\n Roles and permissions\n\n-   admin: Read and Write\n-   sn\\_naa\\_admin: Read and Write\n\n</td></tr><tr><td>\n\nsn\\_naa.min\\_web\\_agent\\_version\n\n</td><td>\n\nSpecifies the minimum adaptive desktop action \\(browser extension\\) version required for this instance to function correctly. If the installed version is lower than this value, the system will not run.Type: string\n\nRoles and permissions\n\nsys\\_admin: Read\n\n</td></tr><tr><td>\n\nsn\\_naa.NaaModeratorToolTimeLimit\n\n</td><td>\n\nSpecifies the maximum duration, in milliseconds, that the web automation tool is allowed to run before it's considered a failure.-   Type: integer\n-   Default: 1800000\n\nRoles and permissions\n\n-   admin: Read and Write\n-   sn\\_naa\\_admin: Read and Write\n\n</td></tr><tr><td>\n\nsn\\_naa.reasoning.manual\\_intervention\\_prompt\n\n</td><td>\n\nInstructs the system to pause and request explicit input, confirmation, or a decision from the user in scenarios that require manual intervention.Type: string\n\nRoles and permissions\n\n-   admin: Read and Write\n-   sn\\_naa\\_admin: Read and Write\n\n</td></tr><tr><td>\n\nsn\\_naa.step\\_record\\_cleanup\\_frequency\n\n</td><td>\n\nSpecifies, in days, how long to wait before permanently deleting `sn_naa_step` records from the database.-   Type: Integer\n-   Default: 90\n\nRoles and permissions\n\n-   admin: Read and Write\n-   sn\\_naa\\_admin: Read and Write\n\n</td></tr><tr><td>\n\nsn\\_naa.web\\_agent.compaction\\_enabled\n\n</td><td>\n\nEnables summarization of steps that exceed the history limit, rather than discarding them. When turned off, only the most recent configured number of steps are retained.-   Type: true \\| false\n-   Default: true\n\nRoles and permissions\n\n-   admin: Read and Write\n-   sn\\_naa\\_admin: Read and Write\n\n</td></tr><tr><td>\n\nsn\\_naa.web\\_agent.compaction\\_history\\_limit\n\n</td><td>\n\nSets the maximum number of unsummarized steps allowed before the oldest batch is summarized. When unsummarized steps exceed this value, compaction is triggered.-   Type: Integer\n-   Default: 15\n\nRoles and permissions\n\n-   admin: Read and Write\n-   sn\\_naa\\_admin: Read and Write\n\n</td></tr><tr><td>\n\nsn\\_naa.web\\_agent.summarization\\_batch\\_size\n\n</td><td>\n\nSets the number of steps combined into a single summary. Larger batches reduce how often summarization runs, but produce less granular summaries.-   Type: Integer\n-   Default: 10\n\nRoles and permissions\n\n-   admin: Read and Write\n-   sn\\_naa\\_admin: Read and Write\n\n</td></tr><tr><td>\n\nsn\\_naa.web\\_agent\\_environment\\_type\n\n</td><td>\n\nSpecifies the adaptive desktop action execution type. Set to `cloud`, which runs execution in the cloud.\n\nSet it to `local` to run execution through the browser extension.\n\n-   Type: choice list\n-   Default: cloud\n\nRoles and permissions\n\nadmin: Read\n\n</td></tr><tr><td>\n\nsn\\_desktop\\_core.enable\\_reusable\\_assets\n\n</td><td>\n\nAllows turning on or off the Reusable Skills feature enables reuse of recorded desktop actions as deterministic assets that execute from user prompts in the AI Desktop Actions application \\(macOS\\).-   Type: true \\| false\n-   Default: false\n\nRoles and permissions\n\n-   admin: Read and Write\n-   sn\\_aia.admin and now\\_assist\\_panel\\_user: Read\n\n</td></tr></tbody>\n</table>**Parent Topic:**[AI Desktop Actions reference](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/intelligent-experiences/agentic-desktop-reference.md)\n\n"}}