Este guia é para pessoas que usam o IntelectGrid para tomar decisões sobre infraestrutura e modelos. Quem instala, configura ou mantém o sistema encontra essa documentação no repositório, em docs/.
Criar uma decisão Ver histórico Entender os resultados Falar com o suporte
Comece aqui
O IntelectGrid responde a uma pergunta cara de errar: onde rodar a sua carga de IA — qual GPU, qual runtime, qual provider — com o melhor equilíbrio entre custo, desempenho e qualidade.
O diferencial não é recomendar: é recomendar de forma verificável. Cada número da resposta diz de onde veio, cada decisão pode ser refeita meses depois com o mesmo resultado, e a explicação em texto é conferida número a número contra os fatos — nada é só uma frase bem escrita.
Use a plataforma quando for escolher infraestrutura para um modelo, comparar provedores antes de contratar, ou justificar uma escolha para alguém que vai perguntar «por quê?» — a resposta já vem com o porquê.
Entrar na aplicação
Você precisa de três coisas, fornecidas por quem administra a sua organização: o nome da organização (um identificador curto, como «acme»), o seu e-mail e a sua senha.
Na tela de entrada, preencha os três campos e entre. Se algo estiver errado, a mensagem aparece ao lado do campo errado — não é preciso adivinhar. Sessão expirada volta para a tela de entrada avisando; ao entrar de novo, você volta para onde estava.
Não existe cadastro público: contas são criadas pela administração da organização. Se você não tem acesso, veja a seção Suporte.
Criar sua primeira decisão
Uma decisão parte de um cenário: a descrição da sua carga de trabalho e das suas restrições. A tela Decidir é um formulário — você não escreve nada em formato técnico, só preenche campos.
Para começar rápido, use um dos cenários de exemplo do formulário e ajuste. O rascunho é guardado no seu navegador: dá para fechar a página e continuar depois.
Preencher um cenário
O formulário agrupa o que a resposta precisa saber:
- Modelo e variante — o que vai rodar, e em qual precisão.
- Runtime — o motor de execução, se você já tem um; deixar em aberto compara todos os elegíveis.
- Região e política — onde pode rodar e qual objetivo manda: menor custo, menor latência, ou o equilíbrio entre eles.
- Tráfego — quantas requisições e de que tamanho. É daqui que saem réplicas e fila.
- Limites — teto de latência, teto de custo, mínimo de qualidade. Cada limite que você declara vira um critério que a resposta respeita ou explica.
Campos inválidos são apontados um a um, com a mensagem ao lado e um atalho que leva até o campo. A data de referência do cenário existe porque a mesma pergunta, feita amanhã, tem de dar a mesma resposta — os preços valem para aquele instante.
Entender a recomendação
A resposta começa por um status, e ele diz quanta confiança o produto tem no próprio vencedor:
| Status | O que significa |
|---|---|
| RECOMMENDED | Há um vencedor com evidência medida por trás dos números. |
| PROVISIONAL | Há um vencedor, mas os números dele vêm de estimativa, não de medição. A conta está certa; a evidência é que ainda não é medida. Use como direção, não como garantia. |
| NO_ELIGIBLE_CANDIDATE | Nenhuma opção passou nos seus critérios. Isso é uma resposta, não um erro — a seção de alertas diz o que reprovou cada candidato, e o que afrouxar se quiser um vencedor. |
Ao lado de cada número há um selo de autoridade — um ponto colorido que diz de onde o número veio, do mais firme ao mais frágil: declarado pela fonte, medido, calculado, estimado, deduzido. Passe o cursor sobre o selo para ver o nível. Um resultado combinado herda o nível mais fraco das suas entradas — por isso um custo exato calculado sobre uma estimativa continua marcado como estimativa.
Comparar candidatos
Abaixo do vencedor vem a tabela de candidatos — todos os que foram considerados, incluindo os que perderam e os que foram recusados, cada um com seu veredito:
| Veredito | O que significa |
|---|---|
| COMPATIBLE | Roda a sua carga e atende os seus critérios. |
| COMPATIBLE_CONSTRAINED | Roda, mas com uma ressalva prática relevante — por exemplo, cabe na memória com pouquíssima folga. A ressalva vem escrita na linha. |
| REJECTED | Não atende — não cabe, não alcança, ou viola um limite seu. O motivo está na linha. |
| INSUFFICIENT_DATA | Faltou informação para avaliar. Repare: não é «não serve», é «não sei» — e o produto prefere dizer não sei a inventar. |
As colunas que mais importam na comparação:
- Custo por requisição — o que cada resposta do seu modelo custa, já considerando a ocupação real das máquinas.
- p95 — o tempo de resposta que 95% das requisições respeitam. É a experiência do seu usuário no pior caso razoável.
- Fila — quanto do p95 é espera, não processamento. Fila alta com máquina cara é dinheiro parado.
- Réplicas — quantas máquinas o seu pico de tráfego exige.
Alertas e limitações
A resposta nunca esconde uma limitação — ela aparece escrita, junto do resultado:
- Restrição que nada satisfaz — um limite seu que nenhum candidato viável atendeu. Deixou de filtrar e virou achado: é o limite a rever, se você quiser um vencedor.
- Cobertura — quantas ofertas do catálogo entraram na comparação. Se um limite interno cortou a lista, a resposta declara o corte em vez de fingir que olhou tudo.
- Avisos por candidato — o que faltou ou o que reprovou, linha a linha.
Quando nenhum candidato é elegível
- Leia o motivo em cada linha — costuma ser um só, repetido.
- Se for um limite seu (latência, custo), afrouxe-o e pergunte de novo; o rascunho continua preenchido.
- Se for falta de dados do catálogo, o caminho é da administração — veja Suporte.
Trace e explicação
Toda decisão guarda o próprio trace: as entradas, os passos e a fórmula de cada número. Ao abrir uma decisão, a reexecução refaz a conta com as entradas gravadas e compara — reproduziu é o produto conferindo a si mesmo na sua frente.
A explicação é o mesmo resultado em texto corrido — por que o vencedor venceu, o que limitou os outros. Antes de aparecer para você, cada número citado no texto é conferido contra os fatos do trace; um texto que cite um número que não está lá não é publicado.
Consultar o histórico
Tudo que a sua organização decidiu, com busca e filtros por provider, GPU, região, status, política e data. Os filtros ficam no endereço da página — dá para copiar o link e mandar exatamente a visão que você está vendo.
Abrir uma decisão antiga mostra o que foi respondido na época, com vencedor, candidatos, custos, alertas, trace e explicação. Decisão publicada não muda: correção gera uma decisão nova, ligada à anterior.
Exportar resultados
Na decisão aberta, o botão de exportação baixa um arquivo com a decisão completa — cenário, resposta, candidatos e trace. Serve para arquivar, anexar a um chamado ou compartilhar com quem não tem acesso à plataforma.
O arquivo é um formato técnico legível por outras ferramentas; para ler como pessoa, a própria página da decisão é o lugar — você não precisa abrir o arquivo para usar o produto.
Perguntas frequentes
Porque o vencedor não tem medição real por trás — os números dele são estimativas bem calculadas. O produto não apresenta estimativa como medição, então avisa. Hoje, sem benchmarks medidos no catálogo, toda recomendação sai assim: é a leitura honesta, não um defeito seu nem do cenário.
Não. Falta um dado no catálogo para avaliar aquela opção, e a linha diz qual. Os outros candidatos seguem avaliados normalmente. Se a opção importa para você, peça à administração para completar o catálogo.
Não. Você usa o produto com a sua conta da organização, e mais nada. Credenciais de provedores são assunto da administração, quando existem — e ficam do lado do servidor, nunca no seu navegador.
Confira a data de referência: preços mudam, e cada resposta vale para o instante do cenário. Com a mesma data e o mesmo cenário, a resposta é a mesma — é uma promessa do produto, verificada pelo trace.
Suporte
O primeiro contato é quem administra o IntelectGrid na sua organização — é essa pessoa quem cria contas, dá permissões e mantém o catálogo que alimenta as suas respostas.
- Não consigo entrar — conta e senha são da administração da organização; não há recuperação pública.
- Falta uma GPU, um provider ou uma região — o catálogo é mantido pela administração; aponte a decisão em que a falta apareceu.
- Um número parece errado — abra a decisão, veja o trace e a explicação, e mande o link da decisão junto com a dúvida. É exatamente para isso que eles existem.
Quem opera o sistema encontra a documentação de instalação, catálogo e
credenciais no repositório, em docs/OPERACAO.md.