> 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/pt-br/what-would-you-like-to-learn-about/platform-features/contracts-and-template-terms/template-terms/set-and-manage-template-terms-rules.md).

# Definir e gerenciar regras de termos de modelo

<a href="https://pxa.impact.com/student/activity/1117596?sid=0c0e3e5c-54c9-4435-9bee-ebcdccb7f292&#x26;sid_i=0?utm_source=app.impact.com&#x26;utm_medium=owned-platform&#x26;utm_content=con-350&#x26;utm_campaign=help-center" class="button primary">Faça o curso PXA</a>

*Regras do contrato* pode ser usado para estabelecer regras unificadas em todos os termos de modelo criados na sua conta. Quando uma regra está ativada, todo novo termo de modelo criado na sua conta herdará essa regra.

{% hint style="info" %}
**Observação:** Somente usuários da conta com as [permissões necessárias](/brand/pt-br/what-would-you-like-to-learn-about/account-administration/account-settings/invite-and-manage-users/understanding-user-management-as-a-brand.md) terão acesso a esta seção.
{% endhint %}

1. Na barra de navegação superior, selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2F210dEQa93qyQgoJDkieL%2FUser%20profile.svg?alt=media\&token=f84c5b17-fae4-4a30-990a-9de5e57a150b) **\[Perfil do usuário] → Configurações**.
2. À esquerda, em *Geral* seção, selecione **Regras do termo de modelo**.
3. Para ativar e configurar uma definição e aplicá-la a todos os seus termos de modelo, selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FiZjM1xY8o3v1iR3Zaysd%2FToggle.svg?alt=media\&token=b1550d48-bba9-4e81-8604-bc12370c5caa) **\[Ativar]**, faça suas alterações e, em seguida, selecione **Salvar**.
   * Consulte a seção abaixo para mais informações sobre como configurar regras de termo de modelo.

<details>

<summary>Aplicação da regra</summary>

|                                                           |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| --------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Aplicação das regras**                                  | Ativar esta configuração garante que outros termos de modelo sigam essas regras (aplicadas somente ao criar ou modificar um termo de modelo).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| **Restringir a modificação de termos de modelo**          | Ative esta configuração para permitir que somente usuários com a permissão de conta Administrador de Termos de Modelo modifiquem os termos de modelo selecionados. Selecione os termos de modelo aos quais você quer aplicar esta restrição digitando o nome do termo de modelo e, em seguida, selecionando-o na lista suspensa.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| **Restringir o gerenciamento de contratos por parceiros** | <p>Ative esta configuração para impor mais restrições contratuais aos parceiros:</p><p>• Selecione <img src="https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FwXho9QKP3e4iU4ZKUSJ5%2F167ebb8cc30303.svg?alt=media&amp;token=a046e9f0-63aa-46f6-8a35-f73973fd326c" alt=""> <strong>\[Caixa de seleção]</strong> <strong>Não permitir que parceiros proponham novos contratos</strong> para restringir os parceiros de propor novos termos contratuais.</p><p>• Selecione <img src="https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FwXho9QKP3e4iU4ZKUSJ5%2F167ebb8cc30303.svg?alt=media&amp;token=a046e9f0-63aa-46f6-8a35-f73973fd326c" alt=""> <strong>\[Caixa de seleção]</strong> <strong>Não permitir que parceiros encerrem contratos</strong> para restringir os parceiros de encerrar contratos.</p> |

</details>

<details>

<summary>Tipo de evento</summary>

Quando ativado, escolha uma das seguintes configurações para [bloqueio sem prazo definido](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/actions-and-payouts/open-ended-locking-explained.md):

* ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-590bdf4e1ffbcc1fe86ad456bebab6a28c64af1f%2Ffd6e4291628446bb1fe27a831f7874b256a28cc84833d72cce2e73b94641edb7.svg?alt=media) **\[Botão de opção]** **Ativar bloqueio sem prazo definido:** Você não conseguirá desativar o bloqueio sem prazo definido para nenhum tipo de evento individual.
* ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-590bdf4e1ffbcc1fe86ad456bebab6a28c64af1f%2Ffd6e4291628446bb1fe27a831f7874b256a28cc84833d72cce2e73b94641edb7.svg?alt=media) **\[Botão de opção]** **Não ativar bloqueio sem prazo definido:** Você não conseguirá ativar o bloqueio sem prazo definido para nenhum tipo de evento individual.

{% hint style="warning" %}
**Importante:** Quando você ativar *Aplicação da regra*, qualquer outro usuário da conta *sem* as permissões necessárias não conseguirá divergir das regras de bloqueio sem prazo definido.
{% endhint %}

</details>

<details>

<summary>Termo de Modelo</summary>

Consulte nosso [artigo de ajuda sobre criação de Termos de Modelo](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/contracts-and-template-terms/template-terms/create-template-terms.md) para mais ajuda com as configurações de termos de modelo.

|                                         |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| --------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Período de Notificação de Alteração** | <p>Padroniza o período padrão em dias em que os parceiros são notificados antes que as alterações contratuais entrem em vigor. Selecione o <img src="https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FwXho9QKP3e4iU4ZKUSJ5%2F167ebb8cc30303.svg?alt=media&amp;token=a046e9f0-63aa-46f6-8a35-f73973fd326c" alt=""> <strong>\[Caixa de seleção]</strong> para permitir que os usuários da conta alterem esta configuração por contrato.</p><p>Selecione <img src="https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FwXho9QKP3e4iU4ZKUSJ5%2F167ebb8cc30303.svg?alt=media&amp;token=a046e9f0-63aa-46f6-8a35-f73973fd326c" alt=""> <strong>\[Caixa de seleção]</strong> <strong>Permitir que os usuários alterem o padrão</strong> para permitir que os usuários modifiquem a política de período de notificação de alteração de um termo de modelo, que, por padrão, terá a mesma política de reversão que a regra. Com esta regra ativada, você pode selecionar a segunda caixa de seleção para definir um número máximo de dias que os usuários da conta podem usar para o período de notificação de alteração.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| **Bloqueio de Ação**                    | <p>Use os campos e menus suspensos para definir seu período de bloqueio de ação para todos os contratos. <strong>Esta configuração é muito importante e está vinculada ao financiamento da sua conta!</strong></p><p>Selecione <img src="https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FwXho9QKP3e4iU4ZKUSJ5%2F167ebb8cc30303.svg?alt=media&amp;token=a046e9f0-63aa-46f6-8a35-f73973fd326c" alt=""> <strong>\[Caixa de seleção]</strong> <strong>Permitir que os usuários alterem o padrão</strong> para permitir que os usuários modifiquem a política de bloqueio de ação de um termo de modelo, que, por padrão, terá a mesma política que a regra.</p><p><strong>Importante:</strong> Se você estiver em um tipo de financiador SOI, certas restrições de bloqueio de ação se aplicam. Consulte o <em>restrições contratuais</em> em <a href="/brand/pt-br/what-would-you-like-to-learn-about/platform-features/finance/add-funds-to-your-funding-account/funder-types-for-brands-explained.md">Tipos de Financiador para Marcas Explicados</a> para obter mais informações.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| **Agendamento de Pagamentos**           | <p>Use os campos e menus suspensos para definir seu período de agendamento de pagamentos, que é quando os parceiros receberão seus pagamentos da carteira da sua conta. <strong>Esta configuração é muito importante e está vinculada ao financiamento da sua conta!</strong></p><p>Selecione <img src="https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FwXho9QKP3e4iU4ZKUSJ5%2F167ebb8cc30303.svg?alt=media&amp;token=a046e9f0-63aa-46f6-8a35-f73973fd326c" alt=""> <strong>\[Caixa de seleção]</strong> <strong>Permitir que os usuários alterem o padrão</strong> para permitir que os usuários modifiquem a política de agendamento de pagamentos de um termo de modelo, que, por padrão, terá a mesma política que a regra.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| **Janela de Referência de Cliques**     | <p>Isso define o período em que um parceiro ainda pode receber crédito por uma ação.</p><p>Por exemplo, se um parceiro gerou um clique para sua loja virtual e o cliente ainda não compra nada, a janela de referência começa. Se o cliente retornar ao seu site dentro da janela de referência e comprar algo (ou seja, concluir uma ação ou "converter"), o parceiro receberá crédito por gerar essa ação.</p><p>Selecione <img src="https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FwXho9QKP3e4iU4ZKUSJ5%2F167ebb8cc30303.svg?alt=media&amp;token=a046e9f0-63aa-46f6-8a35-f73973fd326c" alt=""> <strong>\[Caixa de seleção]</strong> <strong>Permitir que os usuários alterem o padrão</strong> para permitir que os usuários modifiquem a política de janela de referência de cliques de um termo de modelo, que, por padrão, terá a mesma política que a regra.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| **Rastreamento de visualização**        | <p>Se você ainda estiver usando este recurso legado, pode configurar o período em que um parceiro pode receber crédito ou desativá-lo globalmente.</p><p>Selecione <img src="https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FwXho9QKP3e4iU4ZKUSJ5%2F167ebb8cc30303.svg?alt=media&amp;token=a046e9f0-63aa-46f6-8a35-f73973fd326c" alt=""> <strong>\[Caixa de seleção]</strong> <strong>Permitir que os usuários alterem o padrão</strong> para permitir que os usuários modifiquem a política de rastreamento de visualização de um termo de modelo, que, por padrão, terá a mesma política que a regra.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| **Pagamento**                           | <p>Este é o pagamento padrão aplicado a todos os termos de modelo se nenhum grupo de pagamento, ajuste, restrição ou bônus de desempenho se aplicar à ação:</p><p><strong>Percentual</strong> pagamento <strong>por pedido</strong> ou <strong>por item</strong> o valor da venda paga ao parceiro uma porcentagem da venda — seja do pedido inteiro ou com base por item.</p><p><strong>Fixo</strong> pagamento <strong>por pedido</strong> ou <strong>por item</strong> paga ao parceiro um pagamento fixo pelo valor do pedido ou pelos itens em uma ação.</p><p>Este é o pagamento que os parceiros verão no topo do seu termo de modelo.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| **Taxas de Posicionamento**             | Se você estiver definindo taxas de posicionamento em seus termos de modelo, poderá definir aqui um máximo global para todos os termos de modelo.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| **Garantias Mínimas de EPC**            | Se você estiver usando um tipo de evento CPC e definindo uma Garantia Mínima de EPC para parceiros, poderá definir aqui um valor global para todos os termos de modelo.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| **Política de Reversão**                | <p>Se você decidir reverter uma ação, esta configuração determina quanto do pagamento você pode receber. Suas opções incluem:</p><p>• <strong>\[Recomendado]</strong> <img src="https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-590bdf4e1ffbcc1fe86ad456bebab6a28c64af1f%2Ffd6e4291628446bb1fe27a831f7874b256a28cc84833d72cce2e73b94641edb7.svg?alt=media" alt=""> <strong>\[Botão de opção]</strong> <strong>O anunciante devolve até</strong> <strong>\<value> %</strong> <strong>de devoluções mensais máximas</strong>. Recomendamos escolher 100 para que você possa recuperar 100% do seu pagamento em caso de devolução do pedido, cancelamento ou fraude.</p><p>• <img src="https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-590bdf4e1ffbcc1fe86ad456bebab6a28c64af1f%2Ffd6e4291628446bb1fe27a831f7874b256a28cc84833d72cce2e73b94641edb7.svg?alt=media" alt=""> <strong>\[Botão de opção]</strong> <strong>Parceiro Aprova:</strong> O parceiro precisa aprovar quaisquer solicitações de reversão.</p><p>• <img src="https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-590bdf4e1ffbcc1fe86ad456bebab6a28c64af1f%2Ffd6e4291628446bb1fe27a831f7874b256a28cc84833d72cce2e73b94641edb7.svg?alt=media" alt=""> <strong>\[Botão de opção]</strong> <strong>Sem Devolução:</strong> Os parceiros nunca precisam devolver pagamentos por ações geradas.</p><p>Selecione <img src="https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FwXho9QKP3e4iU4ZKUSJ5%2F167ebb8cc30303.svg?alt=media&amp;token=a046e9f0-63aa-46f6-8a35-f73973fd326c" alt=""> <strong>\[Caixa de seleção]</strong> <strong>Permitir que os usuários alterem o padrão</strong> para permitir que os usuários modifiquem a política de reversão de um termo de modelo, que, por padrão, terá a mesma política de reversão que a regra. Com esta regra ativada, você pode impor um mínimo de <strong>\<amount></strong> % de devoluções mensais máximas. Você também pode escolher uma ou ambas as seguintes configurações:</p><p>• <img src="https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FwXho9QKP3e4iU4ZKUSJ5%2F167ebb8cc30303.svg?alt=media&amp;token=a046e9f0-63aa-46f6-8a35-f73973fd326c" alt=""> <strong>\[Caixa de seleção]</strong> <strong>Permitir acordos em que o parceiro aprova todas as devoluções</strong>: Permitir que todos os pedidos sejam aprovados pelo parceiro.</p><p>• <img src="https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FwXho9QKP3e4iU4ZKUSJ5%2F167ebb8cc30303.svg?alt=media&amp;token=a046e9f0-63aa-46f6-8a35-f73973fd326c" alt=""> <strong>\[Caixa de seleção]</strong> <strong>Permitir acordos em que as conversões não podem ser devolvidas</strong>: Permitir pedidos quando a política de reversão indicar que eles não podem ser devolvidos</p> |
| **Termos Personalizados do Parceiro**   | <p>Escolha entre as seguintes configurações para termos personalizados:</p><p>• <img src="https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-590bdf4e1ffbcc1fe86ad456bebab6a28c64af1f%2Ffd6e4291628446bb1fe27a831f7874b256a28cc84833d72cce2e73b94641edb7.svg?alt=media" alt=""> <strong>\[Botão de opção]</strong> <strong>Permitir que os parceiros incluam seus próprios termos personalizados</strong>: Permitir globalmente que os parceiros proponham seus próprios termos personalizados para seus termos de modelo propostos.</p><p>• <img src="https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-590bdf4e1ffbcc1fe86ad456bebab6a28c64af1f%2Ffd6e4291628446bb1fe27a831f7874b256a28cc84833d72cce2e73b94641edb7.svg?alt=media" alt=""> <strong>\[Botão de opção]</strong> <strong>Não permitir que os parceiros incluam seus próprios termos personalizados</strong>: Impedir globalmente que os parceiros proponham seus próprios termos personalizados para seus termos de modelo propostos.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |

</details>


---

# 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/pt-br/what-would-you-like-to-learn-about/platform-features/contracts-and-template-terms/template-terms/set-and-manage-template-terms-rules.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.
