File size: 6,693 Bytes
c2ea5ed
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
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",
          ],
        },
      ],
    },
  ],
};