TelcoGPT User Manual

Introduction

TelcoGPT is an AI-powered network diagnostic assistant designed for telecommunications engineers. It combines PCAP analysis, 3GPP specification knowledge, internal documentation, and historical ticket data to help diagnose network issues quickly and accurately.

What TelcoGPT Can Do

• Analyze PCAP files to identify network issues and root causes

• Search 3GPP specifications and internal documentations

• Find similar historical tickets and their resolutions

• Perform deep packet-level root cause analysis

Interface Overview

Main Components

The TelcoGPT interface consists of several key areas:

1. Chat History Sidebar (Left)

• Displays your recent conversations

• Click any conversation to restore it and continue from where it left off

• Shows associated filename, timestamp, and active features

• Use the refresh button to reload the list

• Click Load More for older conversations

Open

Figure 1: Chat History Sidebar

2. Main Chat Area (Center)

• Displays the conversation between you and TelcoGPT

• Shows AI responses with citations and references (where applicable)

• Includes visualized steps for transparency

3. Message Input Area (Bottom)

The input area contains:

• Text input field – type your questions here

• Attachment button (paperclip icon) – attach PCAP files

• Feature toggles – enable/disable analysis modes (Some appear after attaching a file)

• Send / Generate button – submit your message or generate a summary

Open

Figure 2: Message input area with all components

4. Top Navigation Bar

• TelcoGPT logo – click to start a new conversation

• Documents button – browse 3GPP / internal documents

• View in AGILITY – open the analysis in the AGILITY (visible after a pcap or analysis is selected)

• Print button – export conversation to PDF

• New chat button – start a fresh conversation

Open

Figure 3: Top navigation bar

Core Features

File Attachment Options

Click the paperclip icon to see three options:

1. New PCAP

Upload a fresh PCAP file from your computer.

• Supported formats: .pcap, .pcapng, .cap, .zip

• Maximum file size: 50 MB

• The file will be uploaded, you may click the x icon next to the file name to remove and upload another file

Open

Figure 4: File attachment menu

2. Select an Existing Analysis

Browse previously uploaded analyses.

• Search by filename

• Filter by: All Analyses, My Analyses, Others' Analyses

• View upload date and time

• Click a row to select an analysis

Open

Figure 5: Existing analysis drawer

3. Select a Sample File

Use predefined sample files for testing or learning.

Open

Figure 6: Sample files drawer

Feature Toggles

After attaching a file, three toggle buttons appear:

Deep RCA

Enables deep root cause analysis with packet-level inspection.

When enabled, TelcoGPT:

• Examines individual packet payloads

• Extracts specific frame data

• Provides detailed technical evidence

• Thinks deeply and continues investigating by itself

Documentation

Enables 3GPP / RFC / internal documentation search.

When enabled, TelcoGPT:

• Searches telecommunications standards

• Provides error code definitions

• References specific 3GPP documents / RFC / internal documentation

Tickets

Enables historical ticket search.

When enabled, TelcoGPT:

• Finds similar past issues

• Shows resolutions and troubleshooting steps

• Returns top relevant tickets

Open

Figure 2: Message input area with all components

Documents Browser

Click the Documents button in the top bar to browse available 3GPP specifications or internal documentations.

• Search by specification number, title, or filename

• View release number and date

• Click to download any document

Open

Figure 7: Documents browser

Usage Scenarios

This section covers common ways to use TelcoGPT.

Scenario A: Upload PCAP Without a Question

What you do:

1. Click the attachment button

2. Select New PCAP and upload your file

3. Click Generate Summary (no question needed)

What happens:

• TelcoGPT automatically analyzes the entire PCAP

• Selects the most diagnostic callflow (prioritizes failures)

• Generates a comprehensive summary

What you receive:

• Subscriber Journey – a narrative describing the session (approx. 4 sentences)

• Root Cause – the primary issue identified

• Executive Summary – statistics and error counts

• Q & A with related documentation (if Documentation toggle is on)

• Similar tickets (if Tickets toggle is on)

Open

Figure 8: Summary output after PCAP upload without question

Scenario B: Upload PCAP With a Specific PCAP Troubleshooting Question

What you do:

1. Attach a PCAP file

2. Type a specific question (e.g., “What caused the PDU session to fail?”)

3. Click Send

What happens:

• TelcoGPT categorizes your question (PCAP troubleshooting question, general question, documentation question, ticket question)

• Selects relevant callflows for analysis (if relevant)

• Analyzes some packets directly (fewer than Deep RCA mode)

• Provides a targeted answer

Example questions:

• “What is the error in this trace?”

• “Why did the authentication fail?”

• “Count the failed procedures.”

• “List all subscribers in this capture.”

Open

Figure 9: PCAP analysis with specific question

Scenario C: Ask for Documentation (With PCAP)

