> For the complete documentation index, see [llms.txt](https://help.sesami.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.sesami.co/pt/comecar/quickstart.md).
# Início rápido
## O que vai configurar
* **Serviços** - Produtos Shopify que representam serviços reserváveis
* **Recursos** - Membros da equipa, salas, equipamento ou outros recursos necessários para prestar serviços
* **Disponibilidade** - Horário de trabalho e regras de agendamento dos recursos
* **Integração na loja online** - Botões de reserva e calendário na sua loja online
{% hint style="info" %}
**Tempo estimado**: 15-30 minutos para uma configuração básica com um serviço e um membro da equipa.
{% endhint %}
### Antes de começar
Certifique-se de que tem:
* **Acesso de administrador** na sua loja Shopify
* **Uma lista de serviços** que pretende oferecer:
* Nome do serviço (por exemplo, "Massagem de 60 minutos", "Tosquia de cães")
* Duração (por exemplo, 30 minutos, 1 hora, 2 horas)
* Preço
* **Informações dos recursos**:
* Nomes dos membros da equipa e respetivo horário de trabalho
* Requisitos de sala ou equipamento (se aplicável)
{% stepper %}
{% step %}
### **Adicionar serviço ao Sesami**
**Pode criar um serviço diretamente no Sesami ou adicionar um produto existente da Shopify.**
#### **- no Sesami**
1. Introduza um **título** (por exemplo, "Corte de cabelo", "Massagem", "Consulta")
Mantenha o título simples - isto aparece nas confirmações de reserva e nos calendários
2. Adicione a **descrição**
3. Adicione **a variante "duração", unidade,** e **preço**\
Crie variantes como "30 minutos", "1 hora", "90 minutos"
4. Clique para **criar o serviço**
#### **- na Shopify**
1. No administrador da Shopify, vá para **Produtos > Adicionar produto**
2. Introduza um título de produto claro que descreva o serviço, como *Corte de cabelo*, *Massagem*, ou *Consulta*
3. Clique em **Adicionar variante** e crie a "**variante "Duração"** e as respetivas opções, como *30 minutos*, *1 hora*, ou *90 minutos*
4. Defina um preço para cada opção de duração
5. Clique em **Guardar** para criar o produto
Repita para cada tipo de serviço que pretenda oferecer.
{% hint style="success" %}
**Melhor prática**: Use variantes para diferentes durações do mesmo serviço. Por exemplo, um produto "Massagem" com variantes "30 minutos", "1 hora" e "90 minutos" em vez de três produtos separados.
{% endhint %}
{% endstep %}
{% step %}
### **Crie recursos e defina a disponibilidade**
Os recursos são o que o seu serviço necessita para acontecer - membros da equipa, salas, equipamento, etc. Irá criá-los e definir a sua disponibilidade.
{% hint style="info" %}
**Nota**: Na interface atual do administrador da Shopify, os recursos estão rotulados como "Team Members". Isto será atualizado para "Resources" numa próxima versão.
{% endhint %}
1. Adicione a **Recurso** nome e o **Tipo de recurso**
* Para a equipa: adicione cada membro pelo nome (por exemplo, "Sarah", "Alex", "Jamie")
* Para salas/equipamento: adicione-os como membros da equipa por enquanto (por exemplo, "Sala 1", "Kit de Câmara A")
2. Defina o seu **Horário de trabalho** e adicione as regras de disponibilidade (por exemplo, segunda a sexta, 9:00 - 17:00)
3. **Clique para criar o recurso**
**Exemplo de configuração:**
* Membro da equipa "Sarah" → Disponível de segunda a sexta, 9:00 - 17:00
* Sala "Sala de Tratamento 1" → Disponível de segunda a sábado, 8:00 - 20:00
{% hint style="info" %}
**É bom saber:** Não se preocupe se ainda não tiver configurado todos os seus recursos. Pode definir agora a disponibilidade de um único recurso e depois criar recursos adicionais ou atualizar a disponibilidade de recursos existentes mais tarde em [**Portal de administração: Recursos**](/pt/administracao/resources.md).
{% endhint %}
{% endstep %}
{% step %}
### **Adicione uma reserva à sua loja online**
Torne o calendário de reservas acessível aos clientes na sua loja online
**Incorporação da app no tema (Recomendado - Temas modernos) - A maioria dos temas Shopify 2.0 suporta incorporações de apps**
{% hint style="info" %}
**Opcional:** Se estiver a usar um tema Shopify mais antigo, uma loja headless (como o Hydrogen) ou um website personalizado, pode saltar este passo e consultar os nossos [Docs de desenvolvimento](https://sesami.dev/docs/sesami-experience/shopify-integration/intro/) para instruções de integração.
{% endhint %}
#### **Passo 1: Ativar a incorporação da app**
1. No painel do Sesami, clique em **Personalizar tema** na secção **Incorporar experiência de reserva** .
2. Abrirá o editor de temas com o **Incorporações de apps** painel (normalmente na barra lateral esquerda ou nas definições do tema)
3. Localize a **Sesami Booking App** e ative o interruptor para permitir que a app seja incorporada no seu tema.
4. **Guardar**
#### **Passo 2: Adicionar ao produto**
1. De seguida, adicione o bloco de reserva Sesami ao seu modelo de produto, abrindo um modelo de produto
2. Na **Informações do produto** secção, clique em **Adicionar bloco** e selecione o **botão de reserva Sesami**
3. Coloque o bloco acima dos botões de compra
4. **Guardar** as alterações do tema.
O widget de reserva aparecerá agora nas páginas de produto da sua loja online, permitindo que os clientes selecionem horários de reserva disponíveis.
{% hint style="info" %}
**Integração manual (temas antigos)**
Para temas mais antigos sem suporte para incorporação de apps:
1. No editor do tema, adicione um botão ou link às páginas de produto
2. Crie uma ligação para a página de produto com o calendário do Sesami ativo
3. Ou contacte o suporte para obter ajuda de integração específica do tema
Ver: [Configuração da loja online Shopify](/pt/apps-integrations/shopify/online-store.md)
{% endhint %}
{% hint style="success" %}
**Dica profissional**: Adicione um link de navegação "Reservar agora" no seu menu principal a apontar para uma coleção de todos os serviços reserváveis.
{% endhint %}
{% endstep %}
{% step %}
**Teste de ponta a ponta**
Antes de entrar em produção, teste um fluxo de reserva completo:
1. **Abra a sua loja** numa janela anónima/privada do navegador (para ver a vista do cliente)
2. **Navegue para uma página de produto de serviço**
3. **Verifique se o calendário de reservas aparece** com horários disponíveis
4. **Selecione uma data e uma hora**
5. **Adicionar ao carrinho** e avance para o checkout
6. **Conclua a compra** (use o modo de teste da Shopify ou faça uma reserva real)
7. **Verifique se a reserva aparece** no administrador do Sesami em Reservas
8. **Verifique em dispositivo móvel** - Teste o mesmo fluxo num dispositivo móvel
**O que verificar:**
* Os horários disponíveis correspondem à disponibilidade dos seus recursos
* O fuso horário correto é apresentado
* A reserva aparece atribuída ao recurso correto
* Os horários não se sobrepõem se reservar várias marcações
{% hint style="warning" %}
**Se não aparecerem horários**, consulte a secção de resolução de problemas abaixo.
{% endhint %}
{% endstep %}
{% endstepper %}
***
## Resolução de problemas
O calendário não aparece na página de produto
Verifique:
1. **A incorporação da app Sesami está ativada** nas definições do tema
2. **O produto tem uma etiqueta sesami-service** na Shopify
3. **O Sesami está ativado** nas definições do Sesami
4. Está a visualizar o **tema publicado** (não uma versão em rascunho/não publicada)
5. **O serviço está configurado** no Sesami com o produto associado
O serviço não funciona ou apresenta erros
Verifique:
1. **O produto é adicionado como serviço** no Sesami
2. **Os recursos estão atribuídos** ao serviço
3. **Os recursos necessários estão ativados** (não desativados)
4. **Formato da variante de duração** está correto (por exemplo, "30 minutos", "1 hora" - sem espaços extra, em inglês)
Não são apresentados horários disponíveis
O problema mais comum! Verifique:
1. **Os recursos estão atribuídos** ao serviço (Passo 2)
2. **A disponibilidade está definida** para os recursos atribuídos (Passo 2)
3. **A janela de reserva** permite reservas futuras (verifique as definições avançadas)
4. **Nenhum bloqueio** está a cobrir todas as datas disponíveis
5. **Os botões de compra estão ocultos ou removidos na página de produto**
Ver: [Sem disponibilidade](/pt/comecar/onboarding/troubleshooting/no-availability.md)
O fuso horário parece incorreto
1. Vá para **Sesami > Definições > Fuso horário**
2. Verifique se o fuso horário da sua loja corresponde à sua localização física
3. Verifique se a disponibilidade do recurso está definida no fuso horário correto
4. Limpe a cache do navegador e teste em modo anónimo
Ver: [Desajuste de fuso horário](/pt/comecar/onboarding/troubleshooting/timezone-mismatch.md)
O comportamento do checkout é inesperado
Se o checkout for ignorado quando esperava que não fosse (ou vice-versa):
1. Verifique se **Reserva instantânea** está ativada (salta o checkout)
2. Verifique **as definições do depósito** (pode alterar o fluxo de checkout)
3. Reveja o produto **preços** (produtos gratuitos podem saltar o checkout)
Ver: [Reserva instantânea](/pt/reserva/booking-features/instant-booking.md) | [Depósitos](/pt/pagamentos/deposits.md)
A reserva mostra "Atribuído a: ninguém"
Isto acontece quando os horários ficam indisponíveis durante o checkout:
1. Ative **Período de reserva** nas definições do Sesami
2. Ative **Validação do carrinho** para verificar a disponibilidade antes do checkout
Ver: [Resolução de problemas de Atribuído a Ninguém](/pt/comecar/onboarding/troubleshooting/troubleshooting-assigned-to-no-one-caused-by-invalid-order.md)
Os clientes veem erros "Sessão expirada" ou "Link inválido"
Causas comuns:
1. **Links expirados** - O cliente tentou reagendar/cancelar após o prazo
2. **Cookies do navegador bloqueados** - Verifique as definições do navegador, especialmente no Safari
3. **Problemas de cache** - Limpe a cache do navegador e tente novamente
Ver: [Sessão expirada](/pt/comecar/onboarding/troubleshooting/session-expired.md) | [Cookies do Safari](/pt/comecar/onboarding/troubleshooting/safari-cookies.md) | [Erro de link inválido](/pt/comecar/onboarding/troubleshooting/as-a-customer-why-am-i-seeing-an-invalid-link-error-page.md)
***
## Próximos passos
Assim que as reservas básicas estiverem a funcionar, considere:
* [**Notificações por email**](/pt/notificacoes/notification-emails.md) - Configure emails de confirmação e lembrete
* [**Sincronização com o Google Calendar**](/pt/apps-integrations/google-calendar.md) - Sincronização bidirecional com os calendários dos membros da equipa
* [**Reagendamento pelo cliente**](/pt/reserva/booking-features/cancellations-rescheduling.md) - Permita aos clientes reagendar ou cancelar
* [**Marcações em grupo**](/pt/reserva/booking-features/group-appointments.md) - Ative várias reservas por horário
* [**Depósitos**](/pt/pagamentos/deposits.md) - Cobrar pagamento parcial no momento da reserva
* [**Ponto de venda**](/pt/apps-integrations/shopify/pos.md) - Aceite reservas presencialmente
***
## Precisa de ajuda?
* [**Chamada de onboarding gratuita**](/pt/comecar/onboarding/onboarding-call.md) - Marque uma sessão com a nossa equipa de Sucesso do Cliente
* [**Serviço de configuração premium**](/pt/comecar/onboarding/white-glove-setup.md) - Obtenha ajuda profissional com a integração e configuração do tema
* [**Serviços profissionais**](/pt/comecar/onboarding/professional-services.md) - Desenvolvimento personalizado para requisitos únicos
* [**Suporte**](mailto:help@sesami.co) - Envie um email para para obter assistência
## Relacionados
* [Guia de recursos](/pt/administracao/resources.md) - Configuração detalhada de recursos
* [Configuração da disponibilidade](/pt/reserva/availability/resource-availability.md) - Opções avançadas de disponibilidade
* [Portal de administração do Sesami](/pt/administracao/sesami-admin-portal.md) - Visão geral da interface de administração
* [Configuração de serviços](/pt/administracao/services.md) - Definições avançadas de serviço
**Crie produtos de serviço na Shopify**
Crie um produto Shopify para cada serviço reservável:
1. No administrador da Shopify, vá para **Produtos > Adicionar produto**
2. Introduza um **título do produto** sem duração (por exemplo, "Corte de cabelo", "Massagem", "Consulta")
* Mantenha o título simples - isto aparece nas confirmações de reserva e nos calendários
3. Adicione **variantes para diferentes durações**:
* Clique em **Adicionar variante**
* Crie variantes como "30 minutos", "1 hora", "90 minutos"
* Defina o preço de cada variante de duração
4. Adicione uma descrição, imagens e outros detalhes do produto conforme necessário
5. **Guardar** o produto
Repita para cada tipo de serviço que pretenda oferecer.
{% hint style="success" %}
**Melhor prática**: Use variantes para diferentes durações do mesmo serviço. Por exemplo, um produto "Massagem" com variantes "30 minutos", "1 hora" e "90 minutos" em vez de três produtos separados.
{% endhint %}
{% stepper %}
{% step %}
**Crie recursos e defina a disponibilidade**
Os recursos são o que o seu serviço necessita para acontecer - membros da equipa, salas, equipamento, etc. Irá criá-los e definir a sua disponibilidade.
{% hint style="info" %}
**Nota**: Na interface atual do administrador da Shopify, os recursos estão rotulados como "Team Members". Isto será atualizado para "Resources" numa próxima versão.
{% endhint %}
1. Abra **Sesami** no seu administrador da Shopify
2. Navegue até **Membros da equipa** (Recursos)
3. Clique em **Adicionar membro da equipa** e crie os seus recursos:
* Para a equipa: adicione cada membro pelo nome (por exemplo, "Sarah", "Alex", "Jamie")
* Para salas/equipamento: adicione-os como membros da equipa por enquanto (por exemplo, "Sala 1", "Kit de Câmara A")
4. Para cada recurso, defina a sua **disponibilidade**:
* Clique no nome do recurso
* Vá para o **Disponibilidade** separador
* Adicione regras de disponibilidade (por exemplo, segunda a sexta, 9:00 - 17:00)
* **Guardar** o horário
**Exemplo de configuração:**
* Membro da equipa "Sarah" → Disponível de segunda a sexta, 9:00 - 17:00
* Sala "Sala de Tratamento 1" → Disponível de segunda a sábado, 8:00 - 20:00
Ver: [Guia de recursos](/pt/administracao/resources.md) | [Configuração da disponibilidade](/pt/reserva/availability/resource-availability.md)
{% endstep %}
{% step %}
**Associe serviços a recursos**
Indique ao Sesami quais os recursos necessários para cada serviço:
1. Abra **Sesami** no seu administrador da Shopify
2. Navegue até **Serviços**
3. Selecione um produto de serviço
4. Vá para o **Recursos** secção
5. Escolha quais os tipos de recursos necessários:
* Selecione **Membro da equipa** se o serviço exigir um membro da equipa
* Selecione **Sala** se o serviço exigir um espaço físico
* Selecione **Equipamento** se forem necessárias ferramentas específicas
6. Opcionalmente, atribua recursos específicos:
* Marque **Apenas recursos específicos** para limitar o serviço a certos membros da equipa ou salas
* Deixe desmarcado para permitir qualquer recurso disponível desse tipo
7. **Guardar**
**Exemplos de configuração:**
* **Corte de cabelo**: Requer "Estilista" (qualquer estilista pode fazê-lo)
* **Tratamento facial**: Requer "Esteticista" + "Sala de tratamento" (ambos necessários)
* **Treino privado**: Requer apenas o recurso específico "Personal Trainer - Sarah"
{% hint style="warning" %}
**Erro comum**: Se não associar nenhum recurso, não aparecerão horários disponíveis! Cada serviço deve ter pelo menos um tipo de recurso atribuído.
{% endhint %}
{% endstep %}
{% step %}
**Adicione a reserva à sua loja online**
Torne o calendário de reservas acessível aos clientes na sua loja online:
**Opção 1: Incorporação da app no tema (Recomendado - Temas modernos)**
A maioria dos temas Shopify 2.0 suporta incorporações de apps:
1. No administrador da Shopify, vá para **Loja online > Temas**
2. Clique em **Personalizar** no seu tema ativo
3. Clique em **Incorporações de apps** (normalmente na barra lateral esquerda ou nas definições do tema)
4. Ative a **Sesami** incorporação da app
5. **Guardar**
O calendário de reservas irá agora aparecer automaticamente nas páginas dos seus produtos de serviço.
{% hint style="warning" %}
**Nota importante:** O Botão Comprar não pode ser ocultado nem removido do modelo do produto. \
O Botão Comprar é necessário para apresentar a disponibilidade de reservas no calendário. \
Se preferir não mostrar o Botão Comprar aos clientes, pode ativar a opção “Adicionar automaticamente ao carrinho / Ignorar carrinho”. Isto remove o botão do fluxo de reserva.
{% endhint %}
**Opção 2: Integração manual (temas mais antigos)**
Para temas mais antigos sem suporte para incorporação de apps:
1. No editor do tema, adicione um botão ou link às páginas de produto
2. Crie uma ligação para a página de produto com o calendário do Sesami ativo
3. Ou contacte o suporte para obter ajuda de integração específica do tema
Ver: [Configuração da loja online Shopify](/pt/apps-integrations/shopify/online-store.md)
{% hint style="success" %}
**Dica profissional**: Adicione um link de navegação "Reservar agora" no seu menu principal a apontar para uma coleção de todos os serviços reserváveis.
{% endhint %}
{% endstep %}
{% step %}
**Teste de ponta a ponta**
Antes de entrar em produção, teste um fluxo de reserva completo:
1. **Abra a sua loja** numa janela anónima/privada do navegador (para ver a vista do cliente)
2. **Navegue para uma página de produto de serviço**
3. **Verifique se o calendário de reservas aparece** com horários disponíveis
4. **Selecione uma data e uma hora**
5. **Adicionar ao carrinho** e avance para o checkout
6. **Conclua a compra** (use o modo de teste da Shopify ou faça uma reserva real)
7. **Verifique se a reserva aparece** no administrador do Sesami em Reservas
8. **Verifique em dispositivo móvel** - Teste o mesmo fluxo num dispositivo móvel
**O que verificar:**
* Os horários disponíveis correspondem à disponibilidade dos seus recursos
* É apresentado o fuso horário correto
* A reserva aparece atribuída ao recurso correto
* Os horários não se sobrepõem se reservar várias marcações
{% hint style="warning" %}
**Se não aparecerem horários**, consulte a secção de resolução de problemas abaixo.
{% endhint %}
{% endstep %}
{% endstepper %}
***
## Resolução de problemas
O calendário não aparece na página de produto
Verifique:
1. **A incorporação da app Sesami está ativada** nas definições do tema
2. **O produto tem uma etiqueta sesami-service** na Shopify
3. **O Sesami está ativado** nas definições do Sesami
4. Está a visualizar o **tema publicado** (não uma versão em rascunho/não publicada)
5. **O serviço está configurado** no Sesami com o produto associado
O serviço não funciona ou apresenta erros
Verifique:
1. **O produto é adicionado como serviço** no Sesami
2. **Os recursos estão atribuídos** ao serviço
3. **Os recursos necessários estão ativados** (não desativados)
4. **Formato da variante de duração** está correto (por exemplo, "30 minutos", "1 hora" - sem espaços extra, em inglês)
Não são apresentados horários disponíveis
O problema mais comum! Verifique:
1. **Os recursos estão atribuídos** ao serviço (Passo 2)
2. **A disponibilidade está definida** para os recursos atribuídos (Passo 2)
3. **A janela de reserva** permite reservas futuras (verifique as definições avançadas)
4. **Nenhum bloqueio** está a cobrir todas as datas disponíveis
5. **Os botões de compra estão ocultos ou removidos na página de produto**
Ver: [Sem disponibilidade](/pt/comecar/onboarding/troubleshooting/no-availability.md)
O fuso horário parece incorreto
1. Vá para **Sesami > Definições > Fuso horário**
2. Verifique se o fuso horário da sua loja corresponde à sua localização física
3. Verifique se a disponibilidade do recurso está definida no fuso horário correto
4. Limpe a cache do navegador e teste em modo anónimo
Ver: [Desajuste de fuso horário](/pt/comecar/onboarding/troubleshooting/timezone-mismatch.md)
O comportamento do checkout é inesperado
Se o checkout for ignorado quando esperava que não fosse (ou vice-versa):
1. Verifique se **Reserva instantânea** está ativada (salta o checkout)
2. Verifique **as definições do depósito** (pode alterar o fluxo de checkout)
3. Reveja o produto **preços** (produtos gratuitos podem saltar o checkout)
Ver: [Reserva instantânea](/pt/reserva/booking-features/instant-booking.md) | [Depósitos](/pt/pagamentos/deposits.md)
A reserva mostra "Atribuído a: ninguém"
Isto acontece quando os horários ficam indisponíveis durante o checkout:
1. Ative **Período de reserva** nas definições do Sesami
2. Ative **Validação do carrinho** para verificar a disponibilidade antes do checkout
Ver: [Resolução de problemas de Atribuído a Ninguém](/pt/comecar/onboarding/troubleshooting/troubleshooting-assigned-to-no-one-caused-by-invalid-order.md)
Os clientes veem erros "Sessão expirada" ou "Link inválido"
Causas comuns:
1. **Links expirados** - O cliente tentou reagendar/cancelar após o prazo
2. **Cookies do navegador bloqueados** - Verifique as definições do navegador, especialmente no Safari
3. **Problemas de cache** - Limpe a cache do navegador e tente novamente
Ver: [Sessão expirada](/pt/comecar/onboarding/troubleshooting/session-expired.md) | [Cookies do Safari](/pt/comecar/onboarding/troubleshooting/safari-cookies.md) | [Erro de link inválido](/pt/comecar/onboarding/troubleshooting/as-a-customer-why-am-i-seeing-an-invalid-link-error-page.md)
***
## Próximos passos
Assim que as reservas básicas estiverem a funcionar, considere:
* [**Notificações por email**](/pt/notificacoes/notification-emails.md) - Configure emails de confirmação e lembrete
* [**Sincronização com o Google Calendar**](/pt/apps-integrations/google-calendar.md) - Sincronização bidirecional com os calendários dos membros da equipa
* [**Reagendamento pelo cliente**](/pt/reserva/booking-features/cancellations-rescheduling.md) - Permita aos clientes reagendar ou cancelar
* [**Marcações em grupo**](/pt/reserva/booking-features/group-appointments.md) - Ative várias reservas por horário
* [**Depósitos**](/pt/pagamentos/deposits.md) - Cobrar pagamento parcial no momento da reserva
* [**Ponto de venda**](/pt/apps-integrations/shopify/pos.md) - Aceite reservas presencialmente
***
## Precisa de ajuda?
* [**Chamada de onboarding gratuita**](/pt/comecar/onboarding/onboarding-call.md) - Marque uma sessão com a nossa equipa de Sucesso do Cliente
* [**Serviço de configuração premium**](/pt/comecar/onboarding/white-glove-setup.md) - Obtenha ajuda profissional com a integração e configuração do tema
* [**Serviços profissionais**](/pt/comecar/onboarding/professional-services.md) - Desenvolvimento personalizado para requisitos únicos
* [**Suporte**](mailto:help@sesami.co) - Envie um email para para obter assistência
## Relacionados
* [Guia de recursos](/pt/administracao/resources.md) - Configuração detalhada de recursos
* [Configuração da disponibilidade](/pt/reserva/availability/resource-availability.md) - Opções avançadas de disponibilidade
* [Portal de administração do Sesami](/pt/administracao/sesami-admin-portal.md) - Visão geral da interface de administração
* [Configuração de serviços](/pt/administracao/services.md) - Definições avançadas de serviço
---
# 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.sesami.co/pt/comecar/quickstart.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.