> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/platform-features/reach-out-to-partners/partner-management/manage-my-partners.md).
# Gérer vos partenaires
Une fois que vous avez [recruté des partenaires](/brand/fr/what-would-you-like-to-learn-about/performance-program/recruiting-partners.md) dans votre programme, vous pouvez les gérer depuis l'écran *Mes partenaires* .
{% hint style="warning" %}
Une nouvelle version de l'écran Mes partenaires est déployée progressivement. L'ancien écran reste l'affichage par défaut. [Contactez-nous](https://app.impact.com/secure/advertiser/support/customer-support-portal-flow.ihtml) pour obtenir un accès anticipé à la nouvelle version.
{% endhint %}
{% tabs %}
{% tab title="Ancien écran Mes partenaires" %}
1. Dans le menu de navigation de gauche, sélectionnez  **\[Engage] → Partenaires →** [**Partenaires**](https://app.impact.com/secure/advertiser/engage/mediapartners/view-mediapartners-flow.ihtml).
* Si vous avez un programme de créateurs, consultez [Gérer vos créateurs](/brand/fr/what-would-you-like-to-learn-about/creator-program/working-with-creators/manage-your-creators.md).
2. Dans le coin supérieur droit, vous pouvez effectuer les actions suivantes :
* Pour afficher les données du partenaire sélectionné, sélectionnez  **\[Icône de graphique de rapport]** dans le coin supérieur droit. Vous pouvez y consulter le [**rapport Performance par partenaire**](/brand/fr/what-would-you-like-to-learn-about/platform-features/multi-program-reports/performance-reports-for-brands/performance-by-partner-report.md) , le **paramètres de suivi des partenaires**, ou la [**liste de contacts des partenaires**](/brand/fr/what-would-you-like-to-learn-about/platform-features/reach-out-to-partners/partner-management/get-partner-contact-information.md#view-all-partners-contact-information).
* Pour modifier plusieurs partenaires à la fois, sélectionnez **Modification en bloc** et téléversez votre fichier Excel ou CSV. Consultez [Modifier plusieurs partenaires dans un groupe](/brand/fr/what-would-you-like-to-learn-about/platform-features/reach-out-to-partners/partner-groups/bulk-edit-partners-in-a-group.md#bulk-edit-partner-groups) pour plus d'informations.
3. Recherchez des partenaires à l'aide de la barre de filtre ci-dessous *Mes partenaires*.
* Consultez *la référence des filtres* ci-dessous pour plus d'informations.
4. Sélectionnez  **\[Colonnes]** pour ajouter des colonnes supplémentaires à la *Mes partenaires* .
* Consultez *référence des colonnes* ci-dessous pour en savoir plus sur les différentes colonnes.
5. Survolez un partenaire et sélectionnez  **\[Plus]** pour effectuer diverses actions pour chaque partenaire.
* Consultez la *référence des actions* ci-dessous pour voir ce que vous pouvez faire.
* Sinon, sélectionnez le nom d'un partenaire pour accéder au panneau latéral du partenaire. En savoir plus sur les [informations de base](/brand/fr/what-would-you-like-to-learn-about/performance-program/recruiting-partners/prospective-partners/view-prospective-partners.md#view-the-partner-s-basic-information-0-0), [propriétés et détails des médias](/brand/fr/what-would-you-like-to-learn-about/performance-program/recruiting-partners/prospective-partners/view-prospective-partners.md#view-the-partner-s-media-properties-and-details-0-1).
la référence des filtres
| Filtre | Description |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Barre de recherche | Filtrez vos partenaires en recherchant leur nom, leur ID partenaire unique ou leur URL. |
| Statut du contrat | Filtrez vos partenaires selon qu'ils soient dans un état *Actif*, *Expiré*, ou *Suspendu* de la relation. |
| Groupes | Filtrez vos partenaires selon le groupe de partenaires spécifique auquel ils sont attribués. |
| Contrat | Filtrez les partenaires selon le type de contrat auquel ils ont souscrit. |
| Mises à jour des conditions | Filtrez vos partenaires en fonction des mises à jour apportées à leurs conditions, par exemple les partenaires qui ont *des propositions en attente*, ou les partenaires dont les contrats ont *récemment expiré*. |
| Type de relation | Filtrez les partenaires qui ont soit noué un partenariat direct avec vous, soit un partenariat via la place de marché. |
| Pays | Filtrez les partenaires selon le pays d'où ils proviennent. |
| État/Province | Filtrez les partenaires selon l'État ou la province d'où ils proviennent. |
Référence des colonnes
| Colonne | Description |
| ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Accès |
Cette colonne fournit une URL qui accorde un accès temporaire au compte du partenaire.
Vous ne pouvez accéder au compte de votre partenaire que s'il a uniquement rejoint votre programme via un lien d'inscription direct. Contactez l'assistance si vous souhaitez activer cette option.
|
| Partenaire | Le nom unique, l'ID et la localisation du partenaire figurent dans cette colonne. |
| Partenaire direct | Affiche un  **\[Coche]** si un partenaire est directement en partenariat avec vous, par opposition à un partenaire ayant rejoint via la place de marché. |
| Groupes | Affiche une liste d'étiquettes indiquant les différents groupes auxquels le partenaire est associé. |
| Contrat | Les différents contrats auxquels le partenaire est actuellement lié. |
| Date d'inscription | Affiche la date à laquelle le partenaire a rejoint votre programme. |
| Rapport | Sélectionnez le  **\[Graphique]** pour afficher le rapport de performance d'un partenaire particulier. |
référence des actions
| Action | Description |
| ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Notes |
Note: Nous vous recommandons d'utiliser le journal d'activité dans le panneau latéral du partenaire plutôt que cette action.
|
| Contrat | Cette action vous permet de choisir parmi une gamme d'actions associées au contrat entre vous et le partenaire. Pour en savoir plus, consultez la [section contrats](/brand/fr/what-would-you-like-to-learn-about/platform-features/contracts-and-template-terms/contracts.md) . |
| Suivi | Cette action vous offre un ensemble d'options liées au suivi des événements entre vous et le partenaire. Pour en savoir plus, consultez la [section suivi](/brand/fr/what-would-you-like-to-learn-about/platform-features/tracking/tracking-explained.md) . |
| Intégration du partenaire | Cette action vous permet d'aider vos partenaires à configurer soit des pixels de suivi partenaires, soit des postbacks (voir l'article d'aide destiné aux partenaires sur [les postbacks](/partner/fr/que-souhaitez-vous-apprendre/platform-features/action-management/event-notifications-and-postbacks/introduction-to-postbacks-for-partners.md) pour en savoir plus) afin de synchroniser les données d'événements avec le système du partenaire. |
| Responsable de compte |
Cette action vous permet de spécifier un responsable de compte pour le partenaire sélectionné et de rendre les coordonnées disponibles pour les partenaires directs.
Note: Nous vous recommandons d'utiliser le champ Affecté à dans le panneau latéral du partenaire plutôt que cette action.
|
| Paramètres de coût client | Cette action vous permet d'activer les coûts client pour le partenaire. Sélectionnez ici leur type de coût par défaut et les exceptions du suivi d'action. |
| Paramètres de conformité | Cette action vous permet de personnaliser les calendriers de révision et les taux d'audit. Vous pouvez remplacer la fréquence du calendrier de révision d'un partenaire ainsi que la fréquence de ses audits. |
| Gérer les liens de compte | Cette action vous permet de superviser et d'ajuster les relations entre les comptes partenaires connectés, y compris pourquoi et comment ils sont liés. |
| Message | Cette action ouvre la fenêtre de chat. Depuis cette fenêtre, vous pouvez envoyer un message au partenaire. |
{% endtab %}
{% tab title="Nouvel écran Mes partenaires" %}
1. Dans le menu de navigation de gauche, sélectionnez  **\[Engage] → Partenaires →** [**Partenaires**](https://app.impact.com/secure/advertiser/engage/mediapartners/view-mediapartners-flow.ihtml).
* Si vous avez un programme de créateurs, consultez [Gérer vos créateurs](/brand/fr/what-would-you-like-to-learn-about/creator-program/working-with-creators/manage-your-creators.md).
2. Dans le coin supérieur droit, vous pouvez effectuer les actions suivantes :
* Pour afficher le [**rapport Performance par partenaire**](/brand/fr/what-would-you-like-to-learn-about/platform-features/multi-program-reports/performance-reports-for-brands/performance-by-partner-report.md) rapport, sélectionnez  **\[Icône de graphique de rapport]** dans le coin supérieur droit.
* Sélectionnez  **\[Plus]** pour :
* **Exporter la liste des partenaires.**
* Accédez à vos **paramètres de suivi des partenaires.**
* Accédez à l'ancien écran en sélectionnant **Revenir à l'ancienne interface**. Consultez l' [Ancien écran Mes partenaires](#legacy-my-partners-screen) onglet.
3. Recherchez des partenaires à l'aide de la barre de filtre ci-dessous *Mes partenaires*.
* Consultez *la référence des filtres* ci-dessous pour plus d'informations.
4. Sélectionnez  **\[Colonnes]** pour ajouter des colonnes supplémentaires à la *Mes partenaires* .
* Consultez *référence des colonnes* ci-dessous pour en savoir plus sur les différentes colonnes.
5. Pour voir les données de performance d'un partenaire, survolez un partenaire et sélectionnez **Performance**.
1. Depuis ici, vous pouvez suivre les performances selon diverses catégories, notamment les types d'événements, les annonces, les codes promotionnels et les tendances mensuelles.
6. Survolez un partenaire et sélectionnez  **\[Plus]** pour effectuer diverses actions pour chaque partenaire.
* Consultez la *référence des actions* ci-dessous pour voir ce que vous pouvez faire.
* Sinon, sélectionnez le nom d'un partenaire pour accéder au panneau latéral du partenaire. En savoir plus sur les [informations de base](/brand/fr/what-would-you-like-to-learn-about/performance-program/recruiting-partners/prospective-partners/view-prospective-partners.md#view-the-partner-s-basic-information-0-0), [propriétés et détails des médias](/brand/fr/what-would-you-like-to-learn-about/performance-program/recruiting-partners/prospective-partners/view-prospective-partners.md#view-the-partner-s-media-properties-and-details-0-1).
7. Pour gérer plusieurs partenaires à la fois, consultez la [section de gestion groupée des partenaires](#partner-groups) ci-dessous pour connaître les actions groupées que vous pouvez appliquer.
la référence des filtres
| Filtre | Description |
| ----------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Barre de recherche** | Filtrez vos partenaires en recherchant leur nom, leur ID partenaire unique ou leur URL. |
| **Groupes** | Filtrez vos partenaires selon le groupe de partenaires spécifique auquel ils sont attribués. |
| **Étape du contrat** | Filtrez vos partenaires selon qu'ils soient dans un état *Actif* ou *Expiré* de la relation. |
| **Contrat** | Filtrez les partenaires selon le type de contrat auquel ils ont souscrit. |
| **Pays** | Filtrez les partenaires selon le pays d'où ils proviennent. |
| **Taille** | Filtrez les partenaires selon leur [taille](/brand/fr/what-would-you-like-to-learn-about/platform-features/reach-out-to-partners/partner-management/partner-size-rating-criteria.md#partner-size-scale). |
| **Champs personnalisés** | Filtrez les partenaires en fonction de leurs réponses aux [champs personnalisés de vos enquêtes](/brand/fr/what-would-you-like-to-learn-about/platform-features/reach-out-to-partners/surveys/create-custom-fields-for-surveys.md). |
| Sélectionnez  **\[Plus]** pour afficher des filtres supplémentaires |
Étape de la relation:
Filtrez les partenaires selon leur statut relationnel avec vous :
Nouveau - Partenaires que vous avez tagués comme prospects, mais auxquels vous n'avez pas encore envoyé d'e-mail ni de proposition.
Contactés par message, à condition qu'ils ne soient pas déjà prospects.
En négociation - Partenaires sans contrat accepté, y compris ceux en attente d'une décision, ceux qui n'ont pas accepté votre proposition, ceux qui ont fait une contre-proposition à votre proposition, et ceux dont vous avez fait une contre-proposition à la candidature.
Rejoint - Partenaires ayant rejoint votre programme.
Expiré - Partenaires dont les contrats ont expiré.
Modèle économique: Filtrez les partenaires selon le type d'activité qu'ils exercent, comme la fidélité, l'e-mail ou les coupons.
Affecté à: Filtrez les partenaires selon l'utilisateur du compte chargé de les gérer ou de négocier avec eux.
Source de prospection:
Filtrez les partenaires selon la source à partir de laquelle ils ont été prospectés, par exemple :
Candidatures : Prospects agrégés à partir d'applications externes. Cela inclut à la fois les candidatures directes et les partenaires ayant postulé via la place de marché de la marque.
Place de marché: Prospects agrégés à partir de la place de marché des partenaires.
Recherche étendue: Prospects identifiés grâce aux fonctionnalités de recherche étendue.
Impact AI: Prospects agrégés par les outils Impact AI.
Messagerie : Prospects agrégés via la fonctionnalité de messagerie intégrée d'impact.com.
Recommandé par le personnel : Prospects personnalisés pour vous par votre CSM.
Import de prospects: Prospects importés à l'aide de la fonctionnalité Import de prospects.
Recherche de créateurs: Prospects identifiés via la fonctionnalité de recherche de créateurs.
Autre : Prospects non agrégés par aucune des sources ci-dessus.
Zones promotionnelles: Filtrez les partenaires selon les emplacements où se trouve leur audience.
Cette colonne fournit une URL qui accorde un accès temporaire au compte du partenaire.
Vous ne pouvez accéder au compte de votre partenaire que s'il a uniquement rejoint votre programme via un lien d'inscription direct. Contactez l'assistance si vous souhaitez activer cette option.
|
| Partenaire | Le nom unique, l'ID et la localisation du partenaire figurent dans cette colonne. |
| Groupes | Affiche une liste d'étiquettes indiquant les différents groupes auxquels le partenaire est associé. |
| Contrat | Les différents contrats auxquels le partenaire est actuellement lié. |
| Pays | Le pays dans lequel le partenaire est situé. |
| Taille | Le [taille](/brand/fr/what-would-you-like-to-learn-about/platform-features/reach-out-to-partners/partner-management/partner-size-rating-criteria.md#partner-size-scale). |
| e-mail | L'adresse e-mail du partenaire. |
| Date d'inscription | Affiche la date à laquelle le partenaire a rejoint votre programme. |
| Propriétés média | Les propriétés média connectées du partenaire, telles que ses comptes de réseaux sociaux et ses sites Web. |
| Modèle économique | Le type d'activité exercée par le partenaire, comme la fidélité, l'e-mail ou les coupons. |
| Portée sociale | La présence sociale totale du partenaire, basée sur les nombres d'abonnés sur l'ensemble des propriétés de réseaux sociaux. |
| Partenaire direct | Affiche un  **\[Coche]** si un partenaire est directement en partenariat avec vous, par opposition à un partenaire ayant rejoint via la place de marché. |
| Date de candidature à la place de marché | La date de candidature du partenaire à la place de marché. |
| Pays de l'audience | L'endroit où se situe l'audience du partenaire. |
| ID partenaire | Le numéro d'identification impact.com du partenaire. |
| Affecté à | L'utilisateur du compte de marque auquel le partenaire est affecté. |
| Description | La description de profil du partenaire. |
| Zones promotionnelles | Ce sont les emplacements ou pays dans lesquels le partenaire fait la promotion. |
| Nom du contact | Une liste de personnes de contact que vous pouvez contacter si vous souhaitez envoyer un message ou proposer un contrat. |
| Adresse | L'adresse physique du partenaire. |
| Autorité de domaine Moz | Indique la probabilité qu'un site Web se classe plus haut dans les résultats de recherche. Plus le score est élevé, plus le potentiel de classement est fort. |
| Catégories | Ce sont des catégories de contenu dérivées des associations historiques de marque du partenaire. Lorsqu'un partenaire travaille avec une marque, il hérite de la structure de catégories de cette marque. |
| Source de prospection |
Où vous avez initialement trouvé ce partenaire.
Candidatures
Prospects agrégés à partir d'applications externes. Cela inclut à la fois les candidatures directes et les partenaires ayant postulé via la place de marché de la marque.
Prospects identifiés via la fonctionnalité de recherche de créateurs.
Autre
Prospects non agrégés par aucune des sources ci-dessus.
|
| Champs personnalisés | Les réponses du partenaire aux champs personnalisés de votre enquête. Chaque champ personnalisé peut être ajouté en tant que colonne distincte. |
référence des actions
| Action | Description |
| ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Contrat | Cette action vous permet de choisir parmi une gamme d'actions associées au contrat entre vous et le partenaire. Pour en savoir plus, consultez la [section contrats](/brand/fr/what-would-you-like-to-learn-about/platform-features/contracts-and-template-terms/contracts.md) . |
| Suivi | Cette action vous offre un ensemble d'options liées au suivi des événements entre vous et le partenaire. Pour en savoir plus, consultez la [section suivi](/brand/fr/what-would-you-like-to-learn-about/platform-features/tracking/tracking-explained.md) . |
| Inviter à ma campagne | Cette action vous permet d'inviter le partenaire à une campagne spécifique. |
| Inviter à mon enquête | Cette action vous permet d'inviter le partenaire à une enquête spécifique. |
| Intégration du partenaire | Cette action vous permet d'aider vos partenaires à configurer soit des pixels de suivi partenaires, soit des postbacks (voir l'article d'aide destiné aux partenaires sur [les postbacks](/partner/fr/que-souhaitez-vous-apprendre/platform-features/action-management/event-notifications-and-postbacks/introduction-to-postbacks-for-partners.md) pour en savoir plus) afin de synchroniser les données d'événements avec le système du partenaire. |
| Paramètres de coût client | Cette action vous permet d'activer les coûts client pour le partenaire. Sélectionnez ici leur type de coût par défaut et les exceptions du suivi d'action. |
| Paramètres de conformité | Cette action vous permet de personnaliser les calendriers de révision et les taux d'audit. Vous pouvez remplacer la fréquence du calendrier de révision d'un partenaire ainsi que la fréquence de ses audits. |
| Responsable de compte |
Cette action vous permet de spécifier un responsable de compte pour le partenaire sélectionné et de rendre les coordonnées disponibles pour les partenaires directs.
Note: Nous vous recommandons d'utiliser le champ Affecté à dans le panneau latéral du partenaire plutôt que cette action.
|
| Gérer les liens de compte | Cette action vous permet de superviser et d'ajuster les relations entre les comptes partenaires connectés, y compris pourquoi et comment ils sont liés. |
| Message | Cette action ouvre la fenêtre de chat. Depuis cette fenêtre, vous pouvez envoyer un message au partenaire. |
### section de gestion groupée des partenaires
{% hint style="success" %}
**Note**: La disponibilité de ces actions groupées dépend des autorisations du compte utilisateur.
{% endhint %}
Depuis le nouvel *Mes partenaires* écran, vous pouvez effectuer des actions groupées sur plusieurs partenaires simultanément. Pour commencer une action groupée :
1. Survolez les partenaires que vous souhaitez modifier et sélectionnez les  **\[cases non cochées]** à côté de leurs noms.
* Sinon, sélectionnez  **\[case non cochée]** **Tout sélectionner** pour apporter des modifications à tous vos partenaires.
2. Sélectionnez l'action souhaitée parmi les options disponibles sous les filtres. Consultez les onglets ci-dessous pour savoir comment effectuer l'action souhaitée.
{% tabs %}
{% tab title="Groupes de partenaires" %}
Modifiez les groupes auxquels vos partenaires sont attribués.
1. Sélectionnez **Modifier les groupes \**  **\[Menu déroulant]**. Dans ce menu déroulant, vous pouvez effectuer l'une des actions suivantes :
1. Attribuer à un groupe : Sélectionnez le  **\[case non cochée]** à côté du groupe souhaité ou sélectionnez **Tout sélectionner** pour les attribuer à tous les groupes.
2. Supprimer d'un groupe : Désélectionnez la  **\[case cochée]** à côté du nom du groupe, ou sélectionnez **Effacer** pour les supprimer de tous les groupes.
2. Sélectionnez **Appliquer** **→ Confirmer**.
{% hint style="success" %}
**Note**: Les mises à jour peuvent ne pas être visibles immédiatement. Veuillez attendre quelques minutes avant d'actualiser votre navigateur.
{% endhint %}
{% endtab %}
{% tab title="Attribuer des responsables de compte" %}
Attribuez en bloc des partenaires à des responsables de compte spécifiques.
1. Sélectionnez **Affecté à** pour ouvrir la liste déroulante des responsables de compte.
2. Choisissez le responsable de compte auquel vous souhaitez attribuer les partenaires.
3. Sélectionnez **Appliquer** **→ Confirmer**.
{% hint style="success" %}
**Note**: Les mises à jour peuvent ne pas être visibles immédiatement. Veuillez attendre quelques minutes avant d'actualiser votre navigateur.
{% endhint %}
{% endtab %}
{% tab title="Envoyer un e-mail aux partenaires" %}
Envoyer des e-mails groupés aux partenaires.
1. Sélectionnez **e-mail**.
2. Renseignez les détails de l'e-mail dans la fenêtre contextuelle.
3. Sélectionnez **Envoyer**.
{% endtab %}
{% tab title="Mettre à jour les contrats" %}
Mettre à jour en bloc les contrats de vos partenaires.
1. Sélectionnez **Contrat.**
2. Choisissez l'une des options suivantes :
* **Passer au contrat existant**
* **Passer au nouveau contrat**
* **Suspendre**
* [**Faire expirer**](/brand/fr/what-would-you-like-to-learn-about/platform-features/contracts-and-template-terms/contracts/expire-partner-contracts.md#expire-a-partner-contract)
* [**Modifier les paramètres**](/brand/fr/what-would-you-like-to-learn-about/platform-features/contracts-and-template-terms/contracts/revert-a-partner-contract-switch-or-expiry.md)
{% endtab %}
{% endtabs %}
{% endtab %}
{% endtabs %}
---
# 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://help.impact.com/brand/fr/what-would-you-like-to-learn-about/platform-features/reach-out-to-partners/partner-management/manage-my-partners.md?ask=&goal=
```
`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.