Build Agentic workflows, RAG pipelines, with rich AI model and tool support on one collaborative workspace. Deploy on cloud, VPC, or self-hosted, so teams move from prototype to production without rebuilding the stack.
Python agentagentic-aiagentic-frameworkagentic-workflowaiautomationclaudedeepseekgenaigptllmlow-codemcpnextjsno-codeopenaipythonskillsworkflow
"""Serializable DTOs for one Agent App multimodal user prompt."""
from __future__ import annotations
import base64
import binascii
from typing import Annotated, ClassVar, Literal, Self
from pydantic import BaseModel, ConfigDict, Field, model_validator
type DifyUserPromptFileType = Literal["image", "document", "audio", "video", "custom"]
class DifyUserPromptImageConfig(BaseModel):
"""One image delivered directly to the configured vision model.
Callers provide either an HTTP(S) URL or base64 bytes. Opaque Dify file
references belong to the sandbox download flow and are not accepted here.
"""
delivery: Literal["multimodal"] = "multimodal"
type: Literal["image"] = "image"
filename: str = Field(min_length=1)
mime_type: str = Field(pattern=r"^image/[A-Za-z0-9.+-]+$")
format: str = Field(min_length=1)
url: str | None = None
base64_data: str | None = None
detail: Literal["low", "high"] | None = None
model_config: ClassVar[ConfigDict] = ConfigDict(extra="forbid")
@model_validator(mode="after")
def _validate_transport(self) -> Self:
if (self.url is None) == (self.base64_data is None):
raise ValueError("exactly one of url or base64_data must be provided")
if self.url is not None and not self.url.startswith(("http://", "https://")):
raise ValueError("url must use http or https")
if self.base64_data is not None:
try:
base64.b64decode(self.base64_data, validate=True)
except (ValueError, binascii.Error) as exc:
raise ValueError("base64_data must be valid base64") from exc
return self
class DifyUserPromptDownloadConfig(BaseModel):
"""A file locator, optionally named to match a directly attached image."""
delivery: Literal["download"] = "download"
type: DifyUserPromptFileType
filename: str | None = Field(default=None, min_length=1)
transfer_method: Literal["remote_url", "local_file", "tool_file", "datasource_file"]
url: str | None = Field(default=None, min_length=1)
reference: str | None = Field(default=None, min_length=1)
model_config: ClassVar[ConfigDict] = ConfigDict(extra="forbid")
@model_validator(mode="after")
def _validate_locator(self) -> Self:
if self.transfer_method == "remote_url":
if self.url is None or self.reference is not None:
raise ValueError("remote_url requires url and must not include reference")
elif self.reference is None or self.url is not None:
raise ValueError("reference is required and url must not be provided")
return self
type DifyUserPromptFileConfig = Annotated[
DifyUserPromptImageConfig | DifyUserPromptDownloadConfig, Field(discriminator="delivery")
]
class DifyUserPromptLayerConfig(BaseModel):
"""User text plus images that should be sent in the same model turn."""
text: str = Field(min_length=1)
files: list[DifyUserPromptFileConfig] = Field(default_factory=list)
model_config: ClassVar[ConfigDict] = ConfigDict(extra="forbid")
__all__ = [
"DifyUserPromptDownloadConfig",
"DifyUserPromptFileConfig",
"DifyUserPromptFileType",
"DifyUserPromptImageConfig",
"DifyUserPromptLayerConfig",
]