张胜宇
e239eb778b
1) 客服 Agent 四份交付文档 + 构建脚手架：品牌由包装占位 XX科技 / 旧名 南方财富 统一为南方基金（热线 400-889-8899 / 官网 nffund.com），系统名改为「智能服务系统」； 同步追加 §0.4 修订记录行，工程记录行保留原占位字面以支撑硬编码扫描验收。 2) 开发文档：清理 28 份已作废/残留文档（14 份移出归档 + 14 份仓库副本）， 新增《文档规整方案与开发前待决事项-2026-09-17》。 3) 客服agent 四份交付文档首次纳入本分支。
69 lines
3.2 KiB
Python
69 lines
3.2 KiB
Python
from collections.abc import Callable
|
|
|
|
from app.core.contracts import AgentDefinition, RequestContext
|
|
from app.core.errors import AgentTypeNotFoundError, ValidationAgentError
|
|
from app.service.agent.authorizer import AgentAuthorizer
|
|
from app.service.agent.base import BaseAgent
|
|
from app.service.agent.governance import AgentGovernance, PlatformGovernance
|
|
from app.service.intent_classifier import IntentClassifier, IntentEndpointResolver
|
|
from app.service.model_gateway import ModelGenerationService
|
|
from app.service.tool_executor import ToolExecutor
|
|
|
|
AgentBuilder = Callable[[RequestContext], BaseAgent]
|
|
|
|
|
|
class AgentFactory:
|
|
def __init__(
|
|
self, governance: AgentGovernance | None = None,
|
|
model_service: ModelGenerationService | None = None,
|
|
tool_executor: ToolExecutor | None = None,
|
|
intent_classifier: IntentClassifier | None = None,
|
|
intent_endpoint_resolver: IntentEndpointResolver | None = None,
|
|
) -> None:
|
|
self._builders: dict[str, AgentBuilder] = {}
|
|
self._definitions: dict[str, AgentDefinition] = {}
|
|
self._governance = governance or PlatformGovernance()
|
|
self._model_service = model_service
|
|
self._tool_executor = tool_executor
|
|
self._intent_classifier = intent_classifier
|
|
self._intent_endpoint_resolver = intent_endpoint_resolver
|
|
|
|
def register(self, definition: AgentDefinition, builder: AgentBuilder) -> None:
|
|
if definition.agent_type in self._builders:
|
|
raise ValidationAgentError("agent_type already registered")
|
|
self._builders[definition.agent_type] = builder
|
|
self._definitions[definition.agent_type] = definition
|
|
|
|
def authorize(self, agent_type: str, context: RequestContext) -> None:
|
|
definition = self.definition(agent_type)
|
|
AgentAuthorizer.ensure_allowed(definition, context)
|
|
|
|
def definition(self, agent_type: str) -> AgentDefinition:
|
|
definition = self._definitions.get(agent_type)
|
|
if definition is None:
|
|
raise AgentTypeNotFoundError("agent_type is not registered")
|
|
return definition
|
|
|
|
def create(self, agent_type: str, context: RequestContext) -> BaseAgent:
|
|
self.authorize(agent_type, context)
|
|
builder = self._builders.get(agent_type)
|
|
if builder is None:
|
|
raise AgentTypeNotFoundError("agent_type is not registered")
|
|
agent = builder(context)
|
|
if not isinstance(agent, BaseAgent):
|
|
raise ValidationAgentError("registered builder must return BaseAgent")
|
|
if agent.definition != self._definitions[agent_type]:
|
|
raise ValidationAgentError("builder returned a different AgentDefinition")
|
|
agent.bind_governance(self._governance)
|
|
if self._model_service is not None:
|
|
agent.bind_model_service(self._model_service)
|
|
if self._tool_executor is not None:
|
|
agent.bind_tool_executor(self._tool_executor)
|
|
if (
|
|
agent.definition.requires_model_intent_classification
|
|
and self._intent_classifier is not None
|
|
and self._intent_endpoint_resolver is not None
|
|
):
|
|
agent.bind_intent_classifier(self._intent_classifier, self._intent_endpoint_resolver)
|
|
return agent
|