frontend/src/lib/welcomeGuideConfig.ts

import { WelcomeGuideConfig } from "@/types";

export const welcomeGuideConfig: WelcomeGuideConfig = {
  title: "Welcome to AgentGraph",
  subtitle: "Your comprehensive AI agent trace analysis platform",
  sections: [
    {
      id: "overview",
      title: "Platform Overview",
      icon: "Info",
      content:
        "AgentGraph is a powerful platform designed to help you analyze AI agent behavior, build knowledge graphs, and perform comprehensive causal analysis. Transform your raw agent traces into actionable insights and visualizations.",
    },
    {
      id: "agentgraph-impact",
      title: "AgentGraph Impact",
      icon: "Star",
      content:
        "See how AgentGraph transforms complex nested agent conversations into clear visual insights with real examples from your system.",
    },
    {
      id: "getting-started",
      title: "Getting Started",
      icon: "PlayCircle",
      content:
        "Follow these simple steps to start analyzing your AI agent traces:",
      steps: [
        {
          number: 1,
          title: "Upload Your Trace",
          description:
            "Click the 'Upload Trace' button and select your trace file. We support JSON, TXT, and LOG formats.",
          tips: [
            "Ensure your trace file contains structured agent conversation data",
            "Larger files may take longer to process",
            "You can upload multiple traces for comparison",
          ],
        },
        {
          number: 2,
          title: "Generate Agent Graph",
          description:
            "Once uploaded, generate an agent graph to visualize relationships and patterns in your trace data.",
          tips: [
            "Choose the appropriate chunking strategy for your data type",
            "Agent semantic chunking works best for conversation traces",
            "Processing time depends on trace complexity",
          ],
        },
        {
          number: 3,
          title: "Analyze & Explore",
          description:
            "Explore your generated knowledge graphs, examine entity relationships, and discover insights.",
          tips: [
            "Use the search function to find specific entities",
            "Click on nodes to view detailed information",
            "Drag nodes to reorganize the visualization",
          ],
        },
        {
          number: 4,
          title: "Run Pipeline Analysis",
          description:
            "Execute advanced analysis including perturbation testing and causal analysis for deeper insights.",
          tips: [
            "Pipeline stages can be run individually or together",
            "Monitor progress in the pipeline dashboard",
            "Results are saved for future reference",
          ],
        },
      ],
    },
    {
      id: "features",
      title: "Key Features",
      icon: "Star",
      content: "Discover what makes AgentGraph powerful for AI agent analysis:",
      steps: [
        {
          number: 1,
          title: "Trace Processing",
          description:
            "Advanced text processing and semantic chunking to extract meaningful patterns from your agent traces.",
        },
        {
          number: 2,
          title: "Knowledge Graph Generation",
          description:
            "Automatically build interactive knowledge graphs showing entity relationships and dependencies.",
        },
        {
          number: 3,
          title: "Visual Analytics",
          description:
            "Interactive visualizations with zoom, pan, search, and filtering capabilities.",
        },
        {
          number: 4,
          title: "Pipeline Processing",
          description:
            "Comprehensive analysis pipeline including perturbation testing and causal analysis.",
        },
        {
          number: 5,
          title: "Export & Share",
          description:
            "Export your analysis results and visualizations for reports and presentations.",
        },
      ],
    },
    {
      id: "best-practices",
      title: "Best Practices",
      icon: "CheckCircle",
      content: "Get the most out of AgentGraph with these recommendations:",
      steps: [
        {
          number: 1,
          title: "Trace Quality",
          description:
            "Ensure your traces contain structured conversation data for best results.",
          tips: [
            "Include both user inputs and agent responses",
            "Maintain consistent formatting throughout the trace",
            "Remove any sensitive information before uploading",
          ],
        },
        {
          number: 2,
          title: "File Preparation",
          description: "Optimize your trace files for processing efficiency.",
          tips: [
            "Keep individual files under 50MB for faster processing",
            "Use descriptive filenames for easy identification",
            "Consider splitting very large traces into segments",
          ],
        },
        {
          number: 3,
          title: "Analysis Strategy",
          description:
            "Approach your analysis systematically for better insights.",
          tips: [
            "Start with overview graphs before diving into details",
            "Compare multiple traces to identify patterns",
            "Use pipeline analysis for comprehensive evaluation",
          ],
        },
      ],
    },
    {
      id: "troubleshooting",
      title: "Common Issues & Solutions",
      icon: "AlertCircle",
      content: "Quick solutions to common problems:",
      steps: [
        {
          number: 1,
          title: "Upload Issues",
          description:
            "If your trace upload fails, check file format and size limits.",
          tips: [
            "Supported formats: JSON, TXT, LOG",
            "Maximum file size: 50MB",
            "Ensure file is not corrupted",
          ],
        },
        {
          number: 2,
          title: "Processing Delays",
          description: "Large or complex traces may take time to process.",
          tips: [
            "Monitor progress in the Recent Activity section",
            "Complex traces with many entities take longer",
            "You can continue using the platform while processing",
          ],
        },
        {
          number: 3,
          title: "Visualization Performance",
          description: "Large graphs may affect browser performance.",
          tips: [
            "Use search to focus on specific entities",
            "Consider chunking large traces differently",
            "Close other browser tabs to free memory",
          ],
        },
      ],
    },
  ],
};