Skip to main content

Creating Solink Agents

A universal guide on creating agents in the Solink platform.

Written by Ryley White
Updated over 2 weeks ago

You can choose from a selection of default Solink Agents to monitor for certain activity and highlight issues such as theft, fraud, suspicious after-hours activity, and store cleanliness.

While each Agent has a targeted function, they can be customized to embody a specific set of skills, run at varying frequencies, and notify you using different methods.

This guide walks you through each step of creating and deploying an AI Agent.

See Solink Agents: Getting Started for a high-level overview, requirements, and FAQs for Solink Agents.

Note: While most steps in this guide are universal to all agents, some agents require specific configurations for schedules and triggers. The difference in available options between agents are highlighted throughout this guide.


Agent Creation Steps

This section provides an overview of each of the agent creation steps, regardless of selected agent type.

To start creating an agent:

  1. Navigate to the Agents page in the Solink platform > select +Create New Agent. Take note of the requirements needed for agent creation access.

  2. Next, select from one of Solink's pre-built agents based on what you want to accomplish; once selected, you can further customize how the agent behaves on a more granular level.

Follow the steps below to begin customizing your selected agent.

Name Agent (Optional)

You can rename the agent in the Agent Description section. You can also leave the default name as is.

1. Choose Agent Skills

Skills define exactly what activity the agent should flag. Each agent has its own unique set of activity it monitors for.

All skills are selected by default, but if you do not want an agent to monitor for a specific activity you can deselect any of the selected skills.

Note: Deselecting skills can sometimes help reduce the AI quota the agent uses.

You can also provide Additional Context in the Skills section to provide further guidance for the agent:

Add information to the Additional Context field to help the agent understand certain terms or situations relevant and/or unique to your business, such as "Look for voids for small purchases - this is important because theft may occur more frequently with these kinds of transactions".

Tip: It is important to understand how to create effective prompts for AI when adding additional context. Check out this Creating Prompts article for help creating better guidance for Solink's AI.

2. Configure Agent Schedule

All agents operate on schedules; depending on the agent, you can configure how frequently the agent runs.

This section provides a high-level overview of the available scheduling options based on whether the agent monitors for video footage, transactions, or both.

Scheduling: Video Monitoring Agents

Schedules can be configured such that the agent monitors cameras on an interval (for instance, every 5 minutes). This is recommended for use cases requiring spot checks.

Scheduling: Transaction & Video Monitoring Agents

Some agents, such as the Loss Prevention Agent, monitor both video transactions and transaction data.

Schedules for these agents are system defined based on when transactions become available in Solink. By default, the schedule is set to run daily at 5 AM and fetch transactions from up to 3 days in the past; you can review these events once they are fetched via the Agent Logs section (see Agent Logs) or sent via a notification (see Choose Agent Action).

3. Select Monitored Areas

Select specific locations you want this agent to monitor.

If you do not want the agent to monitor all cameras at a given location, you can expand the location in the location selection window and select/remove cameras:

Select Save Selection once you have selected the locations and/or cameras you want the agent to monitor.

4. Set Confidence Threshold

The Confidence Threshold allows you to fine-tune the level of activity the agent monitors for. You may need to re-visit this setting after the agent has been deployed if you find the agent is capturing too much or not enough activity of interest.

The lower the threshold, the more activity the agent will flag. For instance, if the agent monitors for suspicious activity, the agent may flag whenever someone wearing a hoodie sweater appears in the video.

The higher the threshold, the less activity the agent will flag. For instance, if the agent monitors for suspicious activity during closed store hours, the agent may only flag whenever there is a clear threat to person or property, such as a forced entry, shattered window, etc.

It is recommended to start at the Medium Confidence Threshold option and re-adjust the agent later if needed.

5. Choose Agent Action (Notifications)

Select one or more actions to determine how the agent notifies you and/or other Solink users when the agent identifies activity of interest.

You can select no actions if you want to simply restrict agent responses to events and the Agent Logs, or you can select one or more actions if you wish to enable other notification methods, such as SMS or Email.

Publish Agent

Once you have finished customizing your agent, select Publish to create the agent:

You can view and edit the agent from the main Agents page once published. More information about viewing and editing your existing agents is outlined below.


View and Edit Created Agents

You can view and edit agents you have created from the main Agents page:

The Agents page provides a high-level overview of all of your agents, including:

  • Agent Name: Name of the agent

  • Monitored Areas: Total number of monitored locations and cameras

  • Status: Displays whether the agent is currently running or not. See Disable/Re-Enable Agents for more information.

    • Inactive = The agent is disabled and currently not running.

    • Active = The agent is enabled is currently running within the set schedule.

  • Created by: Name of user who created the agent.

  • Schedule Type: Displays the agent's schedule (how frequently the agent runs). See Configure Agent Schedule for more information.

  • Last Activity: How long ago the agent last ran.

  • Runtime: TBD for beta.

Edit Agents

To edit an agent after it has been created:

  1. Select the agent from the Agents page.

  2. Select the Edit icon on the Agents Overview page. All options available during agent creation, such as Skills and Schedules, can be edited:


Agent Logs

Agent Logs provide an overview of all instances of the agent flagging monitored activity.

Each log provides the following information:

  • Location: The location at which the agent discovered the flagged activity.

  • Time Started: The start time of the flagged activity.

  • Duration: The length of time of the flagged activity.

  • Camera: The camera on which the agent discovered the flagged activity.

  • Status:

  • Actions Taken: Select the Event button to see an AI-generated explanation of why the agent flagged this activity. You can also access and view the associated event from this window:

Note: Some agents, like the Loss Prevention agent, may create only one line item but provide multiple linked events in the Action Taken column due to how events are generated in the Solink platform.


Disable/Re-Enable Agents

You can disable an agent to stop the agent from running without completely deleting it.

To disable an agent:

  1. On the Agents page, select the More Actions icon (three dots) next to the agent you want to disable.

  2. Select Disable to immediately disable the agent.

You can also re-enable a disabled agent. Repeat the steps above and instead select Enable.


Delete Agents

To delete an agent:

  1. On the Agents page, select the More Actions icon (three dots) next to the agent you wish to delete.

  2. Select Delete.

  3. Confirm deletion in the next window. Please note that once an agent is deleted, it cannot be recovered.


Agent Events

You can access agent events from two locations:

To view agent events on the Events page, select the Agents tab:

From here, you can view and filter for agent events and build reports that you can then use to build widgets on the Dashboard page.

Each agent event card displays:

  • Agent name.

  • Timestamp marking the beginning of the flagged activity.

  • Location where the agent detected the activity.

  • An AI-generated description that explains why the agent flagged this activity/created an event.

You can filter the displayed agent events via the following agent-specific event filters:

  • Agent Confidence Level

  • Agent Description

  • Agent Reason

  • Agent State

  • Agent Summary

  • Agent Type

Did this answer your question?