For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Logo
DeveloperAcademyCommunityStatus
ReferenceGuides
ReferenceGuides
  • Agent Studio
    • Overview
    • Quickstart Guides
    • Core Concepts
    • Conversation Process
    • Actions
    • Connectors
    • System Triggers
    • Agent Architect
    • Cookbooks
    • Development and Testing
    • AI Agent Marketplace
    • Developer Tools
  • Agentic AI
    • LLM Fundamentals
    • The Agentic Reasoning Engine
    • Memory Constructs
    • Conversational Context
    • Guardrails
    • Grounding and Hallucinations
    • Continuous Learning
    • LLMs & SLMs
    • Steerability Tools
    • Multilingual Support
  • Core Platform
    • User Identity
    • Moveworks Agent (On-Prem)
    • Approvals Engine
    • Entity Catalog
      • Configuring Custom Entities
      • How To Guide for Entity Catalog
    • Moveworks Data Objects
    • Security Information and Event Management (SIEM) Logs Overview
DeveloperAcademyCommunityStatus
On this page
  • Entity Configuration Guide
  • Understanding Key Configurations
  • View Software Entities
  • Search Software Entities
  • Create Software Entities
  • Modify Software Entities
  • Where to Utilize Software Entities?
Core PlatformEntity Catalog

Configuring Custom Entities

||View as Markdown|
Was this page helpful?
Edit this page
Previous

How To Guide for Entity Catalog

Next
Built with

Entity Configuration Guide

In the home screen of Entity Catalog, you can see a list of already configured softwares entities. Clicking on Create or Edit will open the configuration screen for creating new custom software entities. Let’s understand what these configs mean.

Understanding Key Configurations

Term

Definition

Example

Title (Not editable)

Preferred entity name shown to users

Zoom, Figma, Loom, Notion, and more

Canonical Name

Moveworks ID

ServiceNow Service Catalog → servicenow_service_catalog

WebAssembly → webassembly

Dolby.com → dolby_com

Canonical name is snake case with spaces converted to ‘_’ underscores

Description

A brief description of the entity shown to users

“Zoom unifies cloud video conferencing, simple online meetings, and cross platform group chat into one easy-to-use platform.”

Entity Type (Not editable)

Classify entities according to different use cases

Software Applications

Aliases

Alternate names for an entity

zoom, zoom video, & zoom pro would be the aliases for Zoom, the video conferencing software

Exact matching logic

Matches a word or phrase exactly

zoom pro would always match with zoom entity in EC

Fuzzy matching logic

Match a word or phrase to within a certain edit distance

zooom (intentional spelling mistake) would try to match with zoom entity in EC.

By default, this option will be selected for aliases

Negative aliases

Prevents matches against a word or phrase that would otherwise match

loom & moom entities would be negative aliases for Zoom video conferencing software since those two are different apps with very similar names

Important Note
  • Entity Title is also the primary alias. It is not editable once entities are created
  • Currently, Entity Type Software Application is selected by default and is not editable

View Software Entities

  1. Navigate to Moveworks Setup > Core Platform section > Entity Catalog screen to view custom software entities

  2. The screen will display entity information with Entity Name, Canonical Name, and Description, with an Edit button


Search Software Entities

  1. Navigate to Moveworks Setup > Core Platform section > Entity Catalog screen to view custom software entities

  2. Click on search bar and search for entity such as zoom – the search string will get matched on entity name, canonical name or description


Create Software Entities

  1. Search whether the software entity already exists Moveworks Setup > Access Software > Software Catalog > Software/Application Name

  2. If the desired entity is not found, Navigate to Entity Catalog, click on Create New button

  3. Fill in all required the fields

    FieldValue
    TitleZoom
    Short DescriptionZoom unifies cloud video conferencing, simple online meetings, and cross platform group chat into one easy-to-use platform.
    Entity TypeSoftware Application (selected by default)
    Entity Aliaseszoom, zoom video, zoom pro
    Negative Aliasesloom

  4. Click on Submit Button to create the entity

Modify Software Entities

  1. Navigate to Moveworks Setup > Entity Catalog and Click on Edit Button

  2. Edit the fields that you want to modify in Entity Details page

    • Edit Description, or
    • Add, update or remove Aliases, or change their matching logic, or
    • Add, update or remove Negative Aliases

  3. Click on Submit Button

Where to Utilize Software Entities?

  1. Navigate to Moveworks Setup > Access Software > Software Catalog

  2. Search for the entity in the Software/Application Name field

  3. Setup the Software Provisioning for the Software or Application. For more information, read the guide on Provision Management