Unify and manage your data

Create a match rule with the AI agent

Learn how to create a match rule with the AI agent, review its test results, and deploy it to your Reltio tenant through the integrated development experience.

Use the AI agent to create a match rule from a natural language prompt. The AI agent builds the rule, tests it against your connected Reltio tenant, and adds it to your business configuration. You review the rule and deploy it.

The following roles can create a match rule with the AI agent:

Prerequisites

Before you begin, confirm the following requirements:

  • A tenant that you connected to the integrated development experience, and an active sign-in to its environment. If you work from a Git repository or are not signed in, the AI agent still creates the rule, and labels the test results as not verified against a tenant.

  • The configuration of the tenant on your computer. If the business configuration tree does not list the entity types of the tenant, select Get Configuration.

To create a match rule
  1. In Cursor or VS Code, open the AI agent.
  2. Describe the match rule in a natural language prompt.

    Include the following details:

    DetailWhat to specify
    Entity typeThe entity type that the rule applies to, for example Individual.
    AttributesThe attributes to compare, and whether each attribute matches exactly or fuzzy.
    OutcomeWhether matches go to review or merge automatically.
    Tenant IDThe tenant that the rule is for, if several tenants are connected to your workspace.
    Filters or sourcesOptional. A condition that limits the rule, for example a type of HCP, or the sources whose records the rule compares.

    The following prompts are examples:

    • Create a suspect match rule for Individual on fuzzy first name, exact last name, and exact email.

    • Match Organizations on fuzzy name and exact city or ZIP code.

    • Never merge two Organizations with different tax IDs automatically.

  3. Answer the questions of the AI agent.

    The AI agent asks only about details that it cannot find in your prompt or in your business configuration, such as an attribute name that it cannot find. Unless you specify otherwise, the AI agent uses the following defaults:

    SettingDefault
    Rule typeSuspect, so matches go to review. If your prompt mentions match scores, the AI agent builds a relevance-based rule instead.
    Values comparedOperational values only, which are the values that win under your survivorship rules.
    Comparator and Token ClassesThe comparator/token classes that Reltio recommends for the kind of attribute, for example DoubleMetaphoneMatchToken and DoubleMetaphoneComparator for Individual names.
    First-name synonymsTurned on for approximate first-name matching, so that Bob matches Robert.
  4. Review the rule and the test results that the AI agent shows.

    The AI agent shows a description of the rule, the test records with the expected and actual result for each pair, and any notes, for example that a rule on names alone might merge different people. The heading of the results states how the AI agent obtained them:

    StatusMeaning
    Verified against environment/tenantYour connected Reltio tenant ran the tests. The results show how Reltio matches the records.
    Not verified against a tenantThe tests did not run against a Reltio tenant. The AI agent shows the results that it expects and states the reason.
  5. If the results are not what you expect, tell the AI agent what to change.

    The AI agent adjusts the rule and tests it again. When the results are what you expect, the AI agent adds the rule to the entity type in Business Config/BusinessConfig.json.

  6. Open Business Config/BusinessConfig.json and review the new rule in the match rules of the entity type.

    To change the rule, for example its scope or its type, edit it in the file or ask the AI agent to change it.

    Figure 1. New match rule in BusinessConfig.json
  7. Deploy the rule. Do one of the following:
    • To deploy the rule, in the business configuration tree of the extension view, right-click the tenant and select Apply Configuration to Tenant.

    • To deploy the rule through Git, commit the change on a feature branch, and then promote the change.

Verification steps

To confirm that the AI agent added the rule, check that the rule appears in the match rules of the entity type in Business Config/BusinessConfig.json. To confirm the deployment, check that the configuration of the tenant contains the rule after you apply it.

If a step fails, see Troubleshoot AI-assisted match rules.