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

Configure your settings (or use defaults).
Click “Start AI Agent Processing” (the blue rocket button).
Watch the progress bar as each post is analyzed.
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.

Common Questions

Q: I clicked Run Now and got 92 suggestions. If I reject all of them, will I get 92 more?

No. The AI doesn’t have a backup pile. You get one shot per post per run. If you reject everything, the system reads that as “user doesn’t want links here right now.” To get fresh suggestions for the same posts:

Add new target keywords to the source post or the target post
Run again with a different Max Suggestions per Post setting (default 10)
Lower the Min Confidence threshold (default 30% — try 20% if your site is small)

Q: I processed 10 posts. When does the next batch run?

It doesn’t run automatically — unless Autopilot is on. To process another 10 posts manually, click Run Now again. By default the bulk processor doesn’t repeat posts it already analyzed in the last 24 hours, so the second click usually moves on to the next 10 unprocessed posts.

If you want to process your entire site in one go, set Max Posts to Process to your total post count (e.g., 100, 500). The processor handles arbitrary batch sizes; it just takes longer.

Q: Are these all the link suggestions for my whole site?

No. The number you see after a Run Now is for the source posts in that batch only. Each post can have up to N outbound link suggestions (where N is your Max Suggestions per Post). Across the entire site, you could end up with hundreds or thousands of stored suggestions if every post has been processed.

Q: My dashboard still shows old anchor texts that look weird. Is the data cached?

It’s not browser cache — those are real database rows from earlier runs. When you process new posts, the system only refreshes those specific source posts. Older posts that aren’t in the latest batch keep their existing suggestions.

If you’ve recently upgraded Linkilo and the new version has improved anchor selection, click Clear All Suggestions on the dashboard to wipe everything and start fresh. Your next bulk run will produce clean output using the new logic.

Q: How does Autopilot work?

Autopilot uses WordPress’s built-in cron system to run bulk processing in the background on a schedule. When you turn it on:

It uses the same settings (Max Posts, Max Suggestions, Min Confidence, etc.) that you have configured for manual runs
It paces itself based on your site’s size — small sites every few hours, large sites less often
You’ll see fresh suggestions appear in the dashboard the next time you check, without having to click Run Now

For Autopilot to work properly, your hosting needs to have WordPress cron functional. To verify Autopilot is firing, install the free WP Crontrol plugin and look for linkilo_adaptive_sweep in the scheduled events list.

Q: What’s the difference between AI Suggestions and the legacy “Link Articles” suggestions?

AI Suggestions (the modern engine) uses semantic similarity, target keywords, topic clusters, and other intelligent signals. Suggestions are highly contextual.
Legacy outbound links uses simple keyword matching. It looks for phrases that exist in both your source post and another post’s title, and suggests linking them.

Q: Why are anchor texts sometimes single words and sometimes multi-word phrases?

The AI tries to find the best anchor available, in this order:

The full target keyword (highest precision)
A specific multi-word sub-phrase from the target’s keywords
A multi-word sub-phrase from the target’s title
A single subject-noun word as a last resort

Troubleshooting

Issue: “0 link suggestions found” after running bulk

Try this in order:

Make sure your OpenAI API key is configured (Linkilo → Settings → AI Settings)
Verify at least a few posts have target keywords defined
Lower Min Confidence from 0.3 to 0.2
Uncheck “Exclude Recently Processed Posts” and run again

Issue: Bulk processor stops mid-run, only completed some posts

Try this:

Lower Max Posts per run (e.g., 25 instead of 100). Smaller batches are less likely to time out.
Make sure your hosting has at least 256MB PHP memory limit.
Check your hosting’s PHP execution time limit (Linkilo prefers 60+ seconds).

Advanced Settings Cheat Sheet

Setting	What It Does	Default	When to Change
Max Posts to Process	How many source posts each run handles	10	Increase to process more; decrease if host times out
Max Suggestions per Post	Cap on outbound suggestions per source post	10	Lower for top matches; raise for sprawling sites
Min Confidence	Quality threshold for keeping a suggestion	0.3	Lower to 0.2 for more suggestions; raise to 0.4 for strict matches

Glossary

Anchor text — The actual words that become a clickable link.
Confidence score — A 0-100% rating of how good Linkilo thinks a suggestion is.
Money Page — A high-revenue page (affiliate, product, lead-gen).
Source post — The post where the link will be added.
Target post — The post the link will point to.

When to Contact Support

Reach out if:

Bulk processing crashes with a 500 error every time
The dashboard shows the same suggestion duplicated many times
Anchor text contains HTML tags or looks corrupted

When you contact support, please include your Linkilo version, WordPress version, and hosting provider.