Orquestrar usando assistentes de IA

O assistente de IA do Braidrun não é uma barra de ferramentas de plug-in - ele entende diretamente o YAML, o DAG e o status de execução da página atual, pode alterar o workflow, acionar a execução, instalar habilidades e alternar idiomas.

Onde abrir

• Botão flutuante no canto inferior direito (disponível em todas as páginas principais)
• Teclas de atalhoAlt + G

Dentro da gaveta há um painel de conversação de streaming que suporta Markdown/destaque de código (12 idiomas) e comandos de barra.

O que isso pode ser feito?

• Criar/modificar/verificar/executar workflow
• Criar, ativar e desativar agendamentos
• Atualizar ou instalar habilidade
• Mudar a linguagem da interface
• Responda perguntas sistêmicas como "O que este sistema suporta/Como escrever uma determinada configuração/Como usar uma determinada API"

Comando de barra

/execute               # run the current workflow (alias: /run)
/validate              # validate YAML without running
/export                # download workflow YAML
/new                   # start a fresh workflow
/undo                  # roll back the last assistant change (up to 10)
/help                  # list all slash commands

Activa-os iniciando a tua entrada com "/". Os comandos Slash têm prioridade sobre texto livre e chamam diretamente a API da plataforma, ignorando o modelo — para que eles não contem com a cota diária do assistente de IA. Nas páginas como o editor e a lista de workflows, os botões de atalho correspondentes também aparecem acima da caixa de entrada.

Pré-visualização de diferenças e pilha de desfazer

Todas as alterações em recursos como workflow/programação/credencial fornecerão primeiro uma visualização do Diff:

• Novas etapas/campos são destacadas em verde
• Os campos modificados são marcados em amarelo
• As etapas/campos excluídos são destacados em vermelho

Após a confirmação, você pode usar /undo para reverter a qualquer momento, retendo até as últimas 10 modificações.

Trabalhar com o editor

• Quando você tem o assistente construir ou modificar um workflow no editor, a tela revela cada mudança na ordem: nós são adicionados e bordas desenhadas um passo de cada vez, para que você possa assistir o workflow tomar forma. As alterações ainda não são persistidas até você clicar em Salvar.
• O painel de diagnósticos do editor pode entregar um único problema ou todos eles com "Fix with AI", e o painel de propriedades do passo tem uma entrada que abre o assistente com o contexto do passo atual já carregado — sem YAML para copiar você mesmo.
• Cada passo que o assistente muda também entra no próprio histórico de desfazer / refazer do editor, então Ctrl / Cmd + Z os traz de volta um de cada vez.

Para uma análise completa de cada área do editor, consulte Editor Visual.

Preparação: Configure seu assistente de IA

Vá antes de usá-lo pela primeira vez Configurações da conta → Assistente de IA Abra e selecione um provedor de modelo (por exemplo, OpenRouter, OpenAI, Anthropic, DeepSeek), ou configure o modelo de assinatura na área Claude Code / Codex. O verdadeiro segredo é colocado em Gestão de Credenciais → Minhas Credenciais Manutenção, será automaticamente resolvido de acordo com a conta corrente quando estiver em execução. Os administradores não precisam pré-configurar o assistente de IA para usuários regulares.

Claude Code / Codex model

Se quiser que o assistente de IA chame Claude Code ou Codex, escolha o método de autenticação nas Configurações da Conta → Assistente de IA → Código de Claude / Codex:

• Claude Code: Você pode usar a chave Anthropic API ou Claude Subscription Token (provider=claude code oauth).
• Codex: Você pode usar OpenAI API Key, ou você pode usar Codex para se inscrever em auth.json (provider=codex assinatura).
• O modo de assinatura não escreve token/auth.json na configuração do assistente de IA; ele somente lê a partir de suas credenciais pessoais ou credenciais de equipe.

Base de Conhecimento da Documentação

Para que o assistente de IA responda a uma pergunta da documentação do sistema (por exemplo, "Qual é o tempo limite padrão para manual_approval"), vá para Configurações → Armazenamento de persistência da plataforma → Base de conhecimento de documentação do AI Assistant Confirme se está ativado.

Raciocínio do Processo de Pensamento

Quando o modelo selecionado suporta o raciocínio (Claude Sonnet 4.5 / 4.6/ 4.7, DeepSeek-R1, GPT-o1 / o3 série, Gemini Thinking, etc), a gaveta assistente de IA irá primeiro exibir um cartão dobrado "Processo de Pensamento do Assistente de IA". O modelo primeiramente flui o resumo do raciocínio aqui, e então gera a resposta final:

• O evento rationaling delta é colapsado pelo cliente e não atualizará a tela (evitando re-render cada frame)
• Raciocínio completo só é renderizado com a subcategoria pensando quando raciocinando completar
• Clique no cartão de pensamento para expandir/colapso; ele é colapsado por padrão para evitar ocupar o campo de visão
• O conteúdo do pensamento também será gravado na pilha de desfazer junto com /undo para facilitar a revisão.

Modelos que não suportam o raciocínio não exibirão quaisquer cartas adicionais e se comportarão como antes.

Memória de Longo Prazo

O assistente de IA é independente por sessão por padrão. Se você quiser que ele "lembre" suas preferências ("Eu gosto de respostas chinesas + marcação curta", "Meu workflow ASA sempre funciona de manhã cedo"), você pode ativar a memória de longo prazo na configuração do Assistente de IA:

• Após habilitar, as mensagens do usuário e as respostas do assistente serão vetorizadas e armazenadas no ltm:<user id>:* namespace.
• Quando a próxima rodada de diálogo começar, as memórias relevantes do topo K serão recuperadas automaticamente como injeção de contexto
• Há um botão "Limpar memória de longo prazo" no canto superior direito da barra lateral do Assistente de IA. POST /api/global-agent/memory/clear limpa todos os espaços de nomes do usuário atual com um clique; adequado para uso ao mudar dispositivos/switching equipes.

Pontas

• Se você deseja que a IA gere YAML: peça explicitamente para gerar Snake_case YAML
• Fluxo de ramificação: dê prioridade à geração da estrutura do classificador + condição
• Grande mudança: use linguagem natural para descrever a intenção e, em seguida, divida-a em diferenças de várias etapas
• combinar Depurador : após a conclusão da modificação da IA, ative a depuração e execute uma simulação do workflow antes de ficar on-line.
• Ao selecionar um modelo que suporte o raciocínio, você pode ver diretamente o "processo de pensamento", e o design prompt de depuração é muito útil.