Perguntas frequentes

Acesso

Quem pode usar o Model Router? Organisation Administrators, em instalações Technology Stack. Abra-o pelo menu principal, no grupo AI Modules & Agents.

Cobrança e créditos

É uma assinatura? Não — é pré-pago. Você recarrega um saldo em USD, e o uso o consome pelo preço por token de cada modelo. Não há nenhuma cobrança recorrente de IA além do que você usa.

O que acontece quando o saldo acaba? As solicitações de inferência são bloqueadas com um erro de créditos insuficientes até que você faça uma recarga. Nada é perdido — chaves, serviços conectados, configurações e histórico permanecem —, e as solicitações são retomadas instantes após a recarga. Habilite a recarga automática para evitar interrupções.

Posso obter o reembolso do saldo não utilizado? Abra uma solicitação de suporte. Os reembolsos aparecem no histórico de transações como um tipo próprio.

Recebo recibos? Sim — cada recarga tem um número de recibo e um PDF para download na gaveta de detalhes da transação, e o recibo é enviado por e-mail aos contatos de cobrança da sua instalação. Para baixar vários de uma vez, marque as linhas no histórico de transações e clique em Download receipts (n). O uso não gera recibo: em vez disso, Monthly usage oferece um extrato de uso (PDF) e o detalhamento do uso (CSV) de cada mês. Esses são extratos de uso, não faturas. Os recibos do Model Router também aparecem junto com os outros documentos de cobrança da instalação em Invoices & Receipts, no Billing & Cost Management.

Por que "Spent today" difere de Monthly usage? Spent today e o saldo disponível são atualizados em tempo real, enquanto Monthly usage é conciliado com o seu saldo a cada 15 minutos. Os valores convergem na próxima conciliação. O histórico de transações lista somente recargas e ajustes de saldo, então o uso não aparece lá de forma alguma.

Como é precificado o Auto Router? Ele não tem um preço próprio — você paga a tarifa do modelo que ele escolhe para cada solicitação. Os logs mostram qual foi esse modelo.

Privacidade e dados

Os meus prompts ou as respostas da IA são armazenados? Não. Activity e Logs registram somente metadados — modelo, tokens, custo, latência, status, chamador. O conteúdo dos prompts e das respostas nunca é armazenado pelo Performance Hub.

Posso impedir que dados pessoais cheguem aos modelos? Sim — habilite o PII masking em Settings → Guardrails e adicione filtros de conteúdo personalizados para tudo o que for específico do seu domínio. Consulte Guardrails.

Posso restringir para quais provedores os meus dados vão? Sim — a página Models tem predefinições de um clique (por exemplo, Western providers, descrita como "data-sovereignty friendly") e botões de ativação por modelo. As chaves e os serviços conectados podem ser ainda mais restritos. Consulte Models.

Chaves de API e integrações

Que software posso conectar? Qualquer software que use a API da OpenAI e permita definir um URL base e uma chave de API personalizados (BYOK) — os SDKs da OpenAI, a maioria dos frameworks de IA e muitas ferramentas prontas. Consulte Como conectar o seu aplicativo.

Posso ver o segredo da chave novamente depois de criá-la? Não — ele é exibido exatamente uma vez. Se ele for perdido, use Rotate na chave para obter um novo segredo.

Quantas chaves devo criar? Uma por sistema. Os rótulos tornam o uso de cada sistema visível em Activity e Logs, e uma chave comprometida pode ser rotacionada sem afetar mais nada.

Qual é a diferença entre revogar e excluir uma chave? Revogar desativa a chave imediatamente, mas de forma reversível (Re-activate a restaura). Excluir é permanente.

Uma chave pode ser limitada a modelos específicos? Sim — use Restrict models for this key na configuração da chave. O mesmo vale para cada serviço conectado.

AI Agents e Workflows

Os meus AI Agents precisam de uma chave de API? Não. Os agentes pareados com a sua instalação se conectam automaticamente com credenciais por dispositivo gerenciadas pelo Performance Hub. Eles aparecem em Settings → Service Access & API Keys → Connected Services, com gasto e controles próprios.

Os Workflows podem usar o Model Router? Sim. Os Workflows podem se conectar como um serviço e, em seguida, aparecem em Connected Services ao lado dos seus AI Agents.

Posso limitar o gasto de um único agente ou workflow? Sim — com limites diários, mensais e vitalícios por serviço, além de limites de taxa, restrições de modelos e substituições de proteções. Consulte Connected Services.

Modelos e roteamento

Qual modelo a minha integração deve usar? auto (o Auto Router) é o padrão recomendado — ele direciona cada solicitação para um modelo adequado à complexidade, de modo que tarefas simples vão para modelos rápidos e baratos, e tarefas difíceis recebem os modelos mais avançados. Ou use qualquer ID de modelo específico habilitado na sua instalação.

Por que os meus logs mostram um modelo diferente do que solicitei? Você solicitou auto — os logs mostram o modelo escolhido pelo roteador, e a gaveta da solicitação registra auto como Requested model. Esse é o comportamento esperado.

Posso alterar para onde auto direciona? Sim — Edit routing no cartão Auto Router permite escolher o modelo de cada nível de complexidade para a sua instalação, com a opção Reset to default disponível. Consulte Models.

Um modelo que eu quero não está no catálogo. Use o link Raise a support request na página Models: "Want to see a model added? Raise a support request and we'll add it if it's generally available."

Limites

Qual é a diferença entre o saldo e um limite de gasto? O saldo é o dinheiro que você creditou; os limites de gasto são tetos de política que você escolhe. Ambos podem bloquear solicitações: um saldo vazio bloqueia até que você faça uma recarga; um limite atingido bloqueia até que a sua janela seja redefinida (ou até que você o altere). Consulte Como funciona.

Quando exatamente os limites diários e mensais são redefinidos? O diário à meia-noite e o mensal no dia 1º — ambos no fuso horário local da instalação. A mensagem de erro de orçamento excedido informa o horário exato da redefinição.

O teto vitalício rígido se redefine sozinho? Não. Ele conta o gasto desde a última redefinição manual. Reset hard cap reinicia o contador a partir de $0 (o valor do teto não muda) e salva o período encerrado no histórico de redefinições.

Os limites por chave e os limites da conta se somam? Sim — ambos se aplicam. Para ser executada, uma solicitação precisa respeitar os limites da conta e os limites próprios da chave ou do serviço que fez a chamada (além do saldo).