Multimodal Agent Architecture: Processing Text, Images, Audio, and Video Together

Why Multimodal Agents Matter

Most AI agents operate on text alone. A user types a question, the agent reasons over text, and it returns a text answer. But the real world is not text-only. Business documents arrive as PDFs with embedded charts. Customer support tickets include screenshots. Meeting recordings combine speech, slides, and video. A truly capable agent must process all of these modalities together.

Multimodal agents accept inputs in multiple formats — text, images, audio, video — and reason across them to produce unified responses. This guide covers the architectural patterns that make this possible.

Core Architecture Pattern: The Modality Router

The foundation of any multimodal agent is a routing layer that detects the type of each input and dispatches it to the appropriate processor. Here is a clean implementation:

import mimetypes
from dataclasses import dataclass, field
from enum import Enum
from typing import Any


class Modality(Enum):
    TEXT = "text"
    IMAGE = "image"
    AUDIO = "audio"
    VIDEO = "video"
    DOCUMENT = "document"


@dataclass
class ModalityInput:
    modality: Modality
    raw_data: bytes | str
    metadata: dict[str, Any] = field(default_factory=dict)


def detect_modality(file_path: str | None, text: str | None) -> Modality:
    """Detect the modality of an input based on file type or content."""
    if text and not file_path:
        return Modality.TEXT

    mime_type, _ = mimetypes.guess_type(file_path)
    if not mime_type:
        return Modality.TEXT

    category = mime_type.split("/")[0]
    mapping = {
        "image": Modality.IMAGE,
        "audio": Modality.AUDIO,
        "video": Modality.VIDEO,
    }
    if mime_type == "application/pdf":
        return Modality.DOCUMENT
    return mapping.get(category, Modality.TEXT)

This detection layer keeps the rest of the system clean. Every downstream processor receives a strongly-typed ModalityInput rather than guessing what it is working with.

Modality-Specific Processors

Each modality needs a dedicated processor that converts raw input into a structured representation the reasoning engine can consume. The key insight is that all processors must output a common intermediate format:

from abc import ABC, abstractmethod


@dataclass
class ProcessedContent:
    """Unified output from any modality processor."""
    text_description: str
    structured_data: dict[str, Any] = field(default_factory=dict)
    embeddings: list[float] = field(default_factory=list)
    source_modality: Modality = Modality.TEXT


class ModalityProcessor(ABC):
    @abstractmethod
    async def process(self, inp: ModalityInput) -> ProcessedContent:
        ...


class TextProcessor(ModalityProcessor):
    async def process(self, inp: ModalityInput) -> ProcessedContent:
        return ProcessedContent(
            text_description=str(inp.raw_data),
            source_modality=Modality.TEXT,
        )


class ImageProcessor(ModalityProcessor):
    def __init__(self, vision_model: str = "gpt-4o"):
        self.vision_model = vision_model

    async def process(self, inp: ModalityInput) -> ProcessedContent:
        import base64
        import openai

        client = openai.AsyncOpenAI()
        b64_image = base64.b64encode(inp.raw_data).decode()

        response = await client.chat.completions.create(
            model=self.vision_model,
            messages=[{
                "role": "user",
                "content": [
                    {"type": "text", "text": "Describe this image in detail."},
                    {
                        "type": "image_url",
                        "image_url": {
                            "url": f"data:image/png;base64,{b64_image}"
                        },
                    },
                ],
            }],
        )
        description = response.choices[0].message.content
        return ProcessedContent(
            text_description=description,
            source_modality=Modality.IMAGE,
        )

Fusion Strategies

Once each modality is processed into ProcessedContent, you need a fusion strategy to combine them for the reasoning step. Three common approaches exist:

Early fusion concatenates raw representations before reasoning. This works well when modalities are tightly coupled, such as an image and its caption.

Late fusion processes each modality independently and merges the final outputs. This is simpler to implement and debug.

Cross-attention fusion lets modalities attend to each other during processing. This is the most powerful but requires custom model architectures.

For most agent systems, late fusion with a summary prompt is the practical choice:

class MultimodalFusionAgent:
    def __init__(self):
        self.processors: dict[Modality, ModalityProcessor] = {
            Modality.TEXT: TextProcessor(),
            Modality.IMAGE: ImageProcessor(),
        }

    async def reason(
        self, inputs: list[ModalityInput], query: str
    ) -> str:
        processed = []
        for inp in inputs:
            processor = self.processors[inp.modality]
            result = await processor.process(inp)
            processed.append(result)

        context_parts = []
        for i, p in enumerate(processed):
            context_parts.append(
                f"[Input {i + 1} ({p.source_modality.value})]: "
                f"{p.text_description}"
            )

        combined_context = "\n\n".join(context_parts)

        import openai
        client = openai.AsyncOpenAI()
        response = await client.chat.completions.create(
            model="gpt-4o",
            messages=[
                {
                    "role": "system",
                    "content": (
                        "You are a multimodal reasoning agent. "
                        "Use all provided context to answer the query."
                    ),
                },
                {
                    "role": "user",
                    "content": (
                        f"Context:\n{combined_context}\n\n"
                        f"Query: {query}"
                    ),
                },
            ],
        )
        return response.choices[0].message.content

Handling Modality Failures Gracefully

In production, individual modality processors will fail. An audio file might be corrupted or an image might be too large. The agent must degrade gracefully rather than crash:

async def safe_process(
    processor: ModalityProcessor, inp: ModalityInput
) -> ProcessedContent:
    try:
        return await processor.process(inp)
    except Exception as e:
        return ProcessedContent(
            text_description=(
                f"[Failed to process {inp.modality.value} input: {e}]"
            ),
            source_modality=inp.modality,
        )

This pattern lets the reasoning engine know that a modality failed without aborting the entire pipeline.

FAQ

What is the best fusion strategy for a general-purpose multimodal agent?

Late fusion with LLM-based summarization is the most practical choice for most applications. Each modality is processed independently into text descriptions, then a single LLM call reasons over all descriptions together. This avoids the complexity of custom cross-attention models while still capturing cross-modal relationships through the language model.

Can I use open-source models instead of GPT-4o for vision processing?

Yes. Models like LLaVA, InternVL, and Qwen-VL provide strong vision-language capabilities that you can self-host. Replace the OpenAI API call in the ImageProcessor with an inference call to your local model server. The ProcessedContent interface stays the same regardless of which model backs the processor.

How do I handle real-time multimodal inputs like live video streams?

For real-time processing, add a buffering layer that accumulates frames or audio chunks before sending them to processors. Use asyncio queues to decouple the ingestion rate from processing speed. Process key frames rather than every frame to keep latency manageable, and maintain a sliding window of recent context for the reasoning engine.

---

#MultimodalAI #AgentArchitecture #VisionLanguageModels #AudioProcessing #Python #AgenticAI #LearnAI #AIEngineering