Contextos

Guia

O que são Seções?

Cada Contexto é composto por seções — blocos de conteúdo independentes que descrevem um aspecto do workspace. As seções podem ser:

Criadas manualmente pelo usuário.
Importadas a partir de arquivos Markdown (.md, .mdx).
Geradas pela IA, em lote ou individualmente.

Todas as alterações (criar, editar, importar, gerar, excluir, reordenar) são locais até você clicar em Publicar. Se recarregar a página sem publicar, as alterações pendentes são descartadas.

Tipos de Seções

Tipo	Descrição
Texto simples	Texto livre em formato básico
Área de texto	Texto mais longo com múltiplas linhas
Texto formatado	Conteúdo em Markdown
Link	URL única
Lista de links	Múltiplas URLs
Lista	Itens em formato de lista
Checklist	Lista com checkboxes
Código	Bloco de código formatado
Citação	Texto em formato de citação
Callout	Caixas coloridas de destaque
Grupo	Perfis estruturados com nome, descrição, objetivos, dores e características (ex: personas de usuário)

Ações no Cabeçalho

No topo da aba Contextos você encontra, da esquerda para a direita:

Elemento	Descrição
Campo de busca	Filtra seções pelo texto do título ou conteúdo
Filtro por tipo	Botão de funil com popover que permite selecionar os tipos de seção a exibir
Badge “Alterações não publicadas”	Aparece quando há mudanças locais pendentes
Desfazer	Descarta todas as alterações pendentes e recarrega do último estado publicado
Publicar	Salva as alterações no banco e sincroniza os embeddings da Base de Conhecimento
Botão mágico (✨)	Abre o diálogo de geração em lote com IA, permitindo revisar o prompt antes de confirmar
Engrenagem (⚙)	Abre as configurações de Segurança (limpar todos os Contextos)

Formas de Criar Seções

1. Adicionar manualmente

Clique em Adicionar Seção (botão + na árvore à esquerda, ou no estado vazio). Uma nova seção é criada no fim da árvore em modo de edição, onde você define título, tipo e conteúdo.

2. Importar de Markdown

Clique em Upload (botão de upload na árvore, ou no estado vazio). Selecione um ou mais arquivos .md / .mdx — o Prodgy converte cada cabeçalho de primeiro nível em uma seção e preserva a formatação do corpo. Ideal para trazer documentação existente.

3. Gerar em lote com IA

Clique no botão mágico (✨) no cabeçalho. Um diálogo abre mostrando o prompt que será enviado à IA. Você pode:

Revisar e editar o prompt (controla quais seções são geradas).
Ajustar Max Tokens (tamanho máximo da resposta, padrão 8000).
Ajustar Temperatura (criatividade, padrão 0.7 — valores mais baixos = mais focado).
Clicar em Gerar para confirmar.

As seções geradas aparecem como rascunho e só são persistidas ao clicar em Publicar.

4. Gerar uma seção específica com IA

Dentro da árvore de seções, cada item tem a opção Gerar com IA no menu contextual. Isso abre um diálogo com um prompt focado apenas naquela seção, sem afetar as demais.

Operações em Seções

Ação	Descrição
Editar	Modifique título, descrição e conteúdo de uma seção diretamente no editor à direita
Excluir	Remove a seção (via menu da árvore ou pelo editor)
Reordenar	Arraste e solte itens na árvore para reorganizar
Gerar com IA	Disponível no menu contextual de cada seção
Baixar como Markdown	Ícone de download no cabeçalho do editor — exporta a seção selecionada como um arquivo `.md` (nome do arquivo baseado no título da seção)

Fluxo de Trabalho (Draft → Publicar)

A aba Contextos trabalha com um modelo de rascunho local:

Edite livremente — crie, altere, importe, gere ou exclua seções. Nada é salvo no banco ainda.
Indicadores visuais — seções modificadas exibem um ponto amarelo na árvore, e um badge “Alterações não publicadas” aparece no cabeçalho.
Publique — ao clicar em Publicar, todas as alterações são persistidas no banco e os embeddings sincronizados com a Base de Conhecimento.
Desfazer — descarta todas as alterações pendentes e volta ao último estado publicado.

Configurações

Acesse pelo botão de engrenagem (⚙) no cabeçalho.

Aba Segurança

Limpar Contextos — remove permanentemente todas as seções do banco de dados e limpa os embeddings da Base de Conhecimento. Esta ação não pode ser desfeita.

Publicação e Base de Conhecimento

Ao publicar, o Prodgy:

Persiste todas as alterações pendentes no banco (cria novas seções, atualiza existentes, exclui removidas).
Sincroniza o conteúdo com a Base de Conhecimento, gerando embeddings para que os agentes de IA possam consultar essas informações durante conversas e execuções de workflow.