Understand link types and AI assessments

Link type helps you organize saved links and see what the page evidence says about them. The Links table shows one type by default. You can open Compare with AI when you want to see your team’s choice beside the page assessment. You do not need to choose a model provider or configure a provider budget. A one-off local check returns link evidence without assigning a type or tags.

What appears in Link type

Your team’s saved setting controls the display:

Your saved setting	What Link type shows
Your team chose a type	That choice, with who set it.
Your team deliberately cleared the type	No type. The saved page assessment does not fill it back in.
Your team has no override	The available page assessment, with its source and evidence state, or a reason no type is available.

An assessment can describe current or previous page evidence. Previous assessment describes saved evidence that is no longer confirmed current. Check its date and reason before relying on it.

Why two types can both be right

Choose Compare with AI above the table to show two columns:

Chosen type	AI page assessment	How to read it
Guest post	Author credit or bio	Your team contributed the article; the link appears in its author bio.
No type, cleared by your team	Directory listing	The deliberate clear keeps the everyday Link type empty. The assessment remains available for comparison.
No team choice	Mixed types	The page has Profile link and Recommendation roles. Open its evidence to inspect the matching links.

These rows are illustrative. Chosen type records how your team describes a placement. AI page assessment describes matching links found in saved page evidence. A difference alone does not mean either description is wrong.

Comparison columns show a Guest post team choice beside an Author credit or bio AI assessment. — The Guest post choice describes the placement. Author credit or bio describes where the link appears. Example data.

Tags are separate colored labels for organization, such as autumn-campaign or a client name. They do not change the link type or the page assessment.

Change your team’s choice

If you can edit links, open a saved link’s details to choose a type or change its tags.

Action	Result
Choose a type	Save a team choice that takes precedence in Link type.
Clear type	Keep Link type empty until your team changes that setting.
Use AI again	Remove the team override and use the existing page assessment when one is available.

Use AI again does not run a new classification. It also does not approve a suggestion. If no assessment is available, the table still explains why a type is missing.

Read the evidence state

Open the link’s details to inspect the evidence date, assessment coverage and any reason a result is missing.

State	What it tells you
Not classified yet	No classification result has been recorded for the eligible page evidence. It does not mean work is queued.
Classifying	Classification work is pending. It has not produced a completed result.
Classification unavailable	The assessment could not be read. It does not establish that no classification exists.
Page unavailable or an inconclusive page check	The latest attempt could not establish the page contents. Older saved evidence may still exist.
Previous assessment	A retained assessment describes older evidence. A newer check may have changed, missed or been unable to confirm the page, or the saved evidence may have expired or become unavailable.
No page role determined	Recorded classification work has not supplied a role. A completed assessment can still leave the type unknown.

The source matters too: AI suggested is provisional; Reviewed has a recorded manual review; AI classified means AgentLinkOps accepted that assessment automatically. Reading any of these states does not approve a suggestion or start classification. A page can contain several matching links. Mixed types means they have different assessed roles. 2 of 5 have types means three eligible occurrences still lack a type. Assessment coverage and type coverage can differ: an assessed occurrence can remain unclassified.

See evidence for several matching links

Link details show two page roles, nine assessed occurrences, and current page evidence. — Example data: one saved placement has several matching links on its page, with two assessed roles.

Keep monitoring status separate

Paused means scheduled monitoring is paused for that saved link. It preserves classifications, team choices and tags. It does not tell you whether classification work is running or whether an assessment is current. Read monitoring and evidence history for the latest check and its date.

Read types with an agent or the API

Saved-link reads and exports use category_contract: "link-category-v1":

Field	Use it for
`chosen_category`	The team’s `chosen`, `cleared` or `automatic` display setting and its write revision.
`page_assessment`	Assessed roles, review state, evidence dates, currentness and coverage.
`display_category`	The resolved everyday Link type, its source and why it is shown.

These fields remain separate in concise and detailed results. Reading them does not fetch a page, run classification or change a choice. Legacy type and type_source fields are compatibility values; use the category contract to interpret the table.

Filter saved categories and change a team choice

Read from your connected workspace. This example finds a current Profile link role, including one within Mixed types:

npx -y agentlinkops call list_link_watches \
  --args '{"projectId":"YOUR_PROJECT_ID","category":"profile_website","categoryScope":"page_role","assessmentScope":"current","format":"detailed"}'

Replace the project ID. The read requires watches:read. When setting a scope, supply category or categoryState.

Filter	Scope
`categoryScope: "shown"`	The resolved displayed category. Team choices and deliberate clears take precedence.
`categoryScope: "page_role"`	Any assessed occurrence role, even when the display uses a team choice or Mixed types. Guest post is a team choice, not an AI page role.
`assessmentScope: "current"`	Current assessments; this is the default. With shown scope, team choices can also match.
`assessmentScope: "previous"`	Previous page assessments. With shown scope and a supplied `category`, this selects displayed previous AI evidence. Team choices are excluded from that category filter.

Filters apply before counting and pagination. Reading previous evidence does not refresh it. The legacy type filter retains its compatibility scope.Use set_link_type to choose a type, deliberately clear it with type: null, or return to AI display with intent: "automatic" and the current chosen_category.revision. A stale revision requires a fresh read before retrying. Tag operations organize links independently.See saved-link fields and filters for the full contract and availability for release boundaries.

Get started

Connect

Workflows

Understand and troubleshoot

Understand link types and AI assessments

What appears in Link type

Why two types can both be right

Change your team’s choice

Read the evidence state

Keep monitoring status separate

Read types with an agent or the API

​What appears in Link type

​Why two types can both be right

​Change your team’s choice

​Read the evidence state

​Keep monitoring status separate

​Read types with an agent or the API

What appears in Link type

Why two types can both be right

Change your team’s choice

Read the evidence state

Keep monitoring status separate

Read types with an agent or the API