> For the complete documentation index, see [llms.txt](https://trf2.gitbook.io/apoia/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://trf2.gitbook.io/apoia/banco-de-prompts/workflows-de-prompts.md).

# Workflows de Prompts

{% hint style="info" %}
**Vídeo explicativo:** espaço reservado — um vídeo demonstrativo desta funcionalidade será disponibilizado aqui em breve.
{% endhint %}

Muitas tarefas judiciais não se resolvem com um único prompt: primeiro é preciso extrair os pedidos e as fundamentações, depois decidir cada pedido e, só então, redigir a minuta. Para isso, a Apoia suporta **workflows**: encadeamentos de prompts nos quais o resultado de um prompt (**predecessor**) alimenta o prompt seguinte.

## Como Funciona na Prática

Ao executar um prompt que faz parte de um workflow, a Apoia executa automaticamente, em ordem, todos os prompts predecessores obrigatórios. Os resultados aparecem empilhados na página, um acima do outro, e o texto gerado por cada um é entregue ao prompt seguinte como "resultados de prompts anteriores". Assim, quando você chega ao prompt de minuta de sentença, a IA já tem à disposição os pedidos extraídos e as fundamentações levantadas pelos passos anteriores — sem retrabalho e sem que você precise copiar e colar nada.

Cada resultado do fluxo tem o mesmo comportamento de um resultado isolado: pode ser copiado, avaliado, gerado novamente e visualizado em diferentes modos. Se um resultado intermediário ficar ruim, você pode gerá-lo novamente antes de prosseguir.

## Prompts Opcionais

Nem todo passo do fluxo é obrigatório. Prompts marcados como **opcionais** pelo autor do workflow aparecem como **botões** acima dos resultados. Clicar no botão ativa aquele passo para a execução corrente — por exemplo, uma "Pesquisa de Temas" que só faz sentido em processos com tese repetitiva. Se você não ativar, o passo é simplesmente ignorado e o fluxo segue sem ele.

## Formulário de Pedidos (Decisão Humana)

Nos workflows de minuta de sentença e de voto, a Apoia insere um passo especial: após a extração dos pedidos e fundamentações, é exibido um **formulário de pedidos** no qual o próprio magistrado indica, para cada pedido, se é procedente ou improcedente (e fundamenta a decisão). Os prompts seguintes ficam aguardando até que o formulário seja revisado e confirmado.

Isso é uma exigência da Resolução CNJ nº 615/2025: a IA não decide o mérito — a minuta só é redigida após a diretriz humana. Veja [Segurança da Informação](/apoia/seguranca-da-informacao.md).

## Como Criar um Workflow

Na criação ou edição de um prompt (veja [Criar Novo Prompt](/apoia/banco-de-prompts/criar-novo-prompt.md)), a seção **Workflow** permite definir:

* **Prompts Predecessores**: executados antes deste prompt. Cada predecessor pode ser marcado como **Opcional** e pode ter uma **condição** para ser incluído.
* **Prompts Sucessores**: sugeridos ao usuário como próximos passos ao final da geração.

Os prompts são referenciados por nome na interface; nos arquivos do repositório de prompts, são referenciados por `path` (slug) ou `uuid` (veja [Como Escrever Arquivos de Prompt](/apoia/repositorio-de-prompts/como-escrever-arquivos-de-prompt.md)).

{% hint style="info" %}
Prompts com a estratégia "Peças de tipos específicos" e lista de tipos vazia não recebem peças do processo: são úteis justamente como passos de workflow que trabalham somente sobre os resultados dos predecessores (por exemplo, uma busca de jurisprudência sobre os pedidos já extraídos).
{% endhint %}


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://trf2.gitbook.io/apoia/banco-de-prompts/workflows-de-prompts.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.