# Maven AGI

### Step 1 — Decide When to Request a Recording

Before configuring anything, decide **when** your Maven AGI flow should request a screen recording.

This depends on your support logic. You can be as creative as you need. A common example: *`IF` Customer reports a bug or technical issue `THEN` Request a Birdie screen recording*

### Step 2 — Decide the Wording

You now need to ask customers to record their screen clearly and simply.

Below is a template that performs well. You can adjust it to your tone. Keep it short.

**Template:**

> *We recommend taking a screen recording to help us see the issue from your perspective, enabling a quicker and more accurate answer:*<br>
>
> CLICK HERE TO RECORD \[Insert Birdie Link]<br>
>
> *Pro tip: For best results, enable audio and talk us through the steps leading to your issue while recording*<br>
>
> *Once you’re done:*
>
> 1. *Go to the “Recording” tab*
> 2. *Click on Finish*
> 3. *Click “Copy the link”*
> 4. &#x20;*Paste the link here*

### Step 3 — Enable Maven AGI in Birdie and Get Your Recording Link

Go to [Settings => Helpdesk](https://app.birdie.so/settings/helpdesk) to enable Maven AGI:

<figure><img src="/files/JLl9hKfwOuxqkpZHbk3N" alt=""><figcaption><p>Enable Forethought in your Helpdesk settings to access the Recording Link</p></figcaption></figure>

Once enabled, Birdie generates your **Recording Link**.

Use this link in the message you show to customers in your Maven AGI flow.

#### Important: Add the Customer Email Variable

To identify who recorded the video, append the customer email variable from Maven AGI to the Birdie link. This ensures each recording is associated with the correct user.

Example structure: <mark style="color:purple;">`https://your-subdomain.birdie.so/urec/mavenagi`</mark><mark style="color:blue;">`?email=`</mark><mark style="color:$success;">`name@company.com`</mark> with <mark style="color:$success;">`name@company.com`</mark> being the email variable

### (Optionnal) Step 4 — **Automatically Post the Video in the Conversation**&#x20;

If you want the video to appear automatically in the Maven AGI conversation, you can use Birdie’s Webhooks to automatically post the video URL in the appropriate conversation:

{% content-ref url="/spaces/LNLpSh5W2kAOtQ9wcLkW/pages/x39kUGzkN6PvtcBYX8Ry" %}
[Webhook Integration Guide](/birdie-docs/birdie-api/webhook-integration-guide.md)
{% endcontent-ref %}

{% hint style="info" %}
If you require assistance in constructing an Forethought flow that includes Birdie, or would like us to review a flow you've created, don't hesitate to contact us at <support@birdie.so>.
{% 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.birdie.so/birdie-docs/helpdesk/others/maven-agi.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.