Files
ALwrity/backend/services/intelligence/agents/__init__.py
ajaysi 923fa671fe feat: ContentGuardianAgent, onboarding UX, Team Activity action wiring, docs, agent help modal
ContentGuardianAgent consolidation:
- Merge 3 duplicate classes into single source in specialized/content_guardian.py
- Watchdog audit_committee() with heuristic scoring, coverage gaps, overlaps, alerts
- Remove misleading rejection_rate() helper; use acceptance_rate directly
- Integrate audit + alerts + trend signals into today_workflow_service.py

Team Activity page:
- QualityAuditPanel: health ring, per-agent critiques, coverage gaps, overlaps
- TrendSignalsPanel: opportunity cards with urgency/impact/coverage bars
- AlertBanner: persistent dismiss via POST /alerts/{id}/mark-read
- AgentHelpModal: dialog showing all 8 agents with descriptions, tools, schedule
- QualityAuditPanel action buttons: Fill gap -> /content-planning, Resolve overlap, View CTA on alerts/issues
- TrendSignalsPanel action buttons: Create content from this trend -> /blog-writer with trend context state

Onboarding system:
- Step 4 validation: no auto-pass via basic_ready; requires persona data or explicit progression
- Step 5 validation: logs warning on auto-pass without integration data
- OnboardingCompletionService: single DB session, transactional task creation, upsert pattern
- Business-without-website: nullable website_url on SIFIndexingTask and MarketTrendsTask
- DeepCompetitorAnalysisExecutor: 5-min timeout, 10-competitor cap, asyncio.wait_for
- Persona generation: async with 30s timeout, falls back to scheduler
- OnboardingProgressService.reset_onboarding(): resets session + pauses all DB tasks
- OnboardingControlService.reset_onboarding(): also cancels APScheduler jobs
- FinalStep TaskSchedulingPanel: shows scheduled/failed tasks after completion, 8s auto-redirect
- onboarding_completed agent activity event logged to feed

Documentation:
- docs-site/features/onboarding/: overview, steps, scheduler-tasks, technical-reference (4 pages)
- docs-site/mkdocs.yml: added Onboarding System nav section
- docs-site/features/sif-agents/: overview, agent-directory, committee-system, content-guardian (4 pages)
- docs-site/features/team-activity/: overview, quality-audit, trend-signals, alert-system (4 pages)
- docs-site/features/todays-workflow/: updated overview, technical-architecture, workflow-guide, api-reference
2026-06-01 12:24:31 +05:30

75 lines
1.8 KiB
Python

"""
ALwrity Autonomous Marketing Agents Module
This module provides autonomous marketing agents built on txtai's native agent framework.
The agents work together to monitor market conditions, analyze competitor activities,
and execute coordinated marketing strategies without human intervention.
"""
# Core agent framework
from .core_agent_framework import (
BaseALwrityAgent,
AgentAction,
AgentPerformance,
StrategyOrchestratorAgent
)
# Market signal detection
from .market_signal_detector import (
MarketSignal,
MarketSignalDetector
)
# Performance monitoring
from .performance_monitor import (
PerformanceMonitor,
performance_monitor,
PerformanceMetric,
AgentPerformanceMetrics
)
# Specialized agents
from .specialized_agents import (
ContentGuardianAgent,
LinkGraphAgent,
StrategyArchitectAgent,
ContentStrategyAgent,
CompetitorResponseAgent,
SEOOptimizationAgent,
SocialAmplificationAgent
)
from .trend_surfer_agent import TrendSurferAgent
from .content_gap_radar_agent import ContentGapRadarAgent
# Agent Orchestrator
from .agent_orchestrator import (
ALwrityAgentOrchestrator,
orchestration_service
)
__all__ = [
'BaseALwrityAgent',
'AgentAction',
'AgentPerformance',
'StrategyOrchestratorAgent',
'MarketSignal',
'MarketSignalDetector',
'MarketTrendAnalyzer',
'PerformanceMonitor',
'performance_monitor',
'PerformanceMetric',
'AgentPerformanceMetrics',
'ContentGuardianAgent',
'LinkGraphAgent',
'StrategyArchitectAgent',
'ContentStrategyAgent',
'CompetitorResponseAgent',
'SEOOptimizationAgent',
'SocialAmplificationAgent',
'TrendSurferAgent',
'ContentGapRadarAgent',
'ALwrityAgentOrchestrator',
'orchestration_service'
]