How-to guideGet a task done

Create a batch with the Adaptation Agent

Agent Console is in private preview: it’s available to selected customers, and its agents and features may change before it’s generally available.

This page explains how to set up a batch of adaptations by describing what you want to the Adaptation Agent. The agent finds the template, asks you for each parameter value, and creates the batch, so you can review it in Storyteq CMP before creating the assets.

Prerequisites

Before you begin, ensure you have:

  • The Member or Manager role for the Agent Console module. Each role’s permissions are listed in Agent Console permissions.

  • The Adaptation Agent on your Agent Console dashboard.

  • A role that lets you create adaptations, such as Creator for Assets, which the Standard User preset includes. The agent works within the permissions you already have in Storyteq CMP.

  • The name of the template you want to use.

  • A public URL for each file you want to use in an asset parameter that accepts any file, such as a custom image.

Create the batch

  1. Open Agent Console from the application switcher at the top left, or navigate to https://app.storyteq.com/agent-console/<client-handle>;.

    <client-handle> is your organisation’s handle: the same name that follows /portals/ in your Content Portal address.

  2. Select the Adaptation Agent tile.

  3. Describe what you want to make, and include the template’s name.

    The agent finds the template by its name, so your message must include words that match the name. For example: "Create summer social ads from the Summer Sale template."

  4. When the agent shows the template it found, confirm that it’s the one you want.

  5. Answer the agent’s questions about the template’s parameters.

    The agent asks for the parameters in the order they appear on the template, starting with the required ones. For a parameter with a set of options, it shows a question card where you can select more than one option.

    Every combination of your selections becomes its own adaptation in the batch. For example, selecting two sizes, 16x9 and 9x16, and three flavours of a product creates six adaptations.

  6. Answer the agent’s questions about the optional parameters, or leave them as they are.

  7. Review the agent’s summary of the adaptations it’s going to create, then choose to create the batch.

    The agent shows the batch’s name and ID.

Review the batch

The agent creates the batch as a draft, so you can review it before any adaptations are produced. You produce the adaptations from the batch in Storyteq CMP, and you can find it in either of the places you usually work:

  • Adaptation Studio: open the template you used, then select its Batches tab. The batch is marked Contains Draft.

  • Content Portal: in My Content (select from the top right), select Digital Adaptations, then the Batches tab. The batch’s status is Draft.

    1. Search for the batch by the name the agent gave you.

    2. Open the batch and review its adaptations.

    3. Produce the adaptations.

For further information, refer to Produce digital adaptations in batch.

What the agent can fill in

The agent fills in text parameters, and parameters that offer a set of options. For an asset parameter that accepts any file, give the agent a public URL to the file.