Primeiros passos

Este guia leva uma instalação do zero até uma primeira solicitação funcionando em três etapas e, em seguida, mostra como verificar se deu certo.

Antes de começar

• Você precisa ser um Organisation Administrator. O Model Router está disponível somente para Organisation Administrators, em instalações Technology Stack.
• Selecione a instalação que você quer configurar usando o seletor de instalação na barra de ferramentas principal do Performance Hub.
• Tenha um cartão de cobrança armazenado para a instalação ou esteja pronto para adicionar um. As recargas são cobradas no seu cartão de cobrança armazenado; se não houver nenhum cadastrado, a página Balance & Top-up mostra "No card on file." com um link Add payment details.

Etapa 1 — Habilitar o Model Router

Abra o Model Router pelo menu principal (no grupo AI Modules & Agents). Se o módulo ainda não tiver sido habilitado para esta instalação, você verá a página Welcome to Model Router:

"Ofereça à sua empresa acesso pré-pago a um catálogo de principais AI models por meio de um único ponto de extremidade compatível com OpenAI. Seus AI Agents do Performance Hub se conectam automaticamente, e você pode criar chaves de API para integrar os mesmos models ao seu próprio software — com Spend Limits e total visibilidade de uso."

Figura 1: A página Welcome to Model Router que uma instalação vê antes de o módulo ser habilitado

A página tem três botões: Enable Model Router, Read the documentation (que abre esta documentação) e Explore first without enabling. Abaixo deles, três etapas descrevem a configuração:

Cada etapa também tem um link Learn more.

Clique em Enable Model Router (ou Enable module) para ativar o módulo.

A checklist de configuração

Depois que você habilita o módulo, um banner com a checklist de configuração é exibido na parte superior do Model Router até que a configuração seja concluída. Ele se chama Finish setting up Model Router e mostra uma estimativa de tempo (por exemplo, ~3 min left), quantas etapas foram concluídas (por exemplo, 2 of 3 complete) e um botão Resume que expande a checklist completa. Cada etapa tem Review (ou Review again) e Learn more; Collapse a recolhe novamente. Quando falta uma etapa, o subtítulo expandido diz "Just one step to go before AI requests start flowing. Steps can be done in any order."

Figura 2: O banner da checklist de configuração, exibido até que a configuração seja concluída

As etapas obrigatórias são Add a billing card, Top up your balance e Connect an agent or create an API key. As etapas opcionais — Set spend limits, Turn on auto top-up e Verify your first request — podem ser dispensadas com Skip for now.

Etapa 2 — Fazer a sua primeira recarga

Acesse Budgets & Limits → Balance & Top-up.

Figura 3: O cartão Top up balance (predefinições, valor, cartão armazenado) e o cartão Auto top-up

1. No cartão Top up balance, escolha uma predefinição ($25, $50, $100, $250, $500, $1000) ou digite um valor. "Minimum top-up is $10."
2. Confira o cartão armazenado exibido abaixo do valor (por exemplo, "Amex ending 0005 · exp 06/29"). Use Edit payment details se ele precisar ser atualizado.
3. Clique em Top up $–.––. Em caso de sucesso, você verá "Top-up successful. Your balance has been credited." As recargas aparecem no saldo instantaneamente.

Recomendado: no cartão Auto top-up, ative Enable auto top-up, defina When balance is below e Top up by (também no mínimo $10) e clique em Save changes. A partir daí, o seu cartão é cobrado automaticamente sempre que o saldo cair abaixo do limite mínimo, para que a inferência nunca pare inesperadamente. Consulte Orçamentos e recargas para obter detalhes.

Etapa 3 — Enviar a sua primeira solicitação

Escolha o caminho que se aplica a você:

Se você tem AI Agents ou Workflows

Não há nada a configurar — os dispositivos de Agente de IA pareados com esta instalação se conectam automaticamente, e os Workflows também podem se conectar. Abra Settings (engrenagem) → Service Access & API Keys e confirme se o seu agente aparece em Connected Services com o status On-line. Consulte Connected Services.

Se você está conectando o seu próprio software

1. Abra Settings (engrenagem) → Service Access & API Keys e clique em Create key. Copie o segredo da caixa de diálogo "Copy your API key" — "This is the only time the full key is shown. Store it somewhere safe."
2. Use o Base URL e o exemplo de solicitação exibidos no cartão Connecting to the API, na mesma página. Um teste mínimo:

curl https://app.performancehub.co/ai/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "auto", "messages": [{"role": "user", "content": "Hello"}]}'

Consulte Como conectar o seu aplicativo para ver exemplos em Python e TypeScript.

Etapa 4 — Verificar

Abra a guia Logs. A sua solicitação de teste deve aparecer em instantes, com o modelo, as contagens de tokens, o custo, a velocidade e o status success. Se ela não aparecer, consulte Solução de problemas.

Próximas etapas recomendadas

• Defina limites de gasto — Budgets & Limits → Spend Limits. Um teto mensal é uma rede de segurança sensata; consulte Orçamentos e recargas.
• Revise o catálogo de modelos — Settings → Models. Todos os modelos vêm habilitados por padrão; use as predefinições rápidas para restringir o conjunto se você tiver preferências de provedor ou de orçamento. Consulte Models.
• Considere usar proteções — Settings → Guardrails para mascaramento de PII, ocultação de segredos e proteção contra injeção de prompt. Nenhuma vem habilitada por padrão. Consulte Guardrails.