Troubleshoot AI-assisted match rules
Learn how to resolve problems that occur when you create match rules with the AI agent in the integrated development experience.
This topic describes problems that you can encounter when you create a match rule with the AI agent, and how to fix them. Each section starts with the problem that you see, and then explains what it means, why it occurs, and how to fix it.
The AI agent reports that a Reltio skill is missing
Error: The AI agent states that a Reltio skill is missing and does not create the rule.
What this error means
The AI agent cannot find the Reltio skill for match rules in your workspace.
Why the error occurs
The Reltio skills are not installed in the workspace, or the Reltio: Install Agent Skills setting is turned off.
How to fix the issue
-
In the settings of your editor, check that Reltio: Install Agent Skills is turned on.
-
Open the Command Palette and run Reltio: Resync agent assets (skills, Velocity Packs & LCA knowledge base).
-
Start a new chat and describe the rule again.
A Reltio skill cannot be installed
Error: A warning states that a folder already exists and is not managed by Reltio IDE.
What this error means
The integrated development experience cannot install a Reltio skill, because a folder with the same name already exists in your workspace.
Why the error occurs
You or another tool created a folder with the same name as a Reltio skill. The integrated development experience does not change folders that it did not create.
How to fix the issue
-
Rename or remove the folder that the warning names.
-
Open the Command Palette and run Reltio: Resync agent assets (skills, Velocity Packs & LCA knowledge base).
Preventive measures
Do not create folders with the same names as Reltio skills.
Test results are not verified against a Reltio tenant
Error: The test results show the status Not verified against a tenant, and you expected verified results.
What this error means
The tests did not run against a Reltio tenant. The AI agent shows the results that it expects, not the results of your Reltio tenant.
Why the error occurs
You are not signed in to the environment, the configuration that you edit does not belong to a connected Reltio tenant, for example because you opened it from a Git repository, or the Reltio: Enable Match Verification setting is turned off.
How to fix the issue
-
In the business configuration tree of the Reltio IDE extension view, sign in to the environment.
-
Make sure that the configuration that you edit belongs to a connected Reltio tenant.
-
In the settings of your editor, check that Reltio: Enable Match Verification is turned on.
-
Ask the AI agent to test the rule again.
The test fails with a message from the Reltio tenant
Error: The AI agent reports that the Reltio tenant rejected the test, and does not add the rule.
What this error means
The Reltio tenant did not run the test pairs, so the AI agent has no verified results for the rule.
Why the error occurs
An attribute or a source in the rule or in the test records does not exist in the Reltio tenant.
How to fix the issue
Review the correction that the AI agent suggests, and let it fix the rule and test it again.
The AI agent does not use the Reltio skill
Error: The AI agent creates a match rule without asking about missing details or testing the rule.
What this error means
The AI agent did not load the Reltio skill for match rules for your request.
How to fix the issue
-
Mention match rules in your prompt, for example
Create a match rule for Individual…. -
If the AI agent still does not use the skill, open the Command Palette and run Reltio: Resync agent assets (skills, Velocity Packs & LCA knowledge base).
-
Start a new chat, so that the AI agent loads the skills again.