Rota Nacional

Índice da API do Rota Nacional: rotas, cota e como ligar o MCP.

Salva notas comuns. Leia primeiro e preserve notas relevantes. Em 409, releia e concilie as alterações. Exige chave da conta ou organização e conexão autorizada pelo administrador em Bots. Retenção segue a escolha do espaço. Requer conexão autorizada. Envie a versao lida por consultar_bots; mudança concorrente retorna 409. Não muda a política de gravação.

Interrompe a tarefa atual de um bot. Exige chave da conta ou organização e conexão autorizada pelo administrador em Bots. Retenção segue a escolha do espaço. Chave da conta ou organização, com conexão externa autorizada em Bots. Marca a tarefa como cancelada e pede cancelamento ao motor. Uma resposta tardia não entra no histórico. Trabalho que o provedor já processou pode ter custo.

Edita bot, memória ou gravação. Só administrador. Exige sessão do painel, com CSRF nas escritas; chave de API não basta. Só dono ou administrador da organização. Apenas a permissão de conexão pode mudar com tarefa em curso. Gravação também controla a captura de auditoria destas chamadas. Desligar a gravação remove a cópia salva do módulo; não expurga auditorias anteriores. A política das outras rotas /v1/* não muda.

Consulta bots, tarefas, conversas e memória da organização. Use antes de trabalhar. Para acompanhar tarefas, aguarde ao menos 10 segundos entre consultas. Exige chave da conta ou organização e conexão autorizada pelo administrador em Bots. Retenção segue a escolha do espaço. Chave da conta ou organização, com conexão externa autorizada em Bots. Consulta o mesmo espaço do app. Sem autorização, 403 bots_external_disabled.

Consulta os recibos de inferência do pagador autenticado. Não faz inferência nem altera saldo. Use id para um recibo ou cursor para continuar a lista. Mostra reserva, débito, devolução e estado; não revela conteúdo ou preços de terceiros. Exige credencial válida e a política de rede da conta. A recuperação permanece disponível durante suspensão de uso. Estados: reserved, dispatched, pending, settled e cancelled. A leitura não revela preços de outras camadas. POST reconcile usa apenas os contadores do provedor já registrados para esse pedido. POST cancel_reserved devolve somente uma reserva que ainda não foi marcada como enviada, sob bloqueio transacional. Não aceita tokens nem valores financeiros informados pelo cliente.

Chat pelos modelos da Rota (`rota/auto` escolhe pelo conteúdo), conforme a política de privacidade da organização. Pede a chave de API. Confira franquia e preço em /api/pricing antes de usar. Use a rota protegida compatível com a política da organização. Você não precisa incluir a mesma política e cobrança de uso em cada cliente. O gateway nativo preserva o corpo do provedor e não aplica a barreira. Rota externa exige aceite. Os controles não garantem detecção de todo dado pessoal nem inferência no Brasil.

Envia pedido ou encaminha resposta de outro bot. Pode consumir crédito. Exige chave da conta ou organização e conexão autorizada pelo administrador em Bots. Retenção segue a escolha do espaço. Chave da conta ou organização, com conexão externa autorizada em Bots. Responde 202 com a tarefa em andamento. A inferência usa a política, os limites e o crédito da organização. Até 1.024 tokens de saída, 150 segundos e uma tarefa por organização. Erro da inferência aparece em tarefa.erro. O id evita nova execução enquanto a mensagem estiver no histórico; não há retry automático.

Troca CPF, CNPJ, e-mail, telefone e nomes de um texto por marcadores (ou os remove), sem modelo nenhum. Pede a chave de API. A resposta traz o texto limpo e as categorias encontradas, nunca os valores. Mande `text`, `input` ou `items`; `policy` só endurece a da organização. A resposta traz o texto limpo e as categorias encontradas, nunca os valores.

Briefings de cibersegurança e notícias reescritos pela Rota Nacional, no ângulo de prompt, documento e chave. Público. Todo o histórico Cyber, sem notícias gerais da Inova e sem gerar Guias. Navegue por page ou leia /pt/cyber/feed.json e /pt/cyber/feed.xml. Páginas `/pt/cyber/` e `/en/cyber/`.

Guias práticos da Rota Nacional, com texto próprio, passos e critérios de verificação. Público. Derivados somente dos bookmarks do Radar quando o modelo encontra uma tarefa útil ao usuário do RN. Tamanho sozinho não basta; Cyber e notícias gerais da Inova não geram Guias. Páginas `/pt/guias/<slug>/` e `/en/guides/<slug>/`.

O catálogo curado de modelos `rota/*`, com janela de contexto e uso indicado. Público.

IDs e datas das publicações de Radar, Cyber e Guias. O histórico pessoal de leitura fica no navegador. O navegador compara com as peças já vistas, sem enviar o histórico de leitura ao servidor.

Briefings de engenharia reescritos pela Rota Nacional, com o link da fonte e o teste grátis. Público. Todo o histórico público dos bookmarks, inclusive os que renderam Guia. O modelo decide quando há orientação útil ao RN; segurança fica em Cyber. Navegue por page ou leia /pt/radar/feed.json e /pt/radar/feed.xml. Páginas `/pt/radar/` e `/en/radar/`.

Process a document through the organization's private Mistral connection. Requires an organization API key and recorded native consent. Sends the original document without the privacy barrier. A required organization privacy barrier blocks this tool before dispatch. Use an available native OCR model. Provider errors and charges retain their original meaning. Requires an organization API key, an active provider connection and a configured RN contract. Uses the organization's pool first. An inherited pool requires native consent from the consumer and supplier. The original provider body and model are preserved. Personal data is sent without the privacy barrier. An organization can set privacy_barrier_required in its inference settings. That requirement overrides key consent: native requests return 403 organization_privacy_barrier_required before body processing, billing or provider dispatch. The requirement also applies when the supplying organization's pool requires the barrier. Use /v1/chat/completions and the protected rota/* catalog when the request requires that barrier. Resources remain scoped to the organization and the connection that created them. A submitted request is not retried by the gateway. Provider charges remain on the connected provider account. Provider HTTP errors retain their status and original body; a provider 400 is not replaced with a gateway 502. Unsupported model parameters are not removed or translated. Omit X-RN-Connection-Id to select from the authorized pool. RN reserves its contracted fee before dispatch. Provider charges for an owned key remain on that provider account. Token tariffs and positive reference percentages require verified usage limits and provider counters. For OpenAI-compatible streaming under these tariffs, send stream_options.include_usage=true. Positive charges for opaque or batch creation calls require a per-request tariff when usage cannot be reconciled in that response. Unknown execution remains pending; the gateway does not invent zero usage or repeat the paid request.

Call Responses through the organization's private OpenAI connection. Requires an organization API key and recorded native consent. Sends the original input without the privacy barrier. A required organization privacy barrier blocks this tool before dispatch. Use protected chat instead. Provider charges use the connected account. Supply an available native model identifier. Requires an organization API key, an active provider connection and a configured RN contract. Uses the organization's pool first. An inherited pool requires native consent from the consumer and supplier. The original provider body and model are preserved. Personal data is sent without the privacy barrier. An organization can set privacy_barrier_required in its inference settings. That requirement overrides key consent: native requests return 403 organization_privacy_barrier_required before body processing, billing or provider dispatch. The requirement also applies when the supplying organization's pool requires the barrier. Use /v1/chat/completions and the protected rota/* catalog when the request requires that barrier. Resources remain scoped to the organization and the connection that created them. A submitted request is not retried by the gateway. Provider charges remain on the connected provider account. Provider HTTP errors retain their status and original body; a provider 400 is not replaced with a gateway 502. Unsupported model parameters are not removed or translated. Omit X-RN-Connection-Id to select from the authorized pool. RN reserves its contracted fee before dispatch. Provider charges for an owned key remain on that provider account. Token tariffs and positive reference percentages require verified usage limits and provider counters. For OpenAI-compatible streaming under these tariffs, send stream_options.include_usage=true. Positive charges for opaque or batch creation calls require a per-request tariff when usage cannot be reconciled in that response. Unknown execution remains pending; the gateway does not invent zero usage or repeat the paid request.

Current public prices, free allowances and payment discovery; does not create a charge.

Publica o resultado do seu trabalho na conversa, sem chamar outro modelo. Preserve o UUID ao repetir. Exige chave da conta ou organização e conexão autorizada pelo administrador em Bots. Retenção segue a escolha do espaço. Requer conexão autorizada. Texto aparece com origem MCP. UUID repetido com os mesmos dados não duplica; dados diferentes retornam 409. Não executa inferência.