{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":23481,"path":"intelligent-experiences/inth-box-box-metadata-management-ai-agent.md","title":"Box metadata management AI agent","bundle":null,"doc_type":null,"release":"australia","body":"\n# Box metadata management AI agent\n\nThis AI agent retrieves Box metadata instances on files and folders, by file or folder ID or by metadata scope and template key.\n\n## Workflow\n\nThe agent helps the user read the metadata applied to Box files and folders.\n\n1.  Ask the user what they want to do and collect the details the action needs, such as the file or folder ID, scope, and template key.\n2.  Look up the metadata instance on a file by file ID or by scope and template key.\n3.  Look up the metadata instance on a folder by folder ID or by scope and template key.\n4.  Present the metadata to the user.\n5.  Report the outcome to the user, including details of any error.\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-   **Flow Actions**\n\nLook up Metadata Instance on File By File ID\n\nLook up Metadata Instance on File by Scope and Template Key\n\nLook up Metadata Instance on Folder By Folder ID\n\nLook up Metadata Instance on Folder by Scope and Template Key\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\nsnc\\_internal\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\nsnc\\_internal\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\nNot applicable.\n\n</td></tr></tbody>\n</table>**Parent Topic:**[Box Spoke AI agents](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/intelligent-experiences/inth-box-ai-agents-overview.md)\n\n**Related topics**  \n\n\n[Box Spoke](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/integrate-applications/box-spoke.md)\n\n[Integration Hub spokes](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/integrate-applications/spokes-list.md)\n\n"}}