Media Agent

The Media Agent acts as your personal Creative Director within the Nappai automation system. Instead of just generating generic images or videos, it ensures that all visual and audio content you create stays consistent with your brand’s style, tone, and personality.

Think of it as a smart assistant that knows your brand guidelines inside and out. Whether you need a product image, a promotional video, or audio for a podcast, this component uses advanced AI tools to produce high-quality media that looks and sounds exactly like your brand should. It automatically checks for your brand’s specific rules and uses external creative tools to bring your ideas to life.

How it Works

The Media Agent works by combining your specific brand information with external creative AI tools. Here is a simple breakdown of the process:

1. Understanding Your Brand: The agent first looks at the “Brand Profile” or “Character Profile” you provide. This includes rules about colors, styles, tone of voice, and visual preferences. If it doesn’t have this information immediately, it can automatically search for it to ensure accuracy.
2. Connecting with Creative Tools: It connects to specialized AI tools (like image generators or video editors) within the Nappai ecosystem. It doesn’t just create content; it orchestrates the creation by choosing the right tool for the job (e.g., using an image generator for a photo or a video tool for a clip).
3. Ensuring Consistency: As it generates content, it applies the rules from your brand profile. This means it will avoid styles, colors, or tones that don’t match your brand identity.
4. Delivering Results: Finally, it provides the finished media file (image, video, or audio) along with information about how it was created, so you can track what worked well.

Connection & Credentials

This component interacts with external creative services to generate media.

1. Go to the Credentials section in your Nappai panel.
2. Create a new credential for the specific creative service you want to use (e.g., for image generation or video processing) and fill in the required fields (such as API Keys or tokens).
3. In your workflow, select the saved credential in the Credential input field of this node.

Note: If you are using pre-configured brand profiles, ensure those profiles are also saved and accessible in your Nappai dashboard.

Operations

This component does not have multiple distinct operations. It functions as a unified agent that handles the entire creative process based on the inputs provided. You simply configure the inputs, and the agent executes the generation process automatically.

Inputs

The following fields are available to configure this component. These inputs help the agent understand what you want to create and how it should look.

• Perfil de Marca o Personaje: Information describing your brand’s or character’s visual and tonal rules. This ensures all generated media stays consistent. You can provide this as a structured profile or let the agent infer it from existing assets.

  • Visible in: Standard Media Generation
  • Type: Dictionary or JSON
  • Default: None

• Contexto de Producción: Specific instructions on what kind of content you want to generate (e.g., “promotional video,” “product image,” “podcast audio”). This helps the agent choose the right creative tools.

  • Visible in: Standard Media Generation
  • Type: String or Dictionary
  • Default: Not specified

• Activos Digitales: A list of previous images, logos, or videos that can be used as references. This helps the agent maintain visual consistency with your existing brand assets.

  • Visible in: Standard Media Generation
  • Type: List
  • Default: Empty List

Outputs

When the Media Agent finishes its work, it provides the following results:

• Contenido Multimedia: The final generated media file. This could be a link to an image, a video clip, or an audio file. This is the main result you will likely connect to other parts of your workflow, such as a social media posting agent or a storage component.
• Registro de Producción: A log of the steps taken, including which tools were used and any adjustments made to ensure brand consistency. This is useful for auditing or debugging if the output isn’t exactly what you expected.

Output Data Example (JSON)

json { “media_output”: { “type”: “image”, “url”: “https://cdn.nappai.com/generated/brand_campaign_2024.jpg”, “format”: “jpg”, “width”: 1920, “height”: 1080 }, “generation_log”: [ “Used ImageGeneratorTool_v2”, “Applied Brand Style Guide: ‘Modern Tech Blue’”, “Resolved Character Profile from Brand Profile Input” ] }

Connectivity

This component is typically placed early in a creative workflow.

• Input Connections: It usually receives data from Data Retrieval components (to fetch brand profiles) or Text Input components (to define the production context). It may also connect to Image/Video Storage components if you need to reference existing assets for consistency.
• Output Connections: The generated media (media_output) is typically connected to:
  • Social Media Agents: To automatically post the image or video to platforms like Instagram or LinkedIn.
  • Content Reviewers: For human or AI approval before publishing.
  • Storage Systems: To save the final asset for future use.

Usage Example

Imagine you are launching a new product and need a promotional image.

1. You set up a Media Agent node.
2. In the Perfil de Marca o Personaje field, you select your brand’s profile, which includes your logo colors and font styles.
3. In the Contexto de Producción field, you type: “Create a high-resolution image of a sleek smartphone on a minimalist background, using cool blue tones.”
4. The Media Agent processes this request, checks your brand profile to ensure the blue tones match your brand guidelines, and uses an AI image generator to create the image.
5. The result is an image link that you can then send to a Social Media Poster agent to publish on Facebook.

Important Notes

This component is currently in Development Mode (is_development: True). This means that:

• The behavior of the agent may change as it is refined.
• Documentation might be updated as features evolve.
• It is recommended to test this component in non-critical workflows first before relying on it for important production tasks.

Tips and Best Practices

• Provide Detailed Brand Profiles: The more specific you are in the “Brand Profile” input, the better the media output will align with your expectations. Include details about colors, styles, and even tone.
• Use Existing Assets: If you have a library of past successful images, include them in the Activos Digitales input. This helps the agent mimic successful visual styles.
• Check the Generation Log: If the output isn’t quite right, review the Registro de Producción to see which tools were used and why, helping you adjust your inputs for the next attempt.
• Iterate on Context: If the first result isn’t perfect, tweak the Contexto de Producción text. Small changes in wording can lead to significantly different creative results.

Security Considerations

• Credential Security: Ensure that the API keys for external creative tools are stored securely in the Nappai Credentials section. Do not hardcode these keys in your workflow logic.
• Brand Data Privacy: When providing a “Brand Profile,” be mindful of sensitive information. Only include brand guidelines and style rules that are necessary for the AI to generate consistent content. Avoid including confidential business strategies or private customer data in the profile inputs.