> ## Documentation Index
> Fetch the complete documentation index at: https://docs.telepatia.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Seções

> Como cada seção de um Smart Template resolve seu prompt

Um Smart Template é um mapa de seções. Cada seção tem este formato:

```jsonc theme={null}
{
  "instructionSet": { "telepatiaPromptId": "...", "values": { /* ... */ } }, // opcional
  "systemPrompt": "...",                                                     // opcional
  "schema": { /* OutputSchema */ }                                           // obrigatório
}
```

## Resolução de prompt (cascata o-primeiro-ganha)

Para cada seção, a Telepatia escolhe o prompt nesta ordem:

1. **`systemPrompt`** — seu próprio prompt inline (Seção Custom).
2. **`instructionSet.telepatiaPromptId`** — um prompt Telepatia curado (Seção Telepatia — **recomendado**).
3. **Fallback genérico** — sem prompt; a extração é guiada apenas pelo `schema.instructions`.

<Tip>
  **Prefira Seções Telepatia quando couber.** A equipe clínica da Telepatia mantém os prompts atrás de cada `telepatiaPromptId`. Você ganha qualidade clínica sem assumir prompt-engineering. Veja o [Catálogo de Prompts Telepatia](/pt-BR/scribe-api/telepatia-nodes).
</Tip>

As seções rodam **em paralelo**. Uma seção que falha não bloqueia as demais — ele simplesmente volta com `status: "failed"` e uma mensagem de erro.

## Seção Telepatia (recomendado)

Referencie um prompt curado pelo id. Opcionalmente passe `values` para ajustar o comportamento (veja o [catálogo](/pt-BR/scribe-api/telepatia-nodes) para os parâmetros disponíveis).

```jsonc theme={null}
"chiefComplaint": {
  "instructionSet": {
    "telepatiaPromptId": "CHIEF_COMPLAINT",
    "values": { "language_type": "quotes" }
  },
  "schema": {
    "type": "object",
    "instructions": "Extract the chief complaint",
    "properties": {
      "chiefComplaint": { "type": "string", "instructions": "Patient's own words" }
    }
  }
}
```

## Seção Custom

Escreva seu próprio prompt. Controle total — e responsabilidade total.

```jsonc theme={null}
"dischargeSummary": {
  "systemPrompt": "Generate a discharge summary based on the encounter.",
  "schema": {
    "type": "object",
    "instructions": "Discharge summary",
    "properties": {
      "summary": { "type": "string", "instructions": "Concise discharge text" }
    }
  }
}
```

Use Seções Custom quando:

* A seção não é coberta por um Prompt Telepatia.
* Você precisa de fraseado ou formato específico da instituição.
* Você está espelhando literalmente um schema EHR proprietário.

<Note>
  Reescrevendo o mesmo prompt Custom em vários templates? Fale com a gente — é candidato a virar Prompt Telepatia.
</Note>

## Fallback genérico

Se você não passa nem `systemPrompt` nem `instructionSet`, a Telepatia extrai o campo da transcrição usando apenas `schema.instructions`.

```jsonc theme={null}
"weightKg": {
  "schema": { "type": "number", "instructions": "Patient weight in kg" }
}
```

Use apenas para campos simples e inequívocos. Para qualquer coisa clínica, prefira uma Seção Telepatia.

## Misturando modos

Você pode misturar Seções Telepatia, Custom e fallback no mesmo Smart Template. Cada seção resolve independentemente.
