> For the complete documentation index, see [llms.txt](https://manuais.farmaciadigital.saude.mg.gov.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://manuais.farmaciadigital.saude.mg.gov.br/programacao-e-aquisicao/atas-e-empenho/ata-de-registro-de-preco.md).

# Ata de Registro de Preço

## Caso de Uso

Descrição

| Permite cadastrar Ata de Registro de Preços. |
| -------------------------------------------- |

<br>

Precondições

| O Usuário deve possuir os perfis de Gestor Master, Administrativo SIGAF, Farmacêutico (SAF, Diretor Técnico, Municipal), Financeiro Municipal, Atendente Call Center (apenas visualização).O Usuário acessou o menu principal Programação e Aquisição> Ata e Empenho > Atas de Registro de Preço.Necessita ter um fornecedor, medicamento/produto, produto e produtos farmacêuticos cadastrados. |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

<br>

Fluxo principal

| <p>1. O SIGAF exibe a interface de usuário IU7.23 Pesquisar Ata de Registro de Preço .<br>{Pesquisar Fornecedor}{Pesquisar Medicamento / Produto}{Buscar Ata de Registro de Preço}{Adicionar Ata de Registro de Preço}<br>2. O fluxo principal termina.</p> |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

<br>

Fluxos alternativos

<br>

*Fluxo alternativo Buscar Ata de Registro de Preço*

| Precondições | O Usuário aciona o comando \[Buscar].                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Passos       | <ol><li>O SIGAF exibe a interface IU7.23 Pesquisar Ata de Registro de Preço .</li><li><p>O Usuário informa ou não os parâmetros de pesquisa e aciona o comando \[Buscar].</p><ol><li>Caso não exista registro para a busca realizada conforme parâmetros, o SIGAF retorna a mensagem MSGI001 Não existem registros a serem exibidos.</li><li>Caso exista o SIGAF retorna os registros na GRID de resultados.</li></ol></li></ol><p><br>{Exibir Ata de Registro de Preço}{Editar Ata de Registro de Preço}{Impressão de ATA (PDF)}{Renovação}{Excluir Ata de Registro de Preço}</p><ol start="3"><li>O fluxo alternativo termina.</li></ol> |

<br>

*Fluxo alternativo Fornecedor*

| Precondições | O Usuário deve estar logado no sistema e acionar a lupa do campo \<Fornecedor >.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Passos       | <ol><li>O SIGAF exibe a interface IU4.19 Pop up Pesquisar/Selecionar Fornecedor .</li><li><p>O Usuário informa ou não os parâmetros de pesquisa e aciona o comando \[Buscar].</p><ol><li>Caso não exista registro para a busca realizada conforme parâmetros, o SIGAF retorna a mensagem MSGI001 Não existem registros a serem exibidos.</li><li>Caso exista o SIGAF retorna os registros na GRID de resultados.</li></ol></li><li>O Usuário seleciona o Fornecedor.</li><li>O SIGAF retorna para o passo onde o do fluxo alternativo foi acionado.</li><li>Fluxo alternativo termina.</li></ol> |

<br>

*Fluxo alternativo Medicamento/Produto*

| Precondições | O Usuário deve estar logado no sistema e acionar a lupa do campo \<Medicamento/Produtor>.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Passos       | <ol><li>O SIGAF exibe a interface IU1.62 Pop up Pesquisar/Selecionar Medicamentos e Produtos (Denominação Genérica) (apenas 1) .</li></ol><p>{Buscar Fármaco}</p><ol start="2"><li><p>O Usuário informa ou não os parâmetros de pesquisa e aciona o comando \[Buscar].</p><ol><li>Caso não exista retorno para a busca realizada o SIGAF retorna a mensagem MSGI001 Não existem registros a serem exibidos. .</li><li>Caso exista, o SIGAF retorna os registros na GRID de resultados.</li></ol></li><li>O Usuário seleciona o Medicamento/Produto.</li><li>O SIGAF retorna para o passo onde o do fluxo alternativo foi acionado.</li><li>Fluxo alternativo termina</li></ol> |

<br>

*Fluxo alternativo Adicionar Ata de Registro de Preço*

| Precondições | O Usuário deve estar logado no sistema e acionar o comando \[Adicionar Ata de Registro de Preço].                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Passos       | <ol><li>O SIGAF existe a interface IU7.24 Manter Ata de Registro de Preço .</li></ol><p>{Buscar Fornecedor}{Buscar Medicamento}{Buscar Produto}{Cancelar}{Incluir listas de programação na ATA}</p><ol start="2"><li>O Usuário preenche os campos e aciona o comando \[Adicionar].</li><li><p>O SIGAF valida se os campos obrigatórios foram preenchidos.</p><ol><li>Caso negativo o SIGAF exibe as mensagens MSGA003 Formulário incompleto! Para prosseguir, preencha os itens destacados. É necessário inserir/selecionar \<nome do campo>. e  retorna para o passo 2 deste fluxo alternativo.</li></ol></li><li><p>O SIGAF valida a RNG7.48 Validar lista na ATA de Registro de preço .</p><ol><li>Caso exista mais de uma lista com o mesmo medicamento, e exista algum município com programação para estas listas, o SIGAF exibe a mensagem MSGE7.53 Verifique a programacao dos municipios \<xxxx>. medicamentos duplicados na lista \<xxxx> , e retorna para a passo 2 desse fluxo. </li></ol></li><li>O SIGAF salva as informações de acordo com as regras de negócio RNG7.04 Validação dos Campos na Ata de Registro de Preço , RNG7.09 Salvar Ata de Registro de Preço e RNG7.11 Cancelamento do Item em ATA , exibe a mensagem MSGI004 Os dados foram salvos com sucesso. e retorna para interface IU7.23 Pesquisar Ata de Registro de Preço .</li><li>O fluxo alternativo termina.</li></ol> |

<br>

Fluxo alternativo Incluir listas de programação na ATA

| Precondições | O Usuário informou no campo “Gerar saldo municipal” = SIM.O Usuário acionou o comando \[Listas de programação]                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Passos       | <ol><li>O SIGAF exibe a interface IU7.29 Pop up Pesquisar/Selecionar Lista de Medicamento .</li><li><p>O Usuário informa ou não os parâmetros de pesquisa e aciona o comando \[Buscar].</p><ol><li>Caso não exista retorno para a busca realizada o SIGAF retorna a mensagem MSGI001 Não existem registros a serem exibidos.</li><li>Caso exista, o SIGAF retorna os registros na GRID de resultados.</li></ol></li><li>O Usuário seleciona a Lista de Medicamentos.</li><li>O SIGAF retorna para o passo onde o do fluxo alternativo foi acionado.</li></ol> |

<br>

*Fluxo alternativo Exibir Ata de Registro de Preço*

| Precondições | O Usuário deve estar logado no sistema e acionar o comando \[Exibir].                                                                          |
| ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| Passos       | <ol><li>O SIGAF exibe a interface IU7.24 Manter Ata de Registro de Preço em modo de visualização.</li><li>Fluxo alternativo termina.</li></ol> |

<br>

*Fluxo alternativo Editar Ata de Registro de Preço*

| Precondições | O Usuário deve estar logado no sistema e acionar o comando \[Editar]Quando o campo Executar = Não poderá alterar todos os campos da Ata.Quando o campo Executar = Sim poderá alterar os campos Cancelado, Termo Aditivo, Ata Concluída se = Não e informar mais um Item na Ata.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Passos       | <ol><li>O SIGAF exibe a interface IU7.24 Manter Ata de Registro de Preço .</li><li>O Usuário altera os dados.</li></ol><p>{Trocar item}</p><ol start="3"><li>O Usuário aciona o comando \[Alterar].</li><li><p>O SIAGF valida se os campos obrigatórios foram preenchidos.</p><ol><li> Caso negativo o SIGAF exibe a mensagem MSGA003 Formulário incompleto! Para prosseguir, preencha os itens destacados. É necessário inserir/selecionar \<nome do campo>. e retorna para o passo 2 deste fluxo alternativo.</li></ol></li><li><p>O SIGAF valida a RNG7.48 Validar lista na ATA de Registro de preço .</p><ol><li>Caso exista mais de uma lista com o mesmo medicamento, e exista algum município com programação para estas listas, o SIGAF exibe a mensagem MSGE7.53 Verifique a programacao dos municipios \<xxxx>. medicamentos duplicados na lista \<xxxx> , e retorna para a passo 2 desse fluxo. </li></ol></li><li>O SIGAF salva as informações de acordo com a regra de negócio RNG7.04 Validação dos Campos na Ata de Registro de Preço , RNG7.09 Salvar Ata de Registro de Preço e exibe a mensagem  MSGI004 Os dados foram salvos com sucesso. e retorna para interface IU7.23 Pesquisar Ata de Registro de Preço .</li><li>O fluxo alternativo termina.</li></ol> |

<br>

*Fluxo alternativo Trocar item*

| Precondições | O Usuário deve estar logado no sistema e acionar o comando \[Trocar item]                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Passos       | <ol><li>O SIGAF exibe a interface IU7.55 Troca de Item em Ata .</li><li>O Usuário modifica os campos necessários.</li></ol><p>{Buscar Fornecedor}{Buscar Medicamento}</p><ol start="3"><li>O Usuário aciona o comando \[Trocar].</li><li><p>O SIGAF valida se os campos obrigatórios foram preenchidos.</p><ol><li> Caso negativo o SIGAF exibe a mensagem MSGA003 Formulário incompleto! Para prosseguir, preencha os itens destacados. É necessário inserir/selecionar \<nome do campo>. e retorna para o passo 2 deste fluxo alternativo.</li><li> Caso positivo o SIGAF salva as informações de acordo com a regra de negócio RNG7.46 Troca de Item em Ata . Retorna para interface IU7.24 Manter Ata de Registro de Preço riscando os dados do item anterior.</li></ol></li><li>O fluxo alternativo termina.</li></ol> |

<br>

*Fluxo alternativo Imprimir Ata(PDF)*

| Precondições | O Usuário deve estar logado no sistema e acionar o comando \[Imprimir Ata (PDF)].                                                                                 |
| ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Passos       | <ol><li>O SIGAF gera o PDF referente a Ata de Registro de Preço o layout da IU7.38 Ata de Registro de Preço - PDF .</li><li>O fluxo alternativo termina</li></ol> |

<br>

*Fluxo alternativo Excluir Ata de Registro de Preço*

| Precondições | O Usuário deve estar logado no sistema e acionar o comando \[Excluir].A Ata de Registro de Preço tem que estar com o campo Executar = NÃO.                                                                                                                                                                                                                                                                                                                                           |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Passos       | <ol><li><p>O SIGAF exibe a mensagem MSGA004 Você tem certeza que deseja excluir PERMANENTEMENTE este(a) \<Nome do registro>?</p><ol><li>Caso positivo o SIGAF exclui a Ata de Registro de Preço e permanece na interface IU7.23 Pesquisar Ata de Registro de Preço exibe a mensagem MSGI003 Registro excluído com sucesso.</li><li>Caso negativo o SIGAF permanece na interface IU7.23 Pesquisar Ata de Registro de Preço .</li></ol></li><li>O fluxo alternativo termina.</li></ol> |

<br>

*Fluxo alternativo Renovação*

| Precondições | O Usuário deve estar logado no sistema e acionar o comando \[Renovação]                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Passos       | <ol start="6"><li>O SIGAF exibe a interface IU7.24 Manter Ata de Registro de Preço de acordo com a regra de negócio RNG7.05 Renovação .</li><li>O Usuário modifica os campos necessários e aciona o comando \[Alterar].</li><li><p>O SIGAF valida se os campos obrigatórios foram preenchidos.</p><ol><li> Caso negativo o SIGAF exibe a mensagem MSGA003 Formulário incompleto! Para prosseguir, preencha os itens destacados. É necessário inserir/selecionar \<nome do campo>. e etorna para o passo 2 deste fluxo alternativo.</li><li> Caso positivo o SIGAF salva as informações de acordo com a regra de negócio RNG7.04 Validação dos Campos na Ata de Registro de Preço e NG7.11 Cancelamento do Item em ATA . Retorna para interface IU7.23 Pesquisar Ata de Registro de Preço e exibe a mensagem MSGI004 Os dados foram salvos com sucesso.</li></ol></li><li>O fluxo alternativo termina.</li></ol> |

<br>

*Fluxo alternativo Buscar Fármaco*

| Precondições | O Usuário deve estar logado no sistema e acionar o comando \[Fármaco].                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Passos       | <ol><li>O SIGAF exibe a interface IU1.36 Pop up Pesquisar/Selecionar Complemento Fármaco .</li><li><p>O Usuário informa ou não os parâmetros de pesquisa e aciona o comando \[Buscar].</p><ol><li>Caso não exista registro para a busca realizada o SIGAF retorna mensagem MSGI001 Não existem registros a serem exibidos.</li><li>Caso exista o SIGAF retorna os registros na GRID de resultados.</li></ol></li><li>O Usuário seleciona o Fármaco que deseja adicionar ou pesquisar.</li><li>O SIGAF retorna para o fluxo alternativo onde foi acionado.</li><li>Fluxo alternativo termina.</li></ol> |

<br>

*Fluxo alternativo Buscar Produto*

| Precondições | O Usuário deve estar logado no sistema e acionar a lupa do campo \<Produto>.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Passos       | <ol><li>O SIGAF exibe a interface IU1.100 Pop up Pesquisar/Selecionar Produto (apenas 1) .</li><li><p>O Usuário informa ou não os parâmetros de pesquisa e aciona o comando \[Buscar].</p><ol><li>Caso não exista registro para a busca realizada  o SIGAF retorna mensagem MSGI001 Não existem registros a serem exibidos.</li><li>Caso exista o SIGAF retorna os registros na GRID de resultados.</li></ol></li><li>O Usuário seleciona o Produto que deseja adicionar ou pesquisar.</li><li>O SIGAF retorna para o fluxo alternativo onde foi acionado.</li><li>Fluxo alternativo termina.</li></ol> |

<br>

*Fluxo alternativo Buscar Medicamento*

| Precondições | O Usuário deve estar logado no sistema e acionar a lupa do campo \<Fármaco>.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Passos       | <ol><li>O SIGAF exibe a interface IU4.24 Pop-up Pesquisar/Selecionar Estoque (apenas 1) .</li></ol><p>{Buscar Forma de Apresentação}{Buscar Fármaco}</p><ol start="2"><li><p>O Usuário informa ou não os parâmetros de pesquisa e aciona o comando \[Buscar].</p><ol><li>Caso não exista registro para a busca realizada o SIGAF retorna mensagem MSGI001 Não existem registros a serem exibidos.</li><li>Caso exista o SIGAF retorna os registros na Grid de resultados.</li></ol></li><li>O Usuário seleciona o medicamento que deseja adicionar ou pesquisar.</li><li>O SIGAF retorna para o fluxo alternativo onde foi acionado.</li><li>Fluxo alternativo termina.</li></ol> |

<br>

*Fluxo alternativo Buscar Forma de Apresentação*

| Precondições | O Usuário deve estar logado no sistema e acionar a lupa do campo \<Forma de Apresentação>.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Passos       | <ol><li>O SIGAF exibe a interface IU1.62 Pop up Pesquisar/Selecionar Medicamentos e Produtos (Denominação Genérica) (apenas 1) .</li><li><p>O Usuário informa ou não os parâmetros de pesquisa e aciona o comando \[Buscar].</p><ol><li>Caso não exista registro para a busca realizada o SIGAF retorna mensagem MSGI001 Não existem registros a serem exibidos.</li><li>Caso exista o SIGAF retorna os registros na Grid de resultados.</li></ol></li><li>O Usuário seleciona a forma de apresentação que deseja adicionar ou pesquisar.</li><li>O SIGAF retorna para o fluxo alternativo onde foi acionado.</li><li>Fluxo alternativo termina.</li></ol> |

<br>

*Fluxo alternativo Cancelar*

| Precondições | O Usuário alterou o campo \[Cancelar] = Não                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Passos       | <ol><li><p>O SIGAF valida a regra de negócio RNG7.12 Duplicação do Item em ATA .</p><ol><li>Caso negativo o SIGAF exibe a mensagem MSGA7.30 Não é possível colocar o item como não cancelado, pois já possui um mesmo medicamento/produto que não está cancelado nessa ata. E permanece na IU7.24 Manter Ata de Registro de Preço com o campo Cancelado = SIM.</li><li>Caso positivo o SIGAF mantem o campo Cancelado = Não.</li></ol></li><li>O fluxo alternativo termina.</li></ol> |

<br>

Observações

| Não se aplica. |
| -------------- |

<br>

Critérios de aceitação do requisito

|   | Item a ser cumprido                                                                                                                                                                                       | Sim | Não | Não se aplica |
| - | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-: | :-: | ------------- |
| 1 | A descrição do caso de uso mostra com clareza qual a funcionalidade que será especificada e seu objetivo?                                                                                                 |     |     |               |
| 2 | Considerando que a cada desvio que há em um fluxo (fluxo alternativo, subfluxo ou caso de uso), após o seguirmos e retornarmos ao ponto onde estávamos, o fluxo principal inicia e termina o caso de uso? |     |     |               |
| 3 | O fluxo principal executa algo relevante para o usuário (uma consulta, por exemplo)?                                                                                                                      |     |     |               |
| 4 | Os atributos das interfaces de usuário do caso de uso estão presentes nas classes apresentadas no diagrama de classes?                                                                                    |     |     |               |
| 5 | Todas as regras de negócio referentes ao caso de uso foram utilizadas adequadamente por ele?                                                                                                              |     |     |               |
| 6 | A comunicação direta com outro sistema (caso exista) está presente no Diagrama de Contexto ou no Diagrama de Caso de Uso?                                                                                 |     |     |               |
| 7 | O dicionário de classes foi utilizado no caso de uso explorando todo o seu potencial?                                                                                                                     |     |     |               |
| 8 | Os requisitos não funcionais relativos a esse caso de uso foram identificados?                                                                                                                            |     |     |               |


---

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

```
GET https://manuais.farmaciadigital.saude.mg.gov.br/programacao-e-aquisicao/atas-e-empenho/ata-de-registro-de-preco.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.