What you do:

1. Attach a PCAP file

2. Ensure the Documentation toggle is ON

3. Ask a documentation-related question

Example questions:

• “What does error code 26 mean in 5GC?”

• “What are the 3GPP-defined causes for PDU Session failure?”

• “What parameters should be in a Registration Request?”

What happens:

• TelcoGPT extracts relevant technical context from your PCAP

• Searches 3GPP specifications / internal documentation

• Returns definitions with citations (Hover over to see file details, click to view/download file)

Open

Figure 10: Documentation answer with citation

Scenario D: Ask for Historical Tickets (With PCAP)

What you do:

1. Attach a PCAP file

2. Ensure the Tickets toggle is ON

3. Ask about similar issues

Example questions:

• “Has this issue occurred before?”

• “Are there related tickets for this error?”

• “Find similar incidents of authentication failures.”

What happens:

• TelcoGPT extracts error patterns from your PCAP

• Searches the historical ticket database

• Returns similar tickets with resolutions

Open

Figure 11: Ticket results with pcap error

Scenario E: Ask Documentation First, Then Attach PCAP

What you do:

1. Start with a documentation question (no file attached)

2. Then attach a PCAP file

3. Ask follow-up questions about your trace

What happens:

• First question: TelcoGPT searches documentation directly

• After attaching a PCAP: analysis includes your file context

• Follow-ups combine documentation knowledge with your specific data

Use case:
You want to understand a concept before analyzing your trace.

Scenario F: Question Without PCAP (Standalone)

What you do:

1. Type a question without attaching any file

2. Click Send

What happens:

• Documentation mode gets turned on.

• Searches documentation based on your question

• Whether it finds relevant documentation or not, answers your question, stating if it found supporting evidence or if it is using its knowledge

• No PCAP-specific analysis is performed

Scenario G: Follow-up Questions

What you do:

1. After receiving an initial answer, ask a follow-up

2. Reference previous context naturally

What happens:

• TelcoGPT maintains conversation context

• Understands references like “that error” or “frame 42”

• Can dive deeper into specific aspects

Scenario H: Deep Root Cause Analysis

What you do:

1. Attach a PCAP file

2. Enable the Deep RCA toggle

3. Ask about errors or failures

What happens:

• A multi-stage analysis pipeline activates:

  • Stages 1–2: Analyze callflow summaries

  • Stage 3: Decide whether packet-level inspection is needed

  • Stages 4–5: Extract and analyze raw packet data

  • Loop: goes back to Stage 3 until no more packets are needed

  • Stage 6: Synthesize findings

What you receive:

• Detailed packet-level evidence

• Exact payload contents (where available)

• Header analysis

• Root cause with frame references

Tips and Best Practices

Starting with the summary

Starting with the summary provides the overall picture to the LLM as context for follow-up questions. Just select your PCAP, don’t enter a question and press “Generate Summary”

Asking Effective Questions

Be specific:

• Instead of: “What’s wrong?”

• Try: “Why did the PDU session establishment fail?”

Reference specific elements:

• “What happened at frame 42?”

• “Explain the error in callflow 2.”

When to Use Each Mode

Understanding Limitations

• TelcoGPT analyzes what is in your PCAP; missing data cannot be inferred.

• AI responses should be verified for critical decisions.

• Deep RCA requires more processing time but provides more detail.

• Historical tickets depend on what is available in the database.

• Currently, the follow-up questions either go through documentation/ticket analysis/deep RCA/standard analysis separately. The answers are not combined. This is on the roadmap, however.

• Smaller LLMs have smaller context windows. Smaller PCAPs will give the best result, though we have multiple strategies to handle large files.

Getting Better Results

1. Start broad, then narrow down

   • Generate a summary first.

   • Ask specific follow-ups based on findings.

2. Use sample files to learn

   • Try the predefined samples to understand output formats.

3. Check citations

   • Documentation answers include references.

   • Verify important information in source documents.

Message Actions

Available Actions on Messages

Your messages:

• Copy to clipboard

AI responses:

• Copy to clipboard

• Like (thumbs up)

• Dislike with optional comment (thumbs down)

Exporting and Printing

Print to PDF

1. Click the Print button in the top navigation.

2. Select your printer or Save as PDF.

3. The conversation is formatted for printing.

View in AGILITY

If an analysis is attached, click View in AGILITY to open the full analysis in the AGILITY platform.

Quick Reference Card

Troubleshooting

Common Issues

“Analysis is still processing”

• Wait for AGILITY to complete the analysis.

• Large PCAPs take longer to process.

“No results found”

• Try rephrasing your question.

• Ensure the relevant toggle is enabled.

• Check if the PCAP contains the expected data.

This guide describes TelcoGPT as currently deployed. Features may vary based on server configuration.