Pular para o conteúdo principal

Assistente IA

Faça perguntas sobre seu código em linguagem natural.

Visão Geral​

O Assistente IA ArchiCore entende seu código e pode responder perguntas como:

  • "Como funciona o sistema de autenticação?"
  • "O que quebraria se eu alterar UserService?"
  • "Onde está a lógica de processamento de pagamentos?"
  • "Explique o fluxo de dados para criação de pedidos"

Usando o Assistente​

Interface Web​

  1. Selecione um projeto
  2. Digite sua pergunta no painel de chat
  3. Obtenha uma resposta com referências ao código

CLI​

Simplesmente digite sua pergunta no modo interativo:

> Como funciona a autenticação de usuários?

O sistema de autenticação neste projeto usa tokens JWT.
Veja como funciona:

1. **Fluxo de Login** (src/auth/login.ts)
   - Usuário envia email/senha
   - Credenciais validadas contra o banco de dados
   - Token JWT gerado com ID do usuário

2. **Validação de Token** (src/middleware/auth.ts)
   - authMiddleware() extrai token do header
   - Token verificado usando JWT_SECRET
   - Usuário anexado ao objeto request

3. **Gerenciamento de Sessão** (src/services/session.ts)
   - Sessões armazenadas no Redis
   - Expiração padrão de 7 dias
   - Suporte a refresh token

Arquivos principais:
- src/auth/login.ts:45-78
- src/middleware/auth.ts:12-34
- src/services/session.ts:23-56

API​

curl -X POST https://api.archicore.io/api/v1/projects/:id/ask \
  -H "Authorization: Bearer SUA_API_KEY" \
  -d '{"question": "Como funciona a autenticação?"}'

Tipos de Perguntas​

Perguntas de Arquitetura​

> Qual é a arquitetura geral deste projeto?
> Como os módulos estão organizados?
> Quais padrões de design são usados?

Perguntas de Fluxo de Código​

> O que acontece quando um usuário faz um pedido?
> Como os dados fluem da API para o banco de dados?
> Rastreie o ciclo de vida da requisição para /api/users

Perguntas de Impacto​

> O que quebraria se eu alterar UserService?
> Quais arquivos dependem do módulo de banco de dados?
> Quais testes cobrem a lógica de pagamento?

Perguntas de Localização​

> Onde está a lógica de envio de emails?
> Qual arquivo lida com o registro de usuários?
> Encontre o middleware de rate limiting

Perguntas de Explicação​

> Explique o que processOrder() faz
> Por que esta função usa recursão?
> Qual é o propósito da camada de cache?

Dicas para Melhores Respostas​

Seja Específico​

❌ "Como funciona?"
✓ "Como funciona o processo de registro de usuários?"

Forneça Contexto​

❌ "Por que é lento?"
✓ "Por que a função getProducts() em src/api/products.ts pode ser lenta?"

Faça Perguntas de Acompanhamento​

> Como funciona a autenticação?
[Resposta sobre tokens JWT...]

> Você pode me mostrar o código de validação de token?
[Mostra código específico...]

> O que acontece se o token expirar?
[Explica fluxo de refresh token...]

Suporte a Idiomas​

O assistente responde no mesmo idioma da sua pergunta:

> Como funciona a autenticação?

O sistema de autenticação utiliza tokens JWT...

Limitações​

O assistente IA:

  • Só conhece código indexado - Execute /index primeiro
  • Não pode executar código - Apenas analisa código estático
  • Pode ter informações desatualizadas - Reindexe após alterações
  • Foca no seu projeto - Não discutirá bibliotecas externas em detalhes

Privacidade​

  • Perguntas são processadas por modelos de IA
  • O contexto do seu código é enviado para análise
  • Nenhum código é armazenado permanentemente
  • Veja Política de Privacidade para detalhes