IAV-241/feat(customer-care): add instruction management entities and collaborator agent linking
📋 Overview
This MR introduces the core entities for the customer care agent management system, including instruction management (standard and custom), agent integrations and FAQ system. It also adds collaborator-agent linking endpoints.
✨ What's New
Entities Added
- AgentCustomInstruction: Custom instructions created by client admins
- AgentStandardInstruction: System-defined instruction assignments with activation control
- StandardInstruction: Reusable system instructions shared across agents
- AgentIntegration: External service integrations (WhatsApp, Instagram, LinkedIn, etc.)
- Faq: Agent knowledge base with categorization
API Endpoints Added
-
buildLinkCollaboratorToAgentUrl(): Link a collaborator to an agent -
buildUnlinkCollaboratorFromAgentUrl(): Unlink a collaborator from an agent
🔧 Technical Implementation
Entity Design Decisions
- Instruction separation: StandardInstruction (system-wide) + AgentStandardInstruction (agent-specific activation) for better reusability
- No FK constraint: AgentStandardInstruction uses data snapshot instead of FK relation to preserve instructions after StandardInstruction deletion