For the complete documentation index, see llms.txt. This page is also available as Markdown.

Dispatch AI

Speak to our AI dispatcher over the radio to manage CAD status, dispatch calls, run record lookups, and more.

Language Support

Sonoran Radio is fully translated in over a dozen languages, with our public portal allowing communities to submit translation improvements. By default, dispatch AI uses the same language selected for the app. Users can select a different option just for the AI. Or, change their app's language.

Setup Documentation

1. Copy Sonoran CAD API Information

Copy Sonoran CAD API Information

Dispatch AI requires a Sonoran CAD community ID, API key, and server ID.

The community ID and API key are located in the Admin panel > Advanced > In-Game Integration > API.

The server ID can be found in the Admin panel > Customization > Servers. The default server ID is 1.

3. Prompt Customization

AI Prompt Phrases

The AI has a set of tools it can use to take action in the CAD and on the radio—such as running lookups, creating calls, or updating statuses.

Radio traffic varies by community. One agency might say, “show me out on traffic with a blue sedan,” while another says, “create a traffic stop call with a blue sedan.”

Prompt phrase customization lets you train the AI to map your agency’s specific radio language to the correct system actions, so it responds appropriately to local lingo.

Keep your phrases short and direct. Adding too many phrases can eventually overload the AI's context window.

Enable/Disable the AI

Manually

The AI can be manually toggled on or off via the CAD link page.

Auto Disable w/Human Dispatcher

The AI can be automatically disabled whenever an active dispatcher is in the CAD.

When this feature is enabled, the AI will check for a dispatcher once per minute.

Using the AI

Invoke the AI

When first connecting to the radio, if you are the only user in the room, the AI agent may take up to 15 seconds to join.

When the agent has joined, a brief "Dispatch Online" audio will play.

Via Wake Work

When pressing your push-to-talk key, a local AI listens to your microphone feed for the customizable wake word. By default, this is Dispatch.

Users can customize their wake words by pressing the microphone button and speaking their custom wake words.

Communities can also customize the default wake word for all users.

Prompting the AI

In order to reduce false triggers and conserve local resources, the AI will only listen to the first five seconds of your transmission. This amount can be modified in the Advanced tab of the Audio settings.

Upon detection of the wake word, an audible beep indicates that the AI has been activated. Users may begin speaking before the beep is heard, as long as the tone occurs at some point during the same transmission.

Example

If your wake word is Dispatch, then your transmissions to the AI would be as follows:

<wake word>, <optional: my unit number>, <action to do> &#xNAN;Dispatch, A-10, mark me as available. &#xNAN;Dispatch, A-10, run a lookup on the license plate ABC123

Via Hotkey (Web and Desktop)

Web and desktop users can also set a customizable hotkey in the settings menu. Pressing this keybind will enable the AI (same as the wake word) for your transmission.

FiveM: Via Hotkey

FiveM users can also set a manual keybind in the settings. Pressing this keybind will enable the AI (same as the wake word) for your transmission.

User Customization

Transcripts and Overrides

A local speech-to-text AI generates a text transcript of your transmission. Sometimes, the AI can mishear common phrases resulting in poor performance.

Users can view their latest transcripts under Settings > AI > Recent Transcripts.

To improve these common mixups, add a Phrase Override manually.

AI Commands & Features

CAD Functionality

CAD Status

The AI can update the status of you and other units to the stated, customizable status code.

Dispatch, A-10, mark my status as available. &#xNAN;Dispatch, A-10, set B-11 and I to 10-8.

CAD Lookup

The AI agent can perform a name or plate lookup, send the results to your CAD, and notify you of brief details.

Dispatch, A-10, run a lookup on the plate ABC123. &#xNAN;Dispatch, A-10, do a record check on first name John last name Doe.

CAD Dispatch Calls

Create Call

The AI can create a call and assign your unit. If your unit has a location, it will be automatically applied to the call unless otherwise specified. If a license plate is provided, it will automatically run a plate lookup and send the results to your CAD.

Dispatch, A-10, show me out on traffic with a blue four-door sedan. License plate ABC123.


Attach to Call

The AI can attach you and other units to an existing call by mentioning the call ID, location, postal, title, etc.

Dispatch, A-10, attach me to the robbery in progress call. &#xNAN;Dispatch, A-10, attach B-11 to my call.


Call Notes

The AI can add a note to your active dispatch call for other units to see.

Dispatch, A-10, add a note on the call that I am arriving on-scene now, it's a white vehicle.


Detach from Call

The AI can lookup your current dispatch call and remove you from it.

Dispatch, A-10, clear my call.


Close Call

The AI can lookup and close your current dispatch call. &#xNAN;Dispatch, A-10, close my call.

CAD Unit Groups

Group Units

The AI can add your unit (and others) to a new or existing group.

Dispatch, A-10, add me to group 'Ladder 12'. &#xNAN;Dispatch, A-10, add myself and B-11 to group 'Ladder 12'.


Clear Unit Group

The AI can remove your unit (and others) from a group.

Dispatch, A-10, clear my unit group. &#xNAN;Dispatch, A-10, remove B-11 and I's unit group.

CAD Panic

Dispatch, A-10, toggle my panic status.

The AI agent will enable or disable your panic status.

FIveM: Emergency Call Readout

In the Radio Zones menu, you can create custom zones and assign radio channels to each. When a 911 call is generated in CAD, the AI automatically creates a new dispatch call, reads the call over the channels configured for that zone, and removes the 911 call.

FiveM: GPS Route to Postal

The AI can draw an in-game GPS route to a postal code on the map.

Raw Postal:

Dispatch, A-10, route me to postal 123. &#xNAN;Dispatch, A-10, directions to postal 123.


Postal on a Dispatch Call

The AI can find an active dispatch call based on the ID, location, title, etc. &#xNAN;Dispatch, A-10, route me to call 123. &#xNAN;Dispatch, A-10, route me to the traffic stop call.

FiveM: GPS Route to Unit

The AI will route you to the coordinates of another active unit by providing their unit name, number, etc.

Dispatch, A-10, route me unit B-11. &#xNAN;Dispatch, A-10, directions to unit J. Doe.

FiveM: Auto-Status on GPS Route + Arrival

When the AI routes a user to a specific postal code or GPS coordinate (unit location) it will automatically set your status as en-route. Upon arrival, the AI will automatically mark your status as on-scene.

The radio resource's config.lua contains Config.autoOnSceneStatus with options to tweak the settings.

Radio Functionality

Coming soon!

Settings

AI Volume

The AI's reply volume can be changed in the settings menu.

Hear AI Replies

By default, users hear AI replies directed to anyone in their primary or scanned channel. The radio setting allows you to switch from hearing AI replies for all users to hearing only replies addressed to you.

Token Usage

Dispatch AI usage is limited by total AI token usage. Token usage varies depending on request length, task complexity, and the number of actions performed. You can learn more about these limits on our pricing page. These limits reset on the first of every month.

Viewing Token Usage

Users can view their community's current token usage under Settings > AI > Token Usage. When a community reaches their token usage limit, the AI will be disabled and unable to take additional requests until the limits are reset on the first of the month or the community is upgraded.

Last updated

Was this helpful?