Assistentes especializados embarcados
Assistentes embarcados que analisam a operação e propõem ação, posicionamento de estoque, rota, auditoria de saldo, limite de estoque, acompanhamento da separação, e a montagem de jornada, painel e integração. Dentro da conversa, consultam também o sistema de gestão ou de transporte do cliente, pelas ferramentas que o administrador aprovou uma a uma. Cada decisão proposta fica gravada, com o que a motivou.
Nenhum assistente executa sozinho no estoque. A proposta é material de decisão, não ordem de serviço.
Singularity: conversa, agentes e sistemas externos
Singularity é a camada de inteligência artificial do sistema: conversa em português sobre a operação com a tabela ao lado, agentes montados no estúdio, leitura do sistema pela ferramenta de IA da equipe do cliente e consulta, dentro da conversa, ao sistema de gestão ou de transporte do cliente. Nenhum agente altera o estoque sozinho: a proposta espera a aplicação do gestor.
Perguntar sobre a operação sem montar relatório, com a permissão de quem pergunta: saldo, razão, pedidos, tarefas, contagem, ocorrências, ocupação e produtividade. Conferir o estoque do sistema de gestão contra o físico sem conta de planilha: a pessoa anexa a exportação (ou o agente busca do outro lado) e o sistema calcula, item a item, o que diverge, o que só existe de um lado e o que não dá para comparar; de cada linha, a pessoa abre o razão do item ou pede a contagem. Montar agentes para os papéis da operação, partindo de um modelo pronto, de uma descrição em palavras ou do zero. E deixar a ferramenta de IA da equipe do cliente ler o estoque com uma credencial própria, só de leitura, que o administrador controla.
- Singularity Chat
- Singularity Studio
- Contrato do Singularity
- Consumo de IA
- Acesso externo (MCP)
- Sistemas externos (MCP)
- Slotting (Otimização)
- Ocorrências
- Não altera o estoque sozinho. O agente só lê ou propõe; a proposta espera a aplicação do gestor (perfis Master, Administrador e Gestor), linha a linha.
- Agente montado pelo cliente não propõe: só consulta. Proposta de fila e de slotting é dos agentes da Quanntco.
- Não cria, cancela, movimenta nem libera nada pela conversa: o agente diz em qual tela isso se faz.
- Não calcula número pelo modelo de IA: totais e diferenças vêm prontos das consultas, e o que a consulta não devolveu aparece como desconhecido, nunca como zero.
- Não confronta o razão com o sistema externo numa conta só: a comparação é sistema externo contra físico, e o razão do item se abre a partir da linha.
- A ponte de saída não escreve no sistema: toda consulta liberada para a ferramenta de fora só lê.
- Não usa ferramenta do sistema externo que não foi aprovada, nem a que mudou depois da aprovação, e não alcança endereço da rede interna do cliente.
- Não conversa com agentes de outros sistemas: a ponte de entrada usa ferramentas, não troca mensagens entre agentes.
- O operador de coletor não conversa com o Singularity.
- Não mostra o texto das conversas de outras pessoas: o consumo mostra quem usou e quanto custou.
- Não produz número contratual para o dono da mercadoria.
Parâmetros e o efeito de mudar 10
- Quem conversa com este agente
Na aba Guardrails do agente no Singularity Studio, os perfis que veem o agente no chat.
Valores: Master, Administrador, Gestor, Supervisor e Administrativo, em qualquer combinação.
Quando ninguém preenche: Master, Administrador, Gestor e Supervisor.
Se mudar: Depois de publicar a versão, o perfil retirado deixa de achar o agente ao abrir conversa nova. Incluir Supervisor não abre para ele a produtividade nem a carga dos operadores: essas consultas seguem só para Master, Administrador e Gestor, e a resposta dele vem sem esses números.
- Depositantes
Na aba Guardrails, limita o agente a parte dos depositantes, além do que quem conversa já enxerga.
Valores: os de quem conversa; ou só estes (dentre os que você enxerga), marcando um a um.
Quando ninguém preenche: os de quem conversa.
Se mudar: Agente restrito responde só sobre os depositantes marcados, mesmo para quem enxerga mais. A consulta que tenta sair do recorte é recusada e fica no quadro «O que este agente recusou» da mesma aba.
- Temas que o agente recusa
Assuntos que o agente não trata, digitados um a um (ex.: preço de venda).
Valores: Lista livre de temas.
Quando ninguém preenche: Nenhum.
Se mudar: O tema vale na pergunta e na resposta: a resposta que o citar é retida, e a recusa fica registrada em «O que este agente recusou». Tema amplo demais faz o agente recusar pergunta legítima da operação.
- Anexos
Na aba Guardrails, liga o recebimento de arquivo no chat e escolhe os tipos.
Valores: recebe anexo, com Imagem (print, foto), PDF, CSV, Planilha (Excel) e Texto.
Quando ninguém preenche: Desligado.
Se mudar: Desligado, o chat recusa o arquivo com «Este agente não recebe anexos.». Ligado com imagem ou PDF num agente que compara estoque, a tabela é lida pela IA e precisa ser conferida pela pessoa antes de entrar na comparação.
- Tipo e Vale por
Na credencial de Acesso externo, o tipo do segredo e por quanto tempo ele vale.
Valores: Chave (até 1 ano), de 1 a 365 dias; ou Token temporário (até 7 dias), de 1 a 168 horas.
Quando ninguém preenche: Chave, por 365 dias. No token, 24 horas.
Se mudar: Vencida, a ferramenta de fora para de ler na hora. A chave serve ao uso contínuo e se renova na própria tela antes de vencer; o token serve a uma demonstração ou auditoria e vence sozinho.
- Usuário dono, a credencial enxerga como ele
A pessoa cujo acesso a credencial empresta: armazéns, depositantes e perfil.
Valores: Um usuário do cliente; depois, os armazéns dele que a credencial vê e as consultas liberadas.
Quando ninguém preenche: Nenhum: é obrigatório. Os armazéns do dono vêm marcados.
Se mudar: A credencial lê exatamente o que o dono enxerga, nada além. Dono desativado derruba a leitura de fora; o dono não se troca depois: crie outra credencial e revogue a antiga.
- Limite de consultas por minuto (1 a 600)
Quantas leituras a credencial faz por minuto.
Valores: De 1 a 600.
Quando ninguém preenche: 60.
Se mudar: Ao passar do limite, a leitura é recusada com o aviso para aguardar um minuto, e a recusa também conta no limite. O limite só se escolhe na criação.
- Endereço
No cadastro do sistema externo, onde o agente encontra as ferramentas do outro lado.
Valores: Endereço público e seguro.
Quando ninguém preenche: Nenhum: é obrigatório no cadastro.
Se mudar: Outro endereço é outro sistema: o cadastro volta a Pendente com o motivo Cadastro mudou, as aprovações e o mapeamento de estoque são apagados e nenhum agente o usa até nova aprovação.
- Autenticação e Credencial
Como o sistema se identifica para o sistema externo e o segredo de acesso, que fica guardado: a tela só diz se existe.
Valores: Autenticação: Nenhuma, Token (Bearer) ou Cabeçalho. Credencial: o segredo fornecido pela equipe do cliente.
Quando ninguém preenche: Token (Bearer). Ao editar, a Credencial vazia mantém a atual.
Se mudar: Trocar a autenticação ou gravar credencial nova também volta o cadastro a Pendente e apaga as aprovações. Credencial vencida do outro lado faz a conversa seguir só com o que o armazém mostra, avisando que o sistema externo não foi consultado.
- SKU, Quantidade e Unidade
Na aprovação da ferramenta de estoque do sistema externo, dizem qual campo do resultado é o código do item, a quantidade e a unidade.
Valores: Os nomes de campo que a ferramenta devolve; a tela sugere os que encontrou.
Quando ninguém preenche: Vazio: o resultado vira tabela da conversa, mas não entra na comparação com o físico.
Se mudar: Mapear o campo errado faz a comparação cruzar item com quantidade de outro item e acusar divergência que não existe.
Passo a passo 14
Usuário-chave · Singularity > Contrato do Singularity
Conferir o quadro do contrato: orçamento mensal de IA e se o MCP de saída e o MCP de entrada estão contratados. Na seção Ferramentas do Singularity, escolher uma consulta e clicar em «Consultar» roda a mesma consulta dos agentes, sem IA, no armazém ativo.
Resultado: A tela mostra «Ativo para este cliente» e os três valores do contrato. Sem vigência, mostra o convite e o botão «Quero ativar», que avisa a Quanntco.
Usuário-chave · Singularity > Singularity Studio
Clicar em «Criar agente» e escolher «A partir de um modelo». Ex.: o modelo Conciliação com o ERP; em «Onde ele vale», marcar «Só os depositantes que eu escolher» e o depositante DEP-01; clicar em «Ativar agora».
Resultado: A janela mostra que o agente está ativo na v1 e em que perfis aparece. Ele já está no Singularity Chat deste cliente; «Personalizar antes de ativar» abre o rascunho no editor em vez de publicar.
Usuário-chave · Singularity > Singularity Studio, «Criar agente» > «Com IA»
Descrever o agente em palavras (ex.: um agente para o supervisor de expedição acompanhar os pedidos parados do depositante DEP-01) e clicar em «Montar rascunho»; depois «Revisar no editor», ajustar as abas Identidade, Persona, Ferramentas e Guardrails e clicar em «Salvar rascunho».
Resultado: A IA monta o rascunho só com consultas que existem e restrições que quem cria alcança; a tela mostra as perguntas iniciais já rodadas na base, cada uma com «trouxe dado» ou o motivo. Nada é publicado sem a pessoa.
Usuário-chave · Editor do agente, abas ⑥ Testar e ⑦ Versões
Em Testar, clicar em «Abrir um teste» e fazer a pergunta que o gestor faria; depois clicar em «Publicar», escrever a Nota de mudança e confirmar.
Resultado: A versão publicada fica guardada como foi, com data, autor e nota, na aba Versões. Editar um agente publicado cria o rascunho da próxima versão; «Voltar para esta» recoloca uma versão anterior. O teste consome o orçamento do mês.
Usuário-chave · Singularity > Singularity Chat
Clicar em «Nova conversa», escolher o agente e perguntar em português. Ex.: anexar a exportação do sistema de gestão (planilha com código, quantidade e unidade), conferir no painel ao lado os campos SKU (código do item), Quantidade e Unidade, clicar em «Confirmar a tabela» e pedir: compare com o físico do DEP-01.
Resultado: A resposta cita os números e a tabela abre ao lado, com os grupos Divergente, Só no externo, Só no WMS, Não comparável e Igual, e a coluna Diferença (físico − externo) já calculada pelo sistema, não pelo modelo. Ex.: item 4471 com Externo 120, Físico 96, Diferença −24. «Exportar CSV» baixa a tabela.
Usuário-chave · Singularity Chat, linha da tabela ao lado
Na linha divergente, clicar em «ver a ledger» para abrir o razão do item, ou em «Solicitar contagem», ler a situação de cada endereço, escrever o Motivo (opcional, vai na ocorrência) e confirmar.
Resultado: O razão abre numa aba nova do painel, sem IA. No pedido, nasce uma ocorrência por endereço com saldo; a contagem nasce junto ou espera a decisão do gestor em Ocorrências. Endereço com contagem pendente ou de doca fica de fora, com o motivo.
Consultor · Singularity > Sistemas externos (MCP)
Clicar em «Novo sistema», preencher Nome, Código, Endereço, Autenticação e Credencial e clicar em «Gravar»; no detalhe, clicar em «Aprovar ferramentas», marcar só as de consulta, mapear SKU, Quantidade e Unidade na de estoque e clicar em «Confirmar aprovação».
Resultado: O sistema conecta e lista as ferramentas do outro lado. O cadastro nasce Pendente; depois da aprovação passa a Ativo, a coluna Aprovadas mostra quantas de quantas e o detalhe grava quem aprovou e quando.
Usuário-chave · Singularity > Singularity Studio, aba ⑤ Conectores do agente
Escolher, entre os sistemas externos ativos, os que o agente usa, e publicar a versão.
Resultado: Na conversa, o agente consulta o sistema externo e a lista de estoque entra na mesma comparação com o físico da planilha anexada. Agente da Quanntco não usa sistema externo: só o agente do próprio cliente.
Sistema · Automático, a cada resposta que usa sistema externo
Reler as ferramentas do sistema externo e comparar com as aprovadas.
Resultado: Se uma ferramenta aprovada mudou, o cadastro volta a Pendente com o motivo Ferramenta mudou e a chamada é recusada até nova aprovação. Sistema fora do ar: a resposta segue só com o que o armazém mostra e diz isso.
Consultor · Singularity > Acesso externo (MCP)
Clicar em «Nova credencial»: Nome (ex.: Leitura do analista, conciliação), Tipo Chave, Vale por 90 dias, Usuário dono, os armazéns que a credencial vê, as Consultas liberadas e o Limite de consultas por minuto 30; clicar em «Criar credencial» e copiar o segredo.
Resultado: O segredo aparece uma vez só, com o trecho pronto para a equipe colar na ferramenta dela; depois, a grade mostra só o começo dele. A tela traz também o Endereço do serviço e um «Prompt de exemplo para o agente do cliente».
Consultor · Singularity > Acesso externo (MCP), linha da credencial
Clicar em «Leituras» para ver o que a IA de fora leu; «Renovar» antes de vencer; «Revogar» quando a equipe deixar de usar.
Resultado: Leituras mostra quando, a consulta, o pedido, as linhas devolvidas e se foi Lida, Recusada ou Erro. Renovar troca o segredo e o anterior deixa de valer na hora; revogar para a leitura na hora e não se desfaz.
Usuário-chave · Singularity > Singularity Chat, agente Repriorizador de Fila
Pedir a revisão da fila (ex.: quais separações estão mais perto do prazo de embarque); abrir a aba Proposta, ler o porquê do agente e, por linha, o antes, o depois e o valor de agora; o gestor marca as linhas e clica em «Aplicar selecionadas», ou em «Descartar».
Resultado: Só a aplicação do gestor muda a fila: cada linha sobe ou desce 10 pontos de prioridade, ou assinala ou devolve uma tarefa, e o sistema pula a que mudou desde a proposta, com o motivo. «Desfazer» volta as linhas aplicadas onde o valor ainda é o que a proposta deixou.
Usuário-chave · Singularity > Singularity Chat, agente Analista de Slotting
Pedir a análise de slotting; para decidir, declarar em palavras o critério (ex.: aprovar as que aproximam da separação os itens de giro alto do DEP-01), conferir as propostas que casaram, com o motivo e se o destino ainda aceita, e clicar em «Aprovar» ou «Recusar» (a recusa pede motivo).
Resultado: O critério declarado fica gravado com a decisão; a proposta aprovada vira missão e aparece também em Slotting (Otimização) com a origem Singularity.
Consultor · Singularity > Consumo de IA
Acompanhar o orçamento do mês: Orçamento do mês, Usado, Chamadas ao modelo e a grade por pessoa (Quem usou, Chamadas, Custo, Última vez).
Resultado: A 80 % do orçamento aparece o aviso; a 100 % o Singularity fica bloqueado até o mês virar ou a Quanntco reajustar o contrato. A tela mostra quem usou e quanto custou, nunca o texto da conversa.
Quando dá errado 8
- A resposta diz que o Singularity está indisponível e oferece Repetir
Causa: O modelo de IA demorou ou falhou. Nada foi inventado no lugar.
Solução: Clicar em Repetir; se falhar outra vez, esperar um minuto e repetir.
- O chat para de responder e o Consumo de IA diz que o orçamento do mês acabou
Causa: O consumo chegou a 100 % do orçamento mensal.
Solução: Esperar o mês virar ou pedir à Quanntco o reajuste do contrato. O aviso de 80 % é o momento de conversar antes do bloqueio.
- O chat recusa o arquivo anexado
Causa: O agente não recebe anexo, o tipo não está liberado nele, passou de 5 arquivos ou de 10 MB por arquivo, ou o arquivo não é imagem, PDF, CSV, planilha Excel ou texto.
Solução: Ligar Anexos na aba Guardrails do agente e publicar, ou converter o arquivo para um tipo aceito.
- A comparação é recusada pedindo para confirmar a tabela
Causa: A tabela foi lida da imagem ou do PDF pela IA e ainda não foi conferida.
Solução: Conferir as células no painel e clicar em «Confirmar a tabela».
- A ferramenta de IA da equipe do cliente recebe recusa ao ler
Causa: Credencial vencida ou revogada, usuário dono desativado, consulta não liberada na credencial, limite por minuto atingido ou MCP de saída não contratado.
Solução: Abrir «Leituras» na linha da credencial: a coluna Motivo diz qual. Renovar, ou criar outra credencial com o dono e as consultas certas.
- O sistema externo aparece como Pendente com o motivo Ferramenta mudou ou Cadastro mudou
Causa: O outro lado alterou uma ferramenta aprovada, ou alguém trocou endereço, autenticação ou credencial no cadastro.
Solução: Abrir o detalhe, conferir a coluna Situação das ferramentas, aprovar de novo e refazer o mapeamento de estoque.
- A resposta diz que o sistema externo não foi consultado
Causa: O sistema externo não respondeu, recusou a credencial ou está suspenso.
Solução: Usar «Conferir conexão» no detalhe; o campo Último erro mostra a causa. A resposta veio só com o que o armazém mostra.
- O agente não aparece no Singularity Chat para uma pessoa
Causa: O perfil dela não está em «Quem conversa com este agente», o agente está em rascunho ou arquivado, o agente da Quanntco está desligado neste cliente, ou o módulo dele (ex.: mão de obra) não está ligado.
Solução: Conferir no Singularity Studio a situação do agente e a aba Guardrails, e publicar; agente da Quanntco se liga em «Ligar neste cliente».
Mudar com a operação em curso 4
- Endereço, Autenticação ou Credencial do sistema externo
O cadastro volta a Pendente na hora e as aprovações e o mapeamento são apagados: as conversas em curso seguem só com o que o armazém mostra e avisam que o outro lado não foi consultado, até nova aprovação.
Dá para voltar? Volta, mas o que já rodou fica como está
- SKU, Quantidade e Unidade
As comparações já feitas ficam como estão na conversa. As próximas cruzam pelos campos novos; mapeamento errado aparece como divergência em todos os itens.
Dá para voltar? Volta ao valor anterior sem sobra
- Quem conversa com este agente, Depositantes, Temas que o agente recusa ou Anexos (ao publicar)
Vale para as conversas abertas depois da publicação: cada conversa fica presa à versão com que nasceu, e quem está no meio de uma segue com as regras antigas até abrir «Nova conversa». A versão anterior fica guardada e volta com «Voltar para esta» na aba Versões.
Dá para voltar? Volta ao valor anterior sem sobra
- Revogar ou Renovar a credencial de acesso externo
A ferramenta de fora para de ler no mesmo instante; na renovação, volta a ler só depois que a equipe colar o segredo novo. A revogação não se desfaz.
Dá para voltar? Não se desfaz