Recipe Engine
O Recipe Engine transforma trabalhos pontuais de análise e geração em fluxos repetíveis. Ele tem quatro blocos de construção:
| Conceito | O que é |
|---|---|
| Habilidade | Uma unidade reutilizável de análise ou geração: prompts, entradas esperadas e artefatos de saída, configurações de modelo e critérios de validação. |
| Receita | Um modelo de fluxo que encadeia habilidades publicadas em etapas ordenadas com referências e pontos de aprovação. |
| Pacote de referência | Um conjunto de documentos de contexto selecionados (diretrizes de arquitetura, catálogo de domínios, catálogo de endpoints, padrões de segurança e afins) que as etapas podem ler e atualizar. |
| Execução | Uma única execução de uma receita sobre um repositório e símbolos de código selecionados. |
Abra o Recipe Engine em Agêntico → Chat → Personalizar e escolha Habilidades, Receitas, Pacotes de referência ou Execuções de receitas.
Quando usar
- Padronizar uma tarefa de modernização de várias etapas para que ela seja executada da mesma forma sempre.
- Aplicar a mesma análise a vários símbolos de código em um repositório.
- Manter pontos de revisão humana em um fluxo que, de outra forma, seria manual.
Habilidades
Personalizar → Habilidades lista suas habilidades com o status (rascunho, ativa, descontinuada).
Crie uma habilidade com Nova habilidade ou Criar com IA. Uma habilidade define:
- Identidade: nome, slug, versão, descrição, categoria e tags.
- Entradas e artefatos de saída.
- Prompts do agente: prompt de sistema e modelo de prompt do usuário.
- Configuração de modelo: temperatura e máximo de tokens de saída.
- Critérios de validação: um modo de avaliação (heurístico, LLM ou híbrido) e um ou mais critérios.
- Revisão humana e repetição: se uma etapa precisa de aprovação, se ela aprova automaticamente quando todos os critérios passam, se a edição é permitida antes da aprovação e o número máximo de tentativas.
Apenas habilidades publicadas podem ser usadas em receitas. Você pode reverter uma habilidade para rascunho ou descontinuá-la.
Receitas
Personalizar → Receitas lista os modelos de fluxo. Crie um com Nova receita ou Criar com IA (que monta um rascunho a partir das suas habilidades publicadas).
Uma receita define identidade e classificação, referências obrigatórias e opcionais, padrões de execução (idioma de saída, máximo de tokens de contexto, se as etapas elegíveis são executadas em paralelo, comportamento de aprovação automática, formato de exportação) e uma lista ordenada de etapas. Cada etapa seleciona uma habilidade e pode declarar uma condição, as referências de que precisa, mapeamentos de entrada, se exige aprovação humana e se cria ou atualiza um documento de referência.
Pacotes de referência
Personalizar → Pacotes de referência gerencia os documentos de contexto de que as execuções dependem. Para cada pacote você pode adicionar documentos (Markdown, SQL, YAML, JSON ou texto), visualizá-los renderizados ou em formato bruto, baixar o pacote como ZIP e revisar um histórico de alterações que mostra cada versão que uma execução criou ou atualizou.
Execuções
Personalizar → Execuções de receitas monitora as execuções. Inicie uma com Nova execução e siga quatro etapas:
- Receita — escolha o fluxo a executar.
- Alvo — escolha um repositório documentado e os símbolos a processar. Escolha um modo de execução:
- Símbolo único — uma execução para um símbolo.
- Contexto unificado — vários símbolos carregados em uma única execução.
- Lote paralelo — uma execução separada para cada símbolo selecionado.
- Contexto — anexe um pacote de referência e substituições de configuração em JSON opcionais. O assistente sinaliza os tipos de referência obrigatórios que estiverem faltando.
- Revisão — confirme a configuração e inicie.
Uma execução mostra o status por etapa (pendente, em execução, aguardando aprovação, aprovada, rejeitada, ignorada, concluída, com falha), o resultado da validação (avaliação) e as evidências, os artefatos gerados e quaisquer alterações no pacote de referência que ela fez. Em um ponto de revisão você pode Aprovar, Rejeitar e regerar com um comentário, Ignorar ou Editar e aprovar o artefato. Execuções finalizadas podem ser exportadas como ZIP.
Resultado esperado
Uma biblioteca de habilidades e receitas publicadas, pacotes de referência com histórico rastreado e execuções que rodam seu fluxo de forma consistente com pontos de revisão onde você precisar.