Vadym/obsidian
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
obsidian/01 Projects/modcomms/USER_MANUAL.md
Vadym Samoilenko 33a6a35dc6 vault backup: 2026-05-19 12:10:19
2026-05-19 12:10:19 +01:00

3.8 KiB
Raw Permalink Blame History

auto_generated created manual_updated_at modified name status tags type
true 2026-05-19 2026-05-19 2026-05-19 User_Manual active
domain/ai
tech/azure-ad
tech/fastapi
tech/postgresql
tech/rag
type/sop
sop

Mod Comms User Manual

What This Tool Does

Mod Comms is an AI-powered proof review tool designed for Barclays marketing materials. It utilizes a multi-agent AI system to analyze uploaded marketing assets for:

  • Legal Compliance: Ensures adherence to advertising standards and detects financial promotions.
  • Brand Adherence: Checks logo usage, color palettes, and visual identity.
  • Tone of Voice: Analyzes clarity and voice consistency.
  • Channel Suitability: Verifies platform-specific specifications.

The tool provides a RAG status (Red, Amber, Green) for each agent, with detailed feedback, synthesized by a Lead Agent into a final verdict. It also offers real-time feedback via WebSocket streaming, campaign management, and PDF export capabilities.

Who Uses It

  • Marketing Teams: For submitting marketing assets for compliance and brand checks.
  • Legal & Brand Teams: For reviewing flagged issues and resolutions.
  • WIP Reviewers: For getting early-stage creative feedback on work-in-progress assets.

How to Access

  1. Log In: Access the application via the provided web interface. Authentication is handled via Azure AD. For development, auth can be disabled by setting DISABLE_AUTH=true.
  2. Navigate: Use the dashboard to view analytics, campaign lists, and audit trails.
  3. Upload: Select a campaign or create a new one to upload proof assets (PDFs, images, etc.).

Main Workflows

Workflow 1: Submitting a Proof for Analysis

  1. Navigate to Campaigns: Go to the "Campaigns" section or create a new campaign.
  2. Upload Asset: Click "Add Proof" and upload your marketing asset.
  3. Initiate Analysis: The system will automatically start the multi-agent analysis in parallel.
  4. Monitor Progress: Watch the real-time WebSocket stream for live updates from the Legal, Brand, Tone, and Channel agents.
  5. Review Verdict: Once complete, review the synthesized final verdict and detailed feedback from each agent.
  6. Export Report: Click "Export PDF" to generate a professional report of the analysis results.

Workflow 2: Managing Campaigns and Versions

  1. Create Campaign: From the dashboard, click "New Campaign" to organize proofs.
  2. Upload Versions: Upload multiple versions of proofs to the same campaign for version history tracking.
  3. Compare Results: Use the campaign view to compare analysis results across different versions.

Workflow 3: Reviewing WIP Assets

  1. Select WIP: Identify a work-in-progress asset.
  2. Request Early Feedback: Use the WIP Reviewer feature to get preliminary feedback before final submission.

FAQ

Q: What file types are supported? A: The tool primarily supports PDFs for detailed analysis, but other asset types may be supported depending on the specific agent capabilities.

Q: How long does the analysis take? A: Analysis time varies based on asset complexity and content, but real-time WebSocket updates provide progress indicators.

Q: Can I override the AI's verdict? A: Yes, users can flag items and add resolution notes, contributing to the audit trail. However, the AI provides the initial RAG status and feedback.

Q: Is my data secure? A: Yes, the system integrates with Azure AD for authentication and stores data in a secure PostgreSQL database. File storage is isolated.

Q: How do I get support? A: Contact support at BAICsupport@oliver.agency if you encounter issues.

Related