Skip to main content
Skip table of contents

Pathfinder User Guide

Overview

This document provides a detailed description of the Pathfinder tool.

Pathfinder is a knowledge management system, part of the Omilia Cloud Platform® (OCP®), which allows users to upload raw data and get tasks or intents created based on it. These intents can then be used in your application.

Supported data formats include PDF, TXT, CSV, and HTML. It is also possible to add a URL to the Pathfinder to get information from it.

You can access Pathfinder in the side panel as shown below.

image-20240509-111624.png

Create a Project

To add data to work with, you need to create a project first. Click the +Create Project button in the right upper corner to get started.

All your created projects will be listed in the Pathfinder tab.

image-20240509-112854.png

Once you click the +Create Project button, you’ll see a modal prompting you to write the Name for the project, select the Group it belongs to, and choose a Domain from the dropdown options:

image-20240509-113538.png

Check the checkbox confirming you have read and agreed to the Terms of content below once you read it and click the Create button.

image-20240509-113810.png

Upload Your Data

To add your data, first choose the type of data you want to upload:

  • Upload with free text (for text content in TXT, PDF formats);

  • Upload files with tabular data (for data content in a CSV format).

The size of your file should be up to 5 MB.

image-20240509-114529.png

You can also provide your data from a URL. To do it, paste the URL in the field below and click +Add a URL.

image-20240509-115021.png

Once you click the + Add a URL button, you can also toggle on Follow links one level down if needed.

image-20240513-160630.png

You can delete any file or URL you added before proceeding with it by clicking on the red Trash icon to the right of each file/URL.

image-20240513-160554.png

Once you done, click the Upload and Continue button in the right upper corner of the screen. When the data gets uploaded, you’ll see a pop-up message “Files uploaded successfully!” in the upper right corner of your screen. You’ll be redirected to the detailed view of your project called Journey Mapper.

Journey Mapper

Within the detailed view of the project called Journey Mapper, you can view the Intents generated based on the data you uploaded. You can use the Search Intents input field to look up specific Intents added. You can also manually add Intents by pressing the three dots icon above the Search Intents field and selecting +Add Intent.

In the upper right corner, you can also access Manage Data and Close project to return to the main view with the list of all added projects.

image-20240513-161825.png

Manage Data

If you click Manage Data in the upper right corner, you’ll see two tabs: Files that contain files/URLs you uploaded and their status and Upload that allows you to upload more data to the current project.

image-20240528-123202.png

The Upload tab contains the same data uploading options as were available when creating the project, including free text, tabular data, and URL:

image-20240528-123342.png

You can close the Manage Data modal by clicking on the X icon in the upper right corner of the screen:

image-20240528-125132.png

Create Intent Manually

To create a custom Intent for a specific project manually, click on the three dots icon and select +Add Intent.

image-20240513-162739.png

Write the name of the Intent and press the Create button.

image-20240513-161931.png

Click on the created Intent to add Sample Utterances and manage Business Logic. Type your utterance in the Add Utterance field and press Enter to add it.

It’s currently not possible to edit or delete added utterances.

The Business Logic tab is not available yet.

image-20240513-162110.png

Work with Intents

To view details of a specific Intent (whether generated based on the data you uploaded or created manually through the Pathfinder interface) and Sample Utterances associated with it, click the Intent name.

image-20240528-123758.png

When you have both generated (uploaded) and manually created Intents, generated ones will have a label associated with the data source, while the manually created ones will have a Custom label. For example, on the screenshot below, the Intent generated based on the FAQ data provided via URL has an FAQ label and a manually created Intent has a Custom label.

image-20240528-124401.png

After Intents were created (whether generated based on the data you uploaded or created manually), you can still add Sample Utterances to them if needed. To do so, click the preferred Intent and type in your utterance in the Add Utterance field. Press Enter to get the utterance added to the Intent.

image-20240528-124819.png

Chat Simulator

To test your Intents and Sample Utterances, you can use a Chat Simulator feature available in the bottom right corner of your Journey Mapper view. Click the violet chat icon as shown on the screenshot below to expand the Chat Simulator.

image-20240528-125657.png

You can copy one of the existing Sample Utterances and paste the text in the Chat Simulator. To send your message, either click the Send icon or press Enter.

image-20240528-130431.png

You can then review the response to your message, where your message is violet and system message in grey.

To restart the conversation, click the Restart icon.

Multi-step conversations are not yet available in the Chat Simulator. Please restart the chat to start over with another utterance.

image-20240528-130749.png

To collapse the Chat Simulator window, click the _ icon. To close the Chat Simulator, click the X icon.

Collapsing the tool will not delete the current test conversation, and you can view it again after clicking the Chat Simulator icon. Closing the Chat Simulator window will erase the current test conversation and bring you to the starting point when you open the chat next time.

image-20240528-131204.png

Manage Projects

You can view all your created projects in the Pathfinder tab. If you want to rename or delete any project, click on three dots icon to the right of a specific project and choose Rename or Delete.

image-20240509-114116.png

If you delete a project, you won’t be able to create a new project with the same name.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.