Run Enrichment Agents in a Batch Upload

Summary

Enrichment agents fill in fields such as names, descriptions, and alt text, based on how each agent is set up in your portal. In a batch upload, you can run one or more enrichment agents on your files before you publish them. Without this, agents only enrich assets after they're published. Agent output goes straight into the files' fields, so you can review and adjust it before your assets reach the asset bank.

For more on agents, see Agent Library: Creating, Running, and Updating Agents.

Who?

Batch Uploads in Workspace are available to Publishers with Access Workspace and Upload assets permissions, and Requesters with Access Workspace and Upload assets with mandatory approval permissions.

To run enrichment agents in Batch Uploads users should also have the Run Agents permission.

How?

Run Enrichment Agents on Selected Files in a Batch Upload

Use this when several files need the same enrichment, for example names and alt text for a full set of images. You can run one agent or several agents at once. This works in both List view and Grid view.

Select agents becomes available once every file in the batch has finished uploading and processing. Until then, it's disabled.

  1. Select the files you want to enrich.
  2. In the floating toolbar, select Select agents (the sparkle icon).
  3. In Select agents, check one or more agents.
  4. Select Run.
  5. Review the actions in the confirmation. The confirmation is titled Run agent for one agent and Run agents for more than one agent.
  6. Select Run agent or Run agents.

To find a specific agent, type in Search agents. The list filters by agent name and description as you type. If no agents match, No results found appears. Clear the search field to see all agents again.

To return to the agent list from the confirmation, click the back arrow. To close without running anything, click Cancel.

Run Enrichment Agents on a Single File in a Batch Upload

Run agents from Free mode in List view

  1. Hover over the row of the file.
  2. In the File column, select the three-dot menu.
  3. Select Select agents, below Details.
  4. Check one or more agents.
  5. Select Run.
  6. Select Run agent or Run agents to confirm.

You’ll see Agent successfully running. in the bottom left.

Run agents from View mode

  1. Open the file in the inspector. For more on opening a file in the inspector, see Editing Modes in a Batch Upload.
  2. In the inspector header, select the three-dot menu.
  3. Select Select agents.
  4. Check one or more agents.
  5. Select Run.
  6. Select Run agent or Run agents to confirm.

Follow an Agent's Progress

Agents take a moment to fill in fields. The batch shows what's running and which fields are being edited, so you know when you can edit and publish again.

While agents run, you see:

  • Agent successfully running. in the bottom left. When you run more than one agent, the message shows the number, for example 2 agents successfully running.

  • Agent running... under the batch name.

  • A spinner on the thumbnail of each file being enriched.

  • A loading placeholder in each cell the agent is filling, until the value appears.

  • Editing fields... x/x at the bottom of the screen, showing how many fields are done. In Selection mode, it appears above the floating toolbar. In Free mode and View mode, it appears in place of the toolbar.

  • A spinner on Select agents in the floating toolbar, even if you change your selection.

While agents run, keep in mind:

  • The fields the agent is filling are locked on the files it's enriching. All other fields, and all fields on other files, stay editable.

  • Publish is disabled for all files in the batch until the agent finishes.

  • You can leave the batch while an agent runs. On the Uploads page, the batch shows that an agent is running, and you can return to it at any time.

Review Agent Results

When an agent finishes, its output is already in the files' fields. Check the results before you publish, and open the agent's details if you want to see every change it made.

When agents finish, you see:

  • Agent completed in the bottom left, once for each agent that ran.

  • All changes saved with a green checkmark under the batch name.

  • The new values in the cells and in the inspector.

A few details to be aware of:

  • If an agent returns no value for a field, the field keeps the value it had before the agent ran.

  • Taxonomy automations run on agent output the same way they run on values you enter yourself. See How To Create And Manage Taxonomy Automations.

  • To change a value the agent added, edit the field as usual.

To see the details of an agent run:

  1. In the Agent completed message, click Show details (the open icon).

  2. Review the agent's changes on the Agents activity page. See Workspace: Agent Activity - Reviewing, Editing, and Approving Agent Suggestions.

Related Articles


 

Updated