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
  • Getting Started
    • Welcome to Moveworks
    • Roadmap & Release Notes
    • Moveworks Best Practices
    • Labs
    • Professional Services
    • Support
  • AI Assistant
    • AI Assistant Overview
    • Capabilities
      • AI Disclaimers
      • Configure Disclaimers & Labels
      • Approvals Queue
      • Channel Resolver
      • Code Interpreter
      • Display Configurations
      • Domains
      • Email Composer
      • Employee Communications
      • Notifications Settings
      • People & Places Lookups
        • Configure People Lookups
        • Conference Room Settings
        • How To Guides for People and Places Lookups
      • Self Knowledge
      • Smart Handoff
      • Text Translator
      • Personalized Responses
      • World Knowledge App
    • Web Experiences
    • Analytics & Performance
  • Enterprise Search
    • Overview
    • Agentic RAG Overview
    • Content Ingestion Platform
    • Profile Boosting
    • Retrieval
    • Permissions Platform
    • Built-in Content Connectors
    • Build your own Content Connectors
    • Configure Search
    • Configure Enterprise Search
    • Vetted Content
    • Writing AI-Ready KB Articles
    • Document Chunking and Snippetization Overview
  • Productivity Boost
    • Overview
    • Configure Productivity Boost
    • Quick GPT
    • Calendar Management
    • Brief Me
DeveloperAcademyCommunityStatus
On this page
  • Prerequisites
  • Step 1: Configure the People Lookup Card Results
  • Step 2: Enable the Lookup Plugin
  • Additional Optional Settings for People and Places Lookup Fields
  • Note
  • Enabling Direct Reports
  • Configuration
AI AssistantCapabilitiesPeople & Places Lookups

Configure People Lookups

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

Conference Room Settings

Next
Built with

This is a guide on how to configure and enable the Lookup Plugin in the AI Assistant. This plugin is responsible for handling the people lookup functionality across and Org based on their Identity Data.

Prerequisites

  1. Ensure that User Identity is configured before configuring Lookups. Please wait 24 hours after configuring identity ingestion before configuring People Lookups.
  2. Ensure that the user’s roster mapping for the field full_name is in the format of
    • <first name> <last name>
    • <first name> <middle name> <last name>

Step 1: Configure the People Lookup Card Results

Default Fields: This lets you customize which fields will get shown in the People Lookup response.

Override Default Fields: This allows you to completely replace all the default fields for people in the Moveworks bot’s response.

Step 2: Enable the Lookup Plugin

To enable the People Lookup feature, the plugin must be enabled.

  1. Navigate to Lookups > Plugin Settings and set the value to true TRUE to enable the feature.

  1. Navigate to AI Assistant > Plugin Management to enable the People Registry Plugin

Additional Optional Settings for People and Places Lookup Fields

Label for “Lookups” Discovery Button: This lets you to define a text label for the button that will be shown in the greeting message. Clicking this button will show a Lookups discovery card, which will then guide users on how to use the Lookups skill.

Sample Queries: This allows you to specify a sample set of queries that will be presented to users as references for them to try out in a Lookups discovery card.

Customize Default Field Titles for People and Places: This lets you customize the names of the fields for people and places in the Moveworks bot’s response. For example, “phone” field can be displayed as “Contact” in the lookup results card.

Note

This only substitutes the name at the time of display and doesn’t change the actual name of the field.

Distinguishing Fields in case of Ambiguous Results: This lets you choose the specific field to display when there are similar lookup matches, helping resolve any ambiguity in the responses.

Example

If there are two John Doe(s) in your organization and the role field is selected in this config, then role will help in identifying which John Doe you might be looking for.

Example Moveworks Assistant response:

I’ve found a couple of people named John Doe:

  1. John Doe – Sales Manager
  2. John Doe – Marketing Specialist

Could you please specify which John you are referring to, or if you need information about both? 😊

Enabling Direct Reports

Configuration

  1. Ensure the manager_email field is mapped in User Identity config.

    1. Sample Manager Email Mapping for Okta
      "manager_email": "profile.managerEmail",

  2. Configure internal_fields.manager_resolver in the User Identity configuration Source-Specific User Attribute Mapping for the connector you are pulling manager info from.

    Example mapping for ServiceNow: