Table of Contents

Private Storage for Agents

Learn how to manage an agent's private storage files in the Management Portal.

Overview

Private storage holds files that belong to a single agent. Files you upload here are available to every conversation with that agent, so users don't have to upload them to each conversation.

Private storage is managed on the Private Storage tab of the agent editor. It is not a data source type and is not configured on the Data Sources page.

Prerequisites

  • The agent private store feature flag (FoundationaLLM.Agent.PrivateStore) must be enabled for you. In the sidebar, select Platform > Configuration and check the Feature Flags tab.
  • The agent must use one of these workflows:
    • The Azure OpenAI Assistants workflow (azure-openai-assistants-workflow).
    • A workflow whose class name is FoundationaLLMFunctionCallingWorkflow.
  • You must have permission to edit the agent.

The Private Storage tab appears only when both conditions are met for a saved agent. If you are creating a new agent, save it with a supported workflow first, then reopen it from the Agents list.

Open Private Storage

  1. In the sidebar, select Agents > Agents.
  2. Select the Edit (pencil) icon for the agent.
  3. Select the Private Storage tab.

The tab shows an Upload File(s) area and an Existing File(s) table.

Upload Files

  1. In Upload File(s), drag and drop files onto the upload area, or select choose files to browse. You can add several files at once.
  2. The selected files appear in a table with File name, Size, and Actions columns. Select the x icon to remove a file before uploading.
  3. Select Upload Files.

After upload, processing starts and the Status column of the Existing File(s) table updates automatically:

Status Meaning
Processing... or Step n of m The file is still being processed.
Ready The file was processed successfully and is available to the agent.
Error The file could not be processed. Select the copy icon to copy the agent name, file name, and file identifier for a support request.

Upload rules:

  • The upload area lists the allowed file types. If no restriction is configured, it shows "Any file type".
  • Each file can be up to 512 MB.
  • A file name that already exists in the private store, or is already selected, is rejected.
  • Up to 1,000 files are allowed in total.

Delete Files

  1. In Existing File(s), select the Delete file (trash) icon for the file. The icon is disabled while the file is still processing.
  2. In the Delete File dialog, select Yes.

The status shows Deleting... until the deletion finishes, and then the file is removed from the table.

Changes on this tab take effect immediately. You don't need to select Save Changes in the agent editor for file uploads or deletions.

Select the refresh icon next to Existing File(s) to reload the file list.