Ragnus
Painel administrativo web para gerenciar documentos, integrações e um assistente de busca com IA. Centralize o conhecimento do seu time e consulte via chat em linguagem natural.
O que é o Ragnus?
Ragnus é um painel administrativo web para gerenciar documentos, integrações e um assistente de busca com IA.
Permite que times façam upload de arquivos, conectem fontes externas como o Azure DevOps e consultem todo esse conteúdo via chat em linguagem natural — sem precisar abrir planilha, wiki ou repositório.
Como integrar com o Azure DevOps?
Acesse /integrations, clique em Add Integration e preencha sua organização, projeto e PAT do Azure...
Para que serve?
Busca inteligente em documentos
Faça perguntas em linguagem natural e obtenha respostas extraídas dos seus arquivos indexados.
Upload e processamento de arquivos
Envie documentos para indexação e acompanhe o status do processamento em tempo real.
Integração com Azure DevOps
Sincronize wikis e work items automaticamente para torná-los pesquisáveis pelo assistente.
Gestão de tokens de acesso
Crie e revogue Personal Access Tokens (PATs) para autenticação direta via API.
Monitoramento de consumo
Visualize o uso de tokens de IA por dia, mês e ano com gráficos interativos.
Como usar
Login e Registro
Acesse a página de login
Vá para portal.ragnus.tech/login e insira seu e-mail e senha cadastrados.
Registre-se se necessário
Caso não tenha conta, acesse portal.ragnus.tech/register para criar uma nova.
Sessão automática
A sessão é mantida automaticamente via cookies seguros (httpOnly), sem necessidade de novo login.
Chat — Busca em documentos
Digite sua pergunta
Use o campo de texto na tela principal para inserir sua pergunta em linguagem natural.
Envie a mensagem
Pressione Enter ou clique no botão de envio para submeter.
Leia a resposta
O assistente responde com base nos documentos indexados. Respostas são renderizadas em Markdown, suportando tabelas, listas e blocos de código.
Continue a conversa
A conversa mantém contexto entre mensagens. Use New Chat para iniciar uma nova sessão limpa.
Upload de Arquivos
Selecione os arquivos
Arraste arquivos para a zona de drop ou clique para selecionar. Até 5 arquivos simultâneos.
Inicie o upload
Clique em Upload em um arquivo específico ou Upload All para enviar todos de uma vez.
Acompanhe o progresso
Monitore cada arquivo com a barra de percentual em tempo real.
Verifique os jobs
Clique em Jobs para ver o status de processamento em /upload/jobs.
Integrações com Azure DevOps
Adicione uma integração
Clique em Add Integration para abrir o formulário de configuração.
Preencha os dados
Insira o nome, organização e projeto no Azure DevOps, o Personal Access Token (PAT), a URL base e as opções de wiki e work items.
Salve e gerencie
A integração aparecerá na tabela. Clique na linha para ver o histórico de sincronização.
Edite ou exclua
Use o menu (⋮) para editar ou excluir uma integração existente.
Sincronize manualmente
Acesse os jobs da integração e dispare um novo sync quando necessário.
Personal Access Tokens (PATs)
Crie um novo token
Clique em Add e defina um nome e a validade em dias.
Copie imediatamente
O token é exibido apenas uma vez na criação. Copie e armazene com segurança.
Gerencie tokens
Tokens ativos e expirados ficam listados na tabela. Use o menu (⋮) para excluir.
Monitoramento de Consumo de Tokens
- Visualize o consumo diário de tokens de IA em gráfico de barras.
- Filtre por mês e ano para análise histórica.
- Veja o resumo anual com breakdown mensal.
- Gráficos mostram tokens de entrada (input) e saída (output) separadamente.
Alterar Senha
Clique no seu nome de usuário no canto superior direito da tela e selecione Change Password para definir uma nova senha.
Integração via API
Use PATs para integrar o Ragnus diretamente nas suas aplicações, sem autenticação interativa no painel.
Authorization: Bearer <seu-token>GET /search
Envia uma pergunta ao assistente e recebe uma resposta gerada com base nos documentos indexados. Opcionalmente, passe conversation_id para continuar uma conversa existente e manter o contexto entre mensagens.
Parâmetros de query
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
query | string | Sim | Pergunta ou texto de busca |
conversation_id | string | Não | ID da conversa anterior para manter contexto entre mensagens |
Exemplo de requisição
curl -X GET "https://portal.ragnus.tech/search?query=como+configurar+o+sistema" \
-H "Authorization: Bearer <seu-token>"Output — 200 OK
{
"conversation_id": "uuid-da-conversa",
"answer": "Texto da resposta em Markdown.",
"references": [
{
"source": "https://link-da-fonte",
"title": "Título do documento"
}
]
}| Campo | Tipo | Descrição |
|---|---|---|
conversation_id | string | ID da conversa — passe nas próximas requisições para manter contexto |
answer | string | Resposta gerada pelo LLM em Markdown, com base nos documentos indexados |
references | array | Lista de documentos utilizados como fonte para a resposta |
references[].source | string | URL de origem do documento |
references[].title | string | Título do documento |
conversation_id retornado na resposta como parâmetro da próxima requisição.POST /ingestion/docs
Envia um ou mais arquivos para indexação. O processamento é assíncrono — result: true indica que o arquivo foi recebido, não que já foi indexado. Acompanhe o andamento pela interface.
Exemplo de requisição
curl -X POST "https://portal.ragnus.tech/ingestion/docs" \
-H "Authorization: Bearer <seu-token>" \
-F "files=@documento.pdf"| Campo | Tipo | Descrição |
|---|---|---|
files | file[] | Um ou mais arquivos enviados no mesmo campo. Máximo de 5 arquivos por requisição. Formatos aceitos: .pdf, .doc, .docx. |
.pdf, .doc, .docx.Output — 200 OK
{
"result": true
}/upload/jobs.Funcionalidades de segurança
Sessão via cookies httpOnly
O token de acesso não fica exposto ao JavaScript, protegendo contra ataques XSS.
Refresh automático de sessão
Renovação em segundo plano — sem precisar fazer login novamente após expiração do token.
Rotas protegidas
Sem sessão válida, o usuário é redirecionado automaticamente para /login.
PATs com expiração configurável
Defina a validade de cada Personal Access Token em dias para limitar o escopo de acesso.
Ragnus © 2026 — Documentação para uso interno.