Files
group_fqcd_jr/app/service/agent/factory.py
T

65 lines
3.1 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 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