AI Configurations

The Cogynt AI Chatbot is part of the Cogynt intelligence suite of applications and can be used in two contexts:

1. Within a specific event.
2. As a general-purpose chat outside of an event.

AI Configurations define how the chatbot behaves in each context.

Within events, the chatbot helps investigators analyze structured event data—summarizing content, highlighting notable entities, surfacing data quality issues, and suggesting areas for deeper analysis. In the global chat experience, users can ask general questions or get assistance without being tied to a specific event.

Chats can be resumed each time users log in to Workstation, and users can resume from or review another user's session for faster analysis.

Working with the chatbot follows a three-step workflow:

1. Team leads or admins prompt the chatbot. Prompts help provide context for the chatbot and improve precision of results.
2. Analysts create a chat session (within an event or in the global chat interface).
3. Analysts interact within that session as needed. Sessions can be resumed later by the user who initiated them, or reviewed by another user to see the chatbot's analysis.

Using AI Chat Configurations

AI chat configurations define how the chatbot behaves, including system prompts, suggested questions, and which models are available for use.

It is recommended to regularly test these system prompts as the needs of your team change.

Configuring the Cogynt AI Chatbot

Required Permissions

Access to this capability requires the following permissions:

 View & Edit

Workstation

→

Ai Configs

To configure the AI chatbot:

1. At the top right side of Workstation, click the Settings icon.
2. From the left side drawer, click the AI Configs icon. The view switches to AI Configs, and a table containing any and all existing chat configs appears.
3. At the top right of the page, click + AI Config to add a new configuration. The screen changes, making several fields available to edit:
   1. Select the Type from the dropdown menu.
      • General: Creates a configuration for global chat sessions (outside of events). Only one General configuration is allowed. When selected, no Event Type field is shown. If a General configuration already exists, the Type field is disabled and defaults to Event.
      • Event: Creates a configuration tied to a specific event type. When selected, you must choose an Event Type. Each event type can have only one configuration.
   2. If Event is selected, choose the Event Type from the dropdown menu.
   3. Enter an optional Description.
   4. Enter a General System Prompt. The system prompt is an instruction that the chatbot is prompted with when a new session is created.
   5. Select one or more Allowed Models. These define which LLMs can be used for chat sessions associated with this configuration.
   6. Select a Default Model. This is the model used by default when a new chat session is started. The default model must be one of the selected Allowed Models.
4. On the left side of the page, click Suggested Questions to add any suggested questions. Suggested questions are prompts that users can select to interact with the chatbot.
   1. In the Suggested Prompt field, enter the text to suggest as the AI prompt.
   2. In the Instructions for the Prompt field, enter the instructions to accompany the suggested prompt.
5. Click Create to save the AI chat configurations you've set, or click Cancel to discard the changes.

note

If a selected model is deprecated, it is highlighted in red in both Allowed Models and Default Model. Deprecated models must be removed or replaced with valid models before changes to the AI configuration can be saved.

Creating General System Prompts

The system prompt is designed to train your AI's persona, and is the default prompt used when a new session is created. A well-constructed system prompt provides the system with a sufficient background to perform analysis on the specific event type.

Good system prompts:

• Assign the chatbot an appropriate role or a persona.
• Provide background context.
• Are brief but specific. Aim for under 5,000 characters for best results.
• Include prompting details that describe possible outcomes or goals.

tip

You can use the following formula to help guide your thinking:

1. Begin by telling the chatbot what kind of persona to assume.
2. Tell the chatbot the kind of data to expect.
3. Prompt the chatbot with any relevant details that your team is likely to expect it to know.
4. Include any specific details related to a methodology you want the chatbot to adopt as it analyzes data.

Some concepts for strong system prompts:

Prompt	Description
Assume the persona of a Naval Investigator trained in SOFIT. View the report's structured data and develop a clear understanding of it. Be prepared to assist potential human investigators, and ask clarifying questions as needed.	Specifically calls out the SOFIT framework, and prompts the bot with background on the relevant investigative field. Also instructs the model on some items it may need to consider before providing a response.
Analyze the raw structure of crime reports assuming the persona of a lead detective. Be prepared to help investigators look for credible links between crimes committed by certain groups or individuals.	Informs the bot of the data to come, and instructs the persona to act in preparation for a specific outcome.

note

Starting a new session with the chatbot is necessary whenever a change is made to the system prompt. The bot uses the prompt only in sessions created after changes were made.

Creating Suggested Questions

Suggested questions are prompts for the end user utilizing the chatbot. These questions help analysts quickly access common queries. Your team should revisit and revise them as needed.

Each question has two fields that must be completed:

1. Suggested Prompt appears as a clickable query the end user can perform when a session is opened. Phrase this for the end user.
2. Instructions for the Prompt are sent to the chatbot. These instructions provide specific details, instructions, or themes the chatbot should use before providing its response.

For best results, keep suggested questions between 150-200 characters. Instructions for prompts can be longer.

The following table provides some example questions:

Question	Prompt Instruction
Summarize the event for analysis.	Provide a summary of the event's details.
What insights are worth following up?	Analyze the structured data with an emphasis on highlighting insights that look worthy of follow up.
Detect any identifiable entities/persons on the event.	Identify and name any individuals that this event contains.
What data quality issues may exist with this event type?	Review the event and highlight any datapoints of questionable quality. Include reasoning for flagging each datapoint.

Editing Suggested Questions

Suggested questions can be edited to change how users or the chatbot interact with them. Any questions that are changed require a new chat session before users can see or use the changes made.

To edit suggested questions:

1. From the AI Chat Configs settings screen, locate the configuration to edit.
2. At the right of the config to edit, click Edit. The screen changes to Edit AI Chat Configs, and presents all fields available for editing. Make changes as needed:
   1. In the Description field, enter a description for the configuration.
   2. In the General System Prompt field, enter the system prompt the configuration should use.
3. At the left side of the page, click the Suggested Questions header. The screen changes to show each suggested prompt. Make changes as needed:
   1. In the Suggested Prompt field, enter the text to suggest as the AI prompt.
   2. In the Instructions for the Prompt field, enter the instructions to accompany the suggested prompt.
4. Click Save to save your changes, or click Cancel to discard them.

Deleting Suggested Questions

You can delete any suggested questions as needed from the AI Chat Configs menu. Deleted suggested questions cannot be recovered, but the AI Config are otherwise unchanged.

To delete suggested questions:

1. From the AI Chat Configs settings screen, locate the configuration to edit.
2. To the right of the config to edit, click Edit. The Edit AI Chat Configurations modal opens.
3. Locate the question to remove.
4. To the right of a Suggested Prompt, click the trashcan icon to delete it.

note

There is no confirmation message when deleting a suggested prompt.

Deleting AI Configs

You can delete any AI chat configuration from the AI Chat Configs settings menu. Doing so removes the system prompt and any suggested questions that may have been added to it.

To delete AI configs:

1. From the AI Chat Configs settings screen, locate the configuration to be deleted.
2. On the right side of the configuration, click the More menu (⋮).
3. Select Delete to delete the chosen AI chat configuration.
4. Click Delete to confirm deletion of the chat configuration, or Cancel to keep it.

note

Deleting the general config disables the AI button from the app bar. Users that have access to use the chatbot may still interact with the chatbot on specific events.

Duplicating AI Chat Configs

You can duplicate any AI chat configurations for events from the AI Chat Configs settings menu:

1. From the AI Chat Configs settings screen, locate the configuration to be deleted.
2. On the right side of the configuration, click the More menu (⋮).
3. Select Duplicate to duplicate the chosen AI chat configuration. A modal opens to Duplicate AI Chat Configurations.
4. Select an Event Type from the dropdown menu.
5. Make any other changes to General System Prompts or Suggested Questions.
6. Click Save to save the duplicated prompt, or click Cancel to discard it.