Skip to content
Nappai Documentation

Media Agent

Media Agent works as a creative director. You ask for content, for example “an image for the Christmas campaign with our mascot”, and the agent makes sure it stays consistent with your brand: if it does not know your brand or character yet, it asks you what it needs (style, colours, features, clothing, tone) and saves that information in a profile to use in every following piece.

To create the content it uses the NappAI creative components you connect, such as image or video generators. When a profile has its identity sheet, the agent checks each result against it and, if it does not match, generates it again fixing what is wrong.

When to use it

  • Your marketing team creates social media images every day and wants them all to keep the same style.
  • You have a brand mascot or character that must always look the same.
  • You manage several brands and want to switch between them in the conversation without mixing their styles.
  • You want an agent to prepare image and video pieces from the guidelines of your brand book.

Configuration

FieldWhat it does
Agent NameThe agent’s name. It is used when you connect it as a tool or as an agent of another agent. Default: Agent.
Agent DescriptionWhat the agent does, in one sentence. It helps other agents decide when to use it.
User PromptThe text the agent receives. Default: {input}, which is replaced by whatever arrives at Input. You can add other variables in curly braces; each one appears as a new field.
InputThe user’s request, usually connected from a Chat Input.
ConnectionWhat to connect
Model (required)The AI model that drives the agent, for example OpenAI or Anthropic.
Creative ToolsThe creative components the agent can use, connected as tools: for example DALL·E Image Generator, Gemini Image Generator or Runway video Generator. You can also connect a tool that looks up your knowledge base, for example with your brand book: the agent uses it as a source of context if its name contains rag, retriever or search.

Advanced options

FieldWhat it does
Use memoryMakes the agent remember the conversation and the brand and character profiles it creates. Turn it on so profiles are kept from one message to the next. When you turn it on, the Memory connection appears, where you can connect a memory component such as Postgres Memory. Default: off.
Recursion LimitThe maximum number of internal steps the agent can take for each answer. Default: 1000.
StreamShows the progress of the work in the chat while the agent produces the content. Default: off.

Batch processing

With the Batch Mode switch on, the component runs once for each item of the list you connect to Batch Input and returns all the results together as a list. Parallel Executions sets how many items are processed at the same time (1 to 5). Skip if Empty Batch Input skips the component when the list arrives empty, and Skip Branch if Empty Output stops the following components when the result is empty. More in Key concepts.

Using it as an agent tool

You can connect this component to an agent’s Tools input. In the Tool tab, Tool Name and Tool Description are the name and explanation the agent uses to recognise the tool and decide when to call it: write a clear description of what it does.

Brand and character profiles

In the conversation you can ask the agent to create, change, activate, list or delete profiles. Each profile stores the identity sheet of a brand or character: visual style, colours, features, clothing and tone. For example:

  • Create a profile for the Molinos Bakery brand: warm, artisan style, cream and brown colours.
  • Activate the Molinos profile.
  • Change the mascot's apron colour to green.

With a profile active, everything the agent produces follows that identity sheet.

Output

  • Response: the agent’s answer as a chat message, with the generated content or the questions it needs to ask you. Connect it to a Chat Output.
  • Agent: the whole agent, to connect it to another component that coordinates agents, such as Planner Executor Agent.
  • Tool: the agent as a tool, to connect it to another agent’s Tools input.

Example

A bakery chain publishes images of its products every week with its mascot, a smiling miller.

  1. Connect a Chat Input to Input, an AI model to Model and an image generator to Creative Tools.
  2. In the advanced options, turn on Use memory.
  3. Connect Response to a Chat Output.
  4. In the chat, describe the mascot the first time: the agent creates its profile. From then on it is enough to ask for The miller presenting the Twelfth Night cake at the counter.

Good practices

  • Describe your brand or character in detail the first time: the more complete the identity sheet, the more consistent the pieces.
  • Give each creative tool a clear description of what it produces, so the agent picks the right one.