# Dispatch AI

<figure><img src="https://1542307009-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCk5zoeun5gx3ujYW6eg%2Fuploads%2FIkIDqZpXa5otqatDZwvW%2Fdai_promo.png?alt=media&#x26;token=c2bc2fce-e084-46dd-adf5-1351f7e4593c" alt=""><figcaption></figcaption></figure>

{% hint style="danger" %}
This feature is in a public **BETA** state.

Services may be intermittent and unreliable. Some features may experience issues.

Dispatch AI is not yet approved for full, production use. Utilize dispatch AI at your own risk.
{% endhint %}

{% hint style="warning" %}
This feature requires both **Sonoran CAD Pro** and **Sonoran Radio Pro**.

[Learn more about our paid subscription plans.](https://docs.sonoransoftware.com/radio/pricing/pricing-faq/standalone-pricing)
{% endhint %}

## Setup Video

{% embed url="<https://app.guidde.com/share/playbooks/937jHS9EDLh9vEuWnaovk8?origin=G25dDmjNZ2b8ccFUz9X7G7W8T1k1>" %}

## Setup Documentation

### 1. Copy Sonoran CAD API Information

<details>

<summary>Copy Sonoran CAD API Information</summary>

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** > **Web API**.

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

<div><figure><img src="https://1542307009-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCk5zoeun5gx3ujYW6eg%2Fuploads%2Fn1CPngAajSLjTB9yELmi%2Fimage.png?alt=media&#x26;token=2bc4e271-eb60-47fa-b3a4-28095d5e4ac0" alt="" width="375"><figcaption></figcaption></figure> <figure><img src="https://1542307009-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCk5zoeun5gx3ujYW6eg%2Fuploads%2Fe3HGo22oSxRSpVHTxyTL%2Fimage.png?alt=media&#x26;token=067a3df3-7024-4538-9e3d-3fb54dfe2648" alt="" width="375"><figcaption></figcaption></figure></div>

</details>

### 2. Create an Open AI API Key (BYOK)

<details>

<summary>Open AI API Key</summary>

Currently, dispatch AI runs on a bring-your-own-key (BYOK) system for AI usage billing. This allows communities to maintain granular control of their AI expenses with OpenAI as a third-party. This system is subject to change in the future.

{% hint style="danger" %}
Sonoran Software Systems is not responsible for any unexpected or excess charges incurred from OpenAI or other third-party AI service providers. Communities are strongly encouraged to set spending limits, enable billing alerts, and actively monitor AI usage to ensure costs remain within approved thresholds.

Because OpenAI and all other AI providers are a third-party, Sonoran Software Systems has no ability to offer refunds or reduced rates for AI costs.
{% endhint %}

[View the OpenAI API Key process here.](https://docs.sonoransoftware.com/radio/tutorials/integrations/ai)

In the current beta, dispatch AI relies on the following models:

* `gpt-realtime-mini`
* `gpt-5-nano`
* `gpt-4o-mini-transcribe`
* `gpt-4o-mini-tts`

</details>

### 3. Link CAD In Radio

<details>

<summary>Link CAD In Radio</summary>

In the radio **Customization** panel > **Info** > Select a server (or create one) and click on the Sonoran CAD icon. This will open a popup modal to enter in your CAD's community ID, API key, and server ID. Additionally, paste in your AI API key from the previous step.

<div><figure><img src="https://1542307009-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCk5zoeun5gx3ujYW6eg%2Fuploads%2Ff8d8fzO2ohD4awV2SOIQ%2Fimage.png?alt=media&#x26;token=0681aab1-9e66-4483-9336-a9b94c68c46e" alt=""><figcaption></figcaption></figure> <figure><img src="https://1542307009-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCk5zoeun5gx3ujYW6eg%2Fuploads%2F5SNuvNsAMjnUbBqYV3bV%2Fimage.png?alt=media&#x26;token=0f7cf868-39c8-4893-8861-49bcc22868ea" alt=""><figcaption></figcaption></figure></div>

</details>

### 4. Prompt Customization

<details>

<summary>AI Prompt Phrases</summary>

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.

</details>

## Invoke the AI

{% hint style="info" %}
When first connecting to the radio, if you are the only user in the room, the AI agent may take up to 30 seconds to join.

When the agent has joined, a brief "Dispatch Online" audio will play.
{% endhint %}

<details>

<summary>Via Wake Work</summary>

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 word by pressing the microphone button and speaking their custom wake word.

Communities can also [customize the default wake word for all users](https://docs.sonoransoftware.com/radio/tutorials/usage/dispatch-panel/default-user-settings).

<figure><img src="https://1542307009-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCk5zoeun5gx3ujYW6eg%2Fuploads%2FPth2Xwc1I26S3geEAVR4%2Fimage.png?alt=media&#x26;token=9fdb2236-5fb3-44e4-bb04-5158c90e3960" alt="" width="260"><figcaption></figcaption></figure>

### 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*

</details>

<details>

<summary>Via Hotkey (Web and Desktop)</summary>

Web and desktop users can also set a [customizable hotkey in the settings menu](https://docs.sonoransoftware.com/radio/usage/dispatch-panel/using-the-dispatch-panel#dispatch-hotkeys). Pressing this keybind will enable the AI (same as the wake word) for your transmission.

<figure><img src="https://1542307009-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCk5zoeun5gx3ujYW6eg%2Fuploads%2FjMFMn2rnvXH68fwIOF5c%2Fimage.png?alt=media&#x26;token=08e93db1-faff-4e3b-8792-9b6d18262834" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary>FiveM: Via Hotkey</summary>

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.

<figure><img src="https://1542307009-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCk5zoeun5gx3ujYW6eg%2Fuploads%2FlrlwZNBUNivDxO35Pu8S%2Fimage.png?alt=media&#x26;token=caadc2ff-d88e-4c03-875f-5f90eff0d861" alt="" width="375"><figcaption></figcaption></figure>

</details>

## Enable/Disable the AI

<details>

<summary>Manually</summary>

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

<figure><img src="https://1542307009-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCk5zoeun5gx3ujYW6eg%2Fuploads%2FEYymxd3PLB0Z4lLeC91O%2Fimage.png?alt=media&#x26;token=c681f207-4f06-4caa-9e2c-6a4cc40aebf2" alt="" width="227"><figcaption></figcaption></figure>

</details>

<details>

<summary>Auto Disable w/Human Dispatcher</summary>

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.

<figure><img src="https://1542307009-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCk5zoeun5gx3ujYW6eg%2Fuploads%2FhjNYskc6Mla8cZyhfYhD%2Fimage.png?alt=media&#x26;token=ba11a3e4-fb30-49e2-80b1-09d1edb92eb9" alt="" width="227"><figcaption></figcaption></figure>

</details>

## AI Commands & Features

### CAD Functionality

<details>

<summary>CAD Status</summary>

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.*

</details>

<details>

<summary>CAD Lookup</summary>

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.*

</details>

<details>

<summary>CAD Dispatch Calls</summary>

#### 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.*

</details>

<details>

<summary>CAD Unit Groups</summary>

#### 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.*

</details>

<details>

<summary>CAD Panic</summary>

***Dispatch**, A-10, toggle my panic status.*

The AI agent will enable or disable your panic status.

</details>

<details>

<summary>FIveM: Emergency Call Readout</summary>

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.

<figure><img src="https://1542307009-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCk5zoeun5gx3ujYW6eg%2Fuploads%2FWM1MU2YLPR9F2RWuEntx%2Fimage.png?alt=media&#x26;token=c1250a8b-5c96-4f67-a4da-3ed255771e84" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary>FiveM: GPS Route to Postal</summary>

{% hint style="warning" %}
In order to route your GPS to a postal code, the **Nearest Postal** resource is required.\
Or, another resource that can handle the command `/postal <id>`.
{% endhint %}

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.*

</details>

<details>

<summary>FiveM: GPS Route to Unit</summary>

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.*

</details>

<details>

<summary>FiveM: Auto-Status on GPS Route + Arrival</summary>

{% hint style="warning" %}
This feature requires the **Nearest Postal** resource version v1.5.4 or newer.
{% endhint %}

When the AI routes a user to a specific [postal code](#fivem-gps-route-to-postal) or [GPS coordinate (unit location) ](#fivem-gps-route-to-unit)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](https://docs.sonoransoftware.com/radio/getting-started/installing-the-in-game-resource#configuration-options) contains `Config.autoOnSceneStatus` with options to tweak the settings.

</details>

### Radio Functionality

Coming soon!

## Settings

<details>

<summary>AI Volume</summary>

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

<figure><img src="https://1542307009-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCk5zoeun5gx3ujYW6eg%2Fuploads%2F5Fml86VtEWh9fLGs3Ig0%2Fimage.png?alt=media&#x26;token=b53eb249-737f-47ac-b3b9-97835c9834ef" alt="" width="259"><figcaption></figcaption></figure>

</details>

<details>

<summary>Hear AI Replies</summary>

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.

<figure><img src="https://1542307009-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCk5zoeun5gx3ujYW6eg%2Fuploads%2FQQc2tdkWXVLayuMq0U2z%2Fimage.png?alt=media&#x26;token=2ec27c23-3ea3-4c44-9f4e-edae1fb2c066" alt="" width="375"><figcaption></figcaption></figure>

</details>