Create custom semantic type with Gio™ AI Assistant - Precisely Data Integrity Suite

Data Integrity Suite

Product
Spatial_Analytics
Data_Integration
Data_Enrichment
Data_Governance
Precisely_Data_Integrity_Suite
geo_addressing_1
Data_Observability
Data_Quality
dis_core_foundation
Services
Spatial Analytics
Data Integration
Data Enrichment
Data Governance
Geo Addressing
Data Observability
Data Quality
Core Foundation
ft:title
Data Integrity Suite
ft:locale
en-US
PublicationType
pt_product_guide
copyrightfirst
2000
copyrightlast
2026

Use Gio™ AI Assistant to create custom semantic types by describing them in natural language. Gio™ generates production-ready configurations, checks for duplicates, and lets you refine the result through iterative chat before creation.

Note: Before you start, verify that your workspace has the Semantic Type AI preference enabled and that you have permission to create semantic types. Contact your administrator if you're unsure. If these conditions aren't met, the Gio™ AI Assistant panel won't appear on the Semantic Types list page.
Preview: This feature is currently in Preview for select workspaces and might be subject to change before general availability.
  1. Go to Configuration > Catalog > Semantic Types.
  2. In the Semantic Types list page header, click the Gio™ AI Assistant icon.
    The Gio™ AI Assistant chat panel opens on the right side of the screen with a greeting and conversation starters.
  3. Click a conversation starter or type your own description of the semantic type you want to create.

    Include in your description:

    • Required: A clear description of what the semantic type represents (for example, "A 2-letter country code compliant with ISO 3166 standards").
    • Optional: Data patterns, valid examples, invalid examples, header patterns, or specific threshold requirements.
    Tip: Be specific about what data your semantic type represents. Provide valid and invalid examples to help Gio™ AI Assistant understand edge cases and boundary conditions. Include context in naming (for example, "Country (ISO 3166)" instead of just "Country").
  4. Wait for Gio™ AI Assistant to analyze your description and search for similar existing semantic types.
    An "Analyzing..." indicator displays while processing. This typically takes a few seconds.
  5. Review the results.
    • If Gio™ AI Assistant finds similar existing semantic types: It displays matching types with their name, qualifier, and description. You can:
      • Use the existing semantic type if its name, description, and examples match your needs exactly.
      • Ask Gio™ AI Assistant for more details about the existing type.
      • Refine your request and ask Gio™ AI Assistant to generate a new type if your organization has specific requirements that differ from the existing type (for example, different regex patterns or threshold values).
    • If no similar types exist: Gio™ AI Assistant generates a new semantic type configuration and displays it in the chat panel, including name, qualifier, description, valid data examples, and invalid data examples.
  6. Review the generated configuration and send follow-up messages to Gio™ AI Assistant if you want to refine it.

    Gio™ AI Assistant maintains context across multiple chat turns, so you don't need to repeat your original description. Keep refining until you're satisfied with all configuration fields.

    Examples of refinement requests:

    • "Change the priority to 50"
    • "Make the regex pattern more flexible"
    • "Add these examples: [example1, example2]"
    • "Use a list of values instead of a regex"
    • "Lower the threshold to 80%"
    • "Adjust the header pattern to match 'col_*' naming"

    Understanding configuration fields:

    Table 1. Semantic type configuration fields
    Field Description
    Name Human-readable display name for the semantic type.
    Qualifier Unique machine-readable identifier (immutable after creation; follows pattern [A-Z][A-Z0-9_.<>-]*). If a conflict occurs, the system automatically modifies it by appending a number, or you can ask Gio™ to use a different qualifier during refinement.
    Description Explains what the semantic type represents (maximum 4000 characters).
    Base Type Underlying data type (typically STRING, INTEGER, or NUMERIC).
    Match Type Either "Regex pattern" (for pattern based matching) or "List" (for enumeration based matching).
    Data Regex Pattern Matches valid data values (used if Match Type = Regex).
    Data Values List Predefined list of valid values (used if Match Type = List).
    Header Regex Pattern Matches column header names.
    Priority Determines detection order (lower numbers = higher priority; range 0–2500).
    Threshold Percentage of valid values required to apply the semantic type (range 0–100; default 90).
    Valid/Invalid Data Examples Sample values for training and validation.
    Valid/Invalid Header Examples Sample column names.

    Refinement guidance:

    • Regex patterns: If Gio™ AI Assistant's generated regex is too strict or too loose, ask it to adjust.
    • Priority and threshold: Use lower priority for more specific types and higher priority for general types. Adjust threshold for stricter or more lenient matching.
    • Match type: Use regex patterns for data with predictable structure (email addresses, phone numbers, postal codes) or large sets of values that follow a pattern. Use lists for enumerated values with a fixed set of options (country codes, language codes, status values) or small sets of valid values (typically fewer than 100).
    • Header patterns: If the auto-generated header regex doesn't match your column naming conventions, describe your naming patterns to Gio™ AI Assistant and ask it to adjust.
  7. Click the Create semantic type button in the Gio™ AI Assistant panel.
    Gio™ AI Assistant submits the semantic type to your workspace. If the qualifier conflicts with an existing one, the system automatically modifies it to ensure uniqueness.
  8. Wait for the confirmation message.
    Gio™ AI Assistant displays a success message. Your semantic type is now available in your workspace.

Your custom semantic type is now available in your workspace. It appears in the Semantic Types list, you can assign it to fields during profiling or manual classification, and it receives higher detection priority in subsequent profiling runs.

After creation, you can:

  • View, edit, or delete it from the Semantic Types list page (find it under "Custom" source).
  • Create additional custom semantic types using Gio™ AI Assistant.
  • Test the semantic type on a few fields to verify it matches your expectations before rolling it out widely.

Error handling:

  • Gio panel not visible: The "Semantic Type" AI preference may not be enabled for your workspace, your workspace may not have a valid AWS Bedrock connection configured, or you may not have permission to create semantic types. Contact your workspace administrator to verify these prerequisites are met.
  • Existing type found: Use the existing type if its name, description, and examples match your needs exactly. Create a new type if your organization has specific requirements that differ from the existing type.
  • Threshold vs. Priority: Threshold is the percentage of field values that must match the semantic type pattern. Priority is the order in which semantic types are evaluated during detection (lower numbers = higher priority).