# Examples

### Built in Commands

TidyLabs has some built in commands for your users to use.

| Usage                       | Permission            | Example Output                                                                                        |
| --------------------------- | --------------------- | ----------------------------------------------------------------------------------------------------- |
| !help                       | Owner                 | Please check the TidyLabs documentation over at <https://docs.tidylabs.stream/> for full instructions |
| !ping                       | Owner                 | !pong                                                                                                 |
| !uptime                     | Everybody             | The stream has been live for...                                                                       |
| !8ball Will it snow?        | Everybody             | Yes!                                                                                                  |
| !giveaway A Lovely Thing    | Owner / Moderator     | \<user> has started a giveaway for A Lovely Thing type !enter to enter                                |
| !subgiveaway A Lovely thing | Owner / Moderator     | \<user> has started a subscriber only giveaway for A Lovely Thing type !enter to enter                |
| !enter                      | Everybody             | \<user> has entered the Giveaway!                                                                     |
| !winner                     | Owner / Moderator     | \<user> has won A Lovely Thing                                                                        |
| !sr \<YouTubeLink>          | Everybody / Subs Only | The song 'XXXX' requested by @tidy has been added to the queue!                                       |
| !removesong SONGID\<ID>     | Owner / Moderator     | Song XXXX has been removed from the playlist.                                                         |
| !title \<title>             | Owner                 | New Title 'XXXXXXXX' has been set :)                                                                  |
| !game \<category>           | Owner                 | Category has been changed to: 'XXXXXXXX'                                                              |
| !host \<user>               | Owner                 | We are now hosting @XXXXXX[ ](https://dlive.tv/frozenbox)at: <https://dlive.tv/XXXXXXX>               |
| !dice \<number>             | Everybody             | @user 🎲X🎲                                                                                           |

### Custom Commands

For custom commands you can use the following tags to automatically replace responses:

\##sender## = the person who requested the command\
\##target## = the person you have tagged in your chat command

| Command | Response                                                               | Usage           | Output                                                           |
| ------- | ---------------------------------------------------------------------- | --------------- | ---------------------------------------------------------------- |
| !so     | Go check out <https://dlive.tv/##target##> - He loves Pineapple Pizza! | !so @tidy       | Go check out <https://dlive.tv/tidy> - He loves Pineapple Pizza! |
| !tickle | ##sender## pick's up a feather duster and tickles ##target## !         | !tickle @cheaky | Tidy pick's up a feather duster and tickles Cheaky !             |

{% hint style="warning" %}
Commands currently have a fixed cooldown of 60 seconds.  Customisation of this option will be added in a future release.
{% endhint %}


---

# Agent Instructions: 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:

```
GET https://docs.tidylabs.stream/tidylabs-chat-bot/global-chat-bot/example-commands.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.