Uso Avançado
Esta página cobre práticas para operar o Smart Engineering com eficiência depois que o fluxo básico de repositório e processo já está funcionando.
Retome pela visão geral
A visão geral do repositório em /repositories/:repositoryId é o melhor lugar para entender o que falta. Ela pode mostrar:
- Informações gerais do repositório e organização.
- Datas de criação e de atualização, e o tipo de armazenamento.
- Status atual e a jornada do repositório.
- O checklist de primeiros passos e a próxima ação recomendada.
- Processos recentes.
- Dados de pré-análise, estimativas de custo de LLM e recomendações de modelo quando disponíveis.
- Mensagens de erro quando há uma falha.
Quando estiver em dúvida sobre o que fazer em seguida, comece pela visão geral e siga a ação recomendada.
Use o command palette
Abra o command palette pelo header ou pelo atalho de teclado. Ele agrupa as ações em Navegação, Agêntico, Personalizar, Modernização, Repositório atual e Administração. As ações disponíveis dependem do repositório atual, das funcionalidades habilitadas e das permissões da conta.
Tutorial contextual
Orientações contextuais por tela estão disponíveis em várias telas. Um lembrete aparece na barra lateral quando o tutorial do fluxo atual ainda não foi aberto.
Grafo global
Abra o grafo global para usar os recursos de grafo fora do workspace de um repositório. Você pode selecionar um repositório existente com código-fonte disponível ou enviar um arquivo .zip para gerar um grafo.
Explorador de Custos
Administração → Explorador de Custos estima o custo de uma execução de documentação antes de iniciá-la, a partir das medições de um repositório ou de uma carga de trabalho manual. Consulte Explorador de Custos.
Chaves de API
A tela de chaves de API em /modernization/api-keys (Administração → Chaves de API) dá suporte a integrações programáticas. Você pode listar chaves, criar uma chave, copiá-la no momento da criação, revogar uma chave, excluir uma chave e atualizar a lista.
Copie a chave quando ela for exibida. Ela não é mostrada novamente após a criação.
Práticas de modelo e custo
A saída gerada depende da seleção de modelo e das escolhas de idioma. Use modelos mais leves para enriquecimento simples, indexação e documentação direta. Use modelos mais fortes para análise de arquitetura, diagramas e visões abrangentes. Idiomas de saída diferentes de inglês podem adicionar custo de tradução. Use o Explorador de Custos para comparar as opções antes.
Configurações
Abra /settings para ajustar o modelo e o comportamento da aplicação. O chat e a criação de processos dependem dos modelos disponíveis para a organização.
Dicas operacionais
- Mantenha a organização ativa visível e correta antes de criar repositórios ou processos.
- Siga a sequência natural: criar repositório, indexar o código, confirmar a pré-análise, revisar as estatísticas, criar um processo, monitorá-lo, consumir a documentação.
- Use filtros quando um repositório tiver muitos processos ou arquivos de documentação.
- Prefira reiniciar processos com falha ou cancelados a criar trabalho duplicado.
- Baixe os resultados bem-sucedidos quando os artefatos precisarem ser compartilhados fora do app.
Componentes da experiência
| Componente | Papel |
|---|---|
| Barra lateral | Navegação pelas rotas agêntico, repositório, modernização e administração. |
| Header | Controles globais, seletor de organização e acesso ao command palette. |
| Command palette | Busca e execução rápida de ações globais ou específicas do repositório. |
| Abas do workspace do repositório | Visão geral, Indexação, Estatísticas, Código-fonte, Processos, Documentação, Grafo, Configurações. |
| Breadcrumb | Localização dentro do fluxo do repositório. |
| Painel de Indexação | Conecta um repositório Git ou recebe um envio .zip, e mostra o histórico de envios. |
| Painel de Estatísticas | Mostra métricas, distribuição por linguagem, stack detectada e estimativas de custo. |
| Caixa de diálogo de confirmação da pré-análise | Revisa arquivos, linhas, tokens e linguagens antes da indexação. |
| Cards de repositório | Representam os repositórios na listagem. |
| Cards de processo | Representam as execuções de processo e as ações. |
| Logs de processo | Mostram detalhes recentes da execução. |
| Visualizador de documentação | Renderiza Markdown, permite busca e abre diagramas. |
| Canvas do grafo | Mostra relações de código, referências e arquivos relacionados. |
| Caixas de diálogo de chave de API | Gerenciam as chaves de acesso programático. |
Componentes de feedback
O app usa estados de carregamento, estados vazios, erros com repetição, alertas, caixas de diálogo de confirmação e indicadores de operações mais longas para manter as ações do usuário claras.
Princípios de uso
- Sempre confirme a organização ativa antes de criar ou buscar repositórios.
- Siga a sequência recomendada mostrada pelo status do repositório.
- Use a visão geral para retomar o trabalho após interrupções.
- Use o command palette para navegação rápida.
- Use filtros quando houver muitos processos ou arquivos de documentação.
- Revise a pré-análise e as estatísticas antes de criar processos.
- Consulte os logs de processo antes de reiniciar um trabalho com falha.