> For the complete documentation index, see [llms.txt](https://black-horizon-studios.gitbook.io/emerald-ai-wiki/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://black-horizon-studios.gitbook.io/emerald-ai-wiki/emerald-components-optional/sound-detector-component/applying-the-sound-detector-component.md).

# Applying the Sound Detector Component

{% hint style="warning" %}
**Important:** Ensure your AI is fully setup before proceeding. If you have not done this yet, please see the [Getting Started](/emerald-ai-wiki/getting-started/included-demo-scenes.md) section.
{% endhint %}

## Applying the Sound Detector Component

If you haven't already done so, you will need to add the Sound Detector Component to your AI. You can do this by searching for the Sound Detector script and dragging it onto your AI.

<figure><img src="/files/fHXlow0Kxrac7GYYFkrX" alt=""><figcaption></figcaption></figure>

After adding a new Sound Detector component, there are foldouts for each level of awareness. These are Unaware, Suspicious, and Aware. The reaction slots, within each foldout, control what reactions the AI takes when that Threat Level is met. A Reaction Object holds a list of reactions that the AI will follow in order.

Assign a Reaction Object to each slot. While starting off and familiarizing yourself with the Sound Detector Component, it is recommend to use the included example Reaction Objects. Assign the Unaware reaction object, to the Unaware reaction slot, the Suspicious reaction object, to the Suspicious reaction slot, and the Aware reaction object, to the Aware reaction slot.

{% hint style="info" %}
**Note:** After the AI has a Sound Detector Component and Reaction Objects assigned for each Threat Level, it has sound detector capabilities. Users can fine tune the [Sound Detector Settings](/emerald-ai-wiki/emerald-components-optional/sound-detector-component/understanding-the-sound-detector-settings.md) to suit their needs.
{% endhint %}

<figure><img src="/files/kMYtVPJcvz3062S3O8RA" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://black-horizon-studios.gitbook.io/emerald-ai-wiki/emerald-components-optional/sound-detector-component/applying-the-sound-detector-component.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
