Running the AI Agent

Go Back to Main Knowledgebase

Navigate to the AI Link Suggestions page (accessible from the Linkilo menu or the main reports page). Here’s how to use it:

Configuration Options

Setting	Default	Description
Max Posts to Process	10	How many posts to analyze per session (1–1,000)
Max Suggestions per Post	10	Maximum link suggestions generated per post (1–50)
Minimum Confidence Level	30%	Only show suggestions above this confidence score (20–80%)
Post Types	Posts checked	Which content types to include (Posts, Pages)
Categories	All	Filter to specific categories or exclude certain ones
Exclude Recently Processed	Unchecked	Skip posts that were already analyzed recently

Starting Processing

1. Configure your settings (or use defaults).
2. Click “Start AI Agent Processing” (the blue rocket button).
3. Watch the progress bar as each post is analyzed.
4. When complete, suggestions appear in the results table below.

 

Understanding Confidence Scores

Each AI suggestion includes a confidence percentage representing how strongly the AI believes the link is relevant:

Confidence	Meaning	Recommendation
70–100%	High confidence	These are strong matches. Review and apply liberally.
50–69%	Medium confidence	Good suggestions worth reviewing. May need editorial judgment.
30–49%	Lower confidence	Consider carefully. The topical connection exists but may be weaker.
Below 30%	Low confidence	Filtered out by default. Adjust minimum confidence to see these.

How AI Scoring Works

The AI agent scores suggestions using multiple signals:

• Semantic Relevance (30%): How closely the content topics align, measured by embedding similarity.
• Keyword Cannibalization (15%): Whether linking would create or worsen keyword conflicts.
• GSC Performance (15%): Real search performance data from Google Search Console, if connected.
• Link Equity Distribution (12%): Whether the target page needs more internal links.
• User Engagement (12%): Expected visitor interest based on content patterns.
• Content Freshness (8%): Newer content may be boosted slightly.
• Match Type Bonus (8%): Sentence-level keyword matches receive the highest bonus.

Applying, Rejecting, and Batch Actions

For each suggestion:

• Apply: Inserts the link directly into your post content with the suggested anchor text.
• Reject: Dismisses the suggestion permanently. Rejected suggestions will not reappear in future sessions.
• Rejection Feedback: Optionally provide a reason (wrong category, poor contextual fit, keyword belongs elsewhere) to help the AI learn your preferences.

Debug Mode

Enable the Debug Mode checkbox to see detailed logs of how the AI is analyzing content, generating keywords, and scoring suggestions. This is useful for understanding why certain suggestions appear (or don’t appear) and for troubleshooting.