Files
life-echo/api/app/agents/image_prompt/orchestrator.py
Sully 53e0065e3e refactor(api): TOML 配置 SSOT、统一错误契约、Auth/事务加固与可观测性 (#33)
配置 SSOT(TOML + .env)
统一错误契约
Auth 与事务边界
Redis / Celery 可靠性:业务 Redis(DB/0)与 Celery broker/backend(DB/1)显式拆分;连接池、sync client
可观测性(OpenTelemetry + LGTM)
2026-05-22 13:44:50 +08:00

96 lines
3.1 KiB
Python
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
"""
ImagePromptOrchestrator图片提示词生成编排器。
根据调用方(封面/正文)选择 build_prompt 或 build_cover_prompt
统一异常处理和回退;内部委托 PromptGenerationAgent。
"""
from __future__ import annotations
from typing import Any, Optional
from app.agents.image_prompt.prompt_agent import PromptGenerationAgent
from app.core.config import settings
from app.core.logging import get_logger
from app.features.memoir.memoir_images.settings import MemoirImageSettings
from app.features.memoir.constants import memoir
logger = get_logger(__name__)
class ImagePromptOrchestrator:
"""
图片提示词编排器。
区分封面 vs 正文配图,统一调用 PromptGenerationAgent
异常与回退由 PromptGenerationAgent底层 MemoirImagePromptService处理。
"""
def __init__(self, llm: Optional[Any], settings: MemoirImageSettings) -> None:
self._agent = PromptGenerationAgent(llm=llm, settings=settings)
def build_prompt(
self,
chapter_title: str,
chapter_category: str,
description: str,
context_excerpt: str,
) -> dict[str, str]:
"""
生成正文配图的 prompt。
委托 PromptGenerationAgent已含 LLM 调用失败时的 fallback 逻辑。
"""
return self._agent.build_prompt(
chapter_title=chapter_title,
chapter_category=chapter_category,
description=description,
context_excerpt=context_excerpt,
)
def build_cover_prompt(
self,
chapter_title: str,
chapter_category: str,
context_excerpt: str,
) -> dict[str, str]:
"""
生成章节封面的 prompt。
委托 PromptGenerationAgent已含 LLM 调用失败时的 fallback 逻辑。
"""
return self._agent.build_cover_prompt(
chapter_title=chapter_title,
chapter_category=chapter_category,
context_excerpt=context_excerpt,
)
def build_story_primary_prompt(
self,
story_title: str,
story_stage: str | None,
prompt_brief: str,
style_profile: str | None,
) -> dict[str, str]:
"""生成 story 主插图的 prompt。"""
return self._agent.build_story_primary_prompt(
story_title=story_title,
story_stage=story_stage,
prompt_brief=prompt_brief,
style_profile=style_profile,
)
def get_image_prompt_orchestrator() -> ImagePromptOrchestrator:
"""Celery / 后台任务入口:统一装配 LLM 与 MemoirImageSettings。"""
from app.core.llm_gateway import LlmGateway, LlmUseCase
image_settings = MemoirImageSettings.from_env()
try:
llm = LlmGateway().langchain_llm_for(LlmUseCase("image_prompt"))
except Exception as e:
if memoir.image_prompt_fallback_disabled:
raise
logger.warning(
"ImagePromptOrchestrator LLM 初始化失败,使用确定性 fallback: {}",
e,
)
llm = None
return ImagePromptOrchestrator(llm=llm, settings=image_settings)