Sophyx
Sophyx
Documentation

How to use Sophyx

Everything you need to improve your brand's visibility in AI-powered search engines. From knowledge graphs to GEO scoring and agentic content strategy.

01

Getting Started

Create your account

Sign up at app.sophyx.io/signup. Your free plan includes 120 credits — enough to run a full brand analysis and explore the platform.

Sign up free

Run a Free Brand Analysis

Before creating a workspace, use our free Brand Analysis tool to instantly see how AI engines like ChatGPT, Gemini, and Perplexity currently perceive your brand. No account required.

Try free analysis

Create your first Brand Workspace

A workspace represents one brand or website. Enter your brand name and root URL. Sophyx will crawl your site and build your knowledge graph automatically.

Assign a subscription to your workspace

Credits are allocated per workspace. Assign a plan from the Billing tab in workspace settings to unlock full analysis capabilities.

View pricing
02

Knowledge Graph Builder

What is a Knowledge Graph?

A knowledge graph maps all the entities, topics, products, services, and relationships that define your brand. AI engines use these semantic networks to understand and cite your brand accurately.

Building your KG

From your workspace's home page, click "Build Knowledge Graph". Sophyx crawls up to 20+ pages of your site, extracts entities and relationships, and constructs a visual graph you can explore.

Exploring the graph

Use the interactive graph viewer to see nodes (entities like products, services, locations) and edges (relationships between them). This is the foundation AI engines use to understand your brand.

KG Analysis

After building the KG, run a KG Analysis to get a detailed AI-powered breakdown of your brand's entity coverage, gaps, and recommendations for improving your semantic footprint.

03

AI Visibility Analysis

What is AI Visibility Analysis?

Sophyx queries multiple AI engines (GPT-4o, Gemini, Claude, Perplexity) with prompts relevant to your industry and measures how often and how prominently your brand appears in the responses.

GEO Visibility Score

Your GEO score (0–100) is a composite metric measuring how well your brand is cited across AI engines. A score of 70+ means strong AI presence; below 40 indicates significant optimization opportunity.

Running a full analysis

Click "Run Full Analysis" from your workspace home. The system tests 30+ prompts across multiple AI providers and generates a comprehensive report with your visibility score, citation examples, and content gaps.

Reading your analysis report

The analysis report shows: overall GEO score, per-provider scores, which prompts triggered brand mentions, which didn't (content gaps), and AI-generated recommendations for each gap.

04

Prompt Analysis

What is Prompt Analysis?

Prompt Analysis tests specific search queries against AI engines to see if your brand is mentioned. It's the most granular way to understand exactly which queries you're winning and losing.

Running a single prompt

From the Prompt Analysis section, enter any query (e.g., "best CRM for small businesses") and Sophyx will query multiple AI engines and show you exactly what they say — and whether your brand appears.

Bulk prompt analysis

Run all your workspace's tracked prompts at once to get a comprehensive view of your AI search coverage. Results are stored historically so you can track improvement over time.

Identifying bad prompts

Prompts where your brand doesn't appear are flagged as "bad prompts" — these are your biggest opportunities. Sophyx automatically generates content strategies to address each one.

05

Agentic Strategy & Tasks

What is the Agentic Strategy?

The Agentic Strategy system automatically generates a prioritized task board based on your analysis results. Each task is a specific, actionable step to improve your AI visibility.

Generating your strategy

After running an analysis, click "Generate Strategy" to have Sophyx's AI create a multi-step action plan. Tasks are categorized as content tasks (blog posts, FAQs) or non-content tasks (research, outreach).

Managing tasks

Tasks have priorities (high/medium/low), statuses (todo/in-progress/done), and due dates. Team members can be assigned tasks and leave comments. Track your progress on the strategy board.

Content task descriptions

Content tasks include AI-generated prompts you can use directly with any AI writing tool to create the exact content needed to improve your visibility for that specific query.

06

Reports & Analytics

Workspace Reports

Each workspace has a dedicated reports page showing your GEO score over time, prompt analysis history, credit usage, and content gap trends. Download PDF reports for stakeholder presentations.

Generic Reports (Multi-workspace)

If you manage multiple brands, the generic reports page aggregates data across all your workspaces. Filter by workspace, time period, and metric type.

PDF Export

Generate professional PDF reports with your brand logo and business name at the top. Reports include executive summary cards, trend charts, and detailed data tables.

Historical tracking

Sophyx stores all analysis results historically. Track your GEO score improvement week-over-week and month-over-month to demonstrate ROI from your AI visibility efforts.

07

Team & Workspace Management

Inviting team members

From Workspace Settings → Team tab, enter a colleague's email to add them as a member. Members get full access to run analyses, view reports, and manage tasks. They must have a Sophyx account first.

Invite colleagues

Member permissions

Members can run all workspace functions: knowledge graph building, AI analysis, prompt analysis, strategy generation, and task management. Only the workspace owner can manage billing and archive the workspace.

Multiple workspaces

Create separate workspaces for each brand or client you manage. Each workspace has its own knowledge graph, analysis history, and strategy board. Credits are assigned per workspace.

Workspace settings

Configure your workspace's root URL, crawl depth, analysis depth, and custom OpenAI API key (for teams with their own API access). Archive workspaces you're no longer actively optimizing.

08

Profile & Business Settings

User and Business profile

In Profile Settings → User and Business tab, add your business name, logo, contact info, and address. Your logo and business name appear on exported PDF reports.

Logo upload

Upload your brand logo (PNG, JPG, or WebP). It's stored securely in Sophyx's cloud storage and used to brand your exported reports professionally.

Subscription management

View and manage your active subscriptions from Profile Settings → Subscriptions. Upgrade, downgrade, or cancel plans. Credits are automatically allocated to assigned workspaces each billing cycle.

Password and notifications

Update your password and configure email notification preferences from the respective tabs in Profile Settings.

Glossary

GEO
Generative Engine Optimization — optimizing content to be cited by AI engines like ChatGPT, Gemini, and Claude.
AEO
Answer Engine Optimization — structuring content to be selected as the direct answer by AI-powered search engines and voice assistants.
Knowledge Graph
A semantic network of entities and relationships that AI models use to understand your brand's structure and authority.
GEO Score
A 0–100 composite score measuring how frequently and prominently AI engines cite your brand across multiple providers.
Prompt Analysis
Testing specific search queries against AI engines to measure whether your brand appears in the generated responses.
Content Gap
A query or topic where your brand should appear in AI responses but currently doesn't — your biggest optimization opportunity.
Agentic Strategy
An AI-generated prioritized task board with specific content and non-content actions to systematically improve your GEO score.
Credits
The currency used within Sophyx to run analyses. Each action (KG build, analysis, prompt test) costs a defined number of credits.
Multi-provider Analysis
Testing your brand visibility across multiple AI engines simultaneously — GPT-4o, Gemini, Claude, Perplexity — for comprehensive coverage.

Ready to improve your AI visibility?

Start with a free brand analysis — no account required. See exactly how AI engines perceive your brand today.