Sua primeira requisição protegida pelo AI Gateway
Um primeiro uso guiado do AI Gateway do WASViking AI Guardian. Ligue o gateway, adicione a chave do seu provedor, crie um gateway, uma rota e uma chave, envie uma requisição pelo terminal e veja-a no registro de requisições, com o resultado esperado em cada passo.
Este guia leva você de um WASViking® AI Gateway vazio até uma
requisição que passa por ele e aparece no registro de requisições. O exemplo usa
a OpenAI e o modelo gpt-4o-mini; os passos são os mesmos para Anthropic,
Google Gemini e os outros provedores que o gateway aceita. Reserve uns quinze
minutos.
Cada passo diz o que você deve ver. Se o resultado for diferente, a tabela de solução de problemas do guia completo do AI Gateway explica cada erro.
Antes de começar
- O AI Gateway faz parte do seu contrato com a WASViking, ou a sua organização o tem como avaliação. Se a tela dele mostrar uma página bloqueada com Ativar, peça ao seu parceiro ou à equipe comercial da WASViking para incluí-lo.
- Você tem um papel de administrador ou um papel com acesso de gestão ao AI Gateway.
- Você tem uma chave de API do seu provedor de modelos, com algum crédito na
conta. Na OpenAI, abra a plataforma da OpenAI, vá em API keys, selecione
Create new secret key e copie a chave que começa com
sk-. Uma requisição aogpt-4o-minicusta uma pequena fração de centavo. - Você tem um terminal com
curl(macOS e Linux já têm; no Windows use o PowerShell ou o Terminal do Windows).
Passo 1: abra o AI Gateway e ligue-o
No menu do portal, abra AI Guard, Proteção, AI Gateway. Um quadro chamado Configure seu primeiro AI Gateway lista os mesmos passos deste guia.
Selecione Ativar o AI Gateway, no canto superior direito.
O que você deve ver: a página recarrega, o aviso de que o AI Gateway está desativado some e o botão passa a mostrar Desativar.
Passo 2: adicione a chave do seu provedor
Abra a aba Provedores e modelos e selecione Adicionar credencial.
| Campo | O que informar |
|---|---|
| Nome | OpenAI teste |
| Provedor | OpenAI |
| URL do endpoint | Deixe vazio para usar o endpoint oficial. |
| Versão da API | Deixe vazio (só para Azure OpenAI). |
| API key | Cole a chave do provedor (sk-...). |
Selecione Salvar credencial. Na nova linha, selecione Testar.
O que você deve ver: uma mensagem verde, "O provedor aceitou a chave.", com os modelos que a sua chave alcança. Se a mensagem for vermelha, a chave foi recusada ou o provedor não respondeu; a mensagem diz qual dos dois.
Passo 3: crie um gateway
Um gateway é uma carga de trabalho, com chaves, modelos, guardrails, limites e orçamento próprios. Abra a aba Cargas de trabalho e selecione Novo gateway.
| Campo | O que informar | Por quê |
|---|---|---|
| Nome | Assistente de suporte | Um rótulo para o seu time. |
| Identificador | support-assistant |
Usado em condições de política e no registro de requisições. |
| Ambiente | Desenvolvimento | Aparece no gateway e nos relatórios. |
| Responsável | Eu | Quem responde por esta carga de trabalho. |
| Inspeção da entrada | Inspecionar e aplicar a política | As suas regras agem sobre os prompts. |
| Inspeção da resposta | Reter antes de liberar (pode bloquear ou ocultar) | Uma resposta pode ser retida ou ter dados ocultados antes de chegar à sua aplicação. |
| Quando a política não pode ser avaliada | Negar quando a política não pode ser avaliada | Nada passa sem verificação. |
| Requisições por minuto por chave | Mantenha 600. |
Um limite de taxa por chave. |
| Limite de tamanho da requisição (KB) | Mantenha 1024. |
Requisições maiores são recusadas. |
| Orçamento diário (USD) | 1 |
Teto de gasto estimado por dia. |
| Orçamento mensal (USD) | 10 |
Teto de gasto estimado por mês. |
| Modelos permitidos | gpt-4o-mini |
Só este modelo é aceito, o que você vai conferir no passo 7. |
| Modelos negados | Deixe vazio. |
Selecione Salvar gateway.
O que você deve ver: o gateway aparece na lista como ativo.
Passo 4: ligue o gateway ao seu provedor
Abra a aba Roteamento e failover.
| Campo | O que informar |
|---|---|
| Gateway | Assistente de suporte |
| Credencial | OpenAI teste |
| Modelos | Mantenha * (todos os modelos que o gateway permite). |
| Função | Principal |
| Atender como modelo | Deixe vazio (o mesmo modelo). |
| Ordem | Deixe vazio. |
Selecione Adicionar rota.
O que você deve ver: a rota listada sob o gateway, como principal e ativa.
Passo 5: crie uma chave para a sua aplicação
Abra a aba Acesso e chaves.
| Campo | O que informar |
|---|---|
| Gateway | Assistente de suporte |
| Rótulo | terminal-test |
| Pertence a | Uma conta de serviço |
| Nome da conta de serviço | svc-test |
| Expira em (dias) | Mantenha 90. |
Selecione Criar chave. A chave começa com wvag_. Selecione Copiar e
guarde-a em um lugar seguro: ela só aparece esta vez.
Passo 6: envie a sua primeira requisição
A aba Integrações mostra as URLs base da sua organização e exemplos prontos
para o SDK da OpenAI, o SDK da Anthropic e o Gemini REST. Este guia usa o
curl.
No terminal, guarde a chave do gateway em uma variável (troque
paste-your-wvag-key-here pela sua chave):
export WASVIKING_GATEWAY_KEY='paste-your-wvag-key-here'
Depois envie a requisição:
curl -s https://api.wasviking.com/ai-gateway/openai/v1/chat/completions \
-H "Authorization: Bearer $WASVIKING_GATEWAY_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "gpt-4o-mini", "messages": [{"role": "user", "content": "In one sentence, what is an AI gateway?"}]}'
O que você deve ver: uma resposta em JSON no formato de sempre do provedor.
O texto da resposta fica em choices[0].message.content. Acrescente -i depois
de curl para ver também os cabeçalhos: x-wasviking-routed-model diz qual
modelo respondeu.
Passo 7: veja a requisição no registro
De volta ao portal, abra a aba Tráfego.
O que você deve ver: uma linha para a sua requisição, com:
| Coluna | O que mostra |
|---|---|
| Quando | O horário da requisição. |
| Chamador | svc-test, o dono da chave. |
| Modelo | O modelo pedido e o que respondeu. |
| Decisão | Permitido |
| Status | 200 |
| Latência | Quanto tempo levou a ida e volta completa. |
| Custo | O custo estimado, a partir de preços de tabela. |
Selecione a linha para abrir o detalhe da requisição: as classes de dados encontradas, as versões de política e de detectores, os tokens e o trace id. O gateway nunca guarda o prompt nem a resposta, só a classificação deles.
Passo 8: duas verificações rápidas
Elas mostram o gateway decidindo antes de qualquer coisa chegar ao provedor.
- Um modelo que o gateway não permite. Envie de novo a requisição do passo
6 com
"model": "gpt-4o". A resposta é403com o códigomodel_not_allowed, e a aba Tráfego mostra a tentativa com a decisão Modelo não permitido. - Uma chave que não é válida. Envie a requisição com
-H "Authorization: Bearer wvag_not_a_real_key". A resposta é401com o códigoinvalid_api_key. Esta tentativa não aparece em Tráfego: a chave é recusada antes de o gateway saber a qual organização ela pertence.
Próximos passos
- Crie as regras que protegem os seus dados: bloquear segredos nos prompts, trocar dados pessoais antes de saírem, barrar injeção de prompt e reter respostas com segredos. O passo 7 do guia do AI Gateway lista essas regras, e o Simulador de políticas mostra o que uma regra faria antes de você aplicá-la.
- Aponte a sua aplicação real para o gateway: troque a URL base e a chave, e mantenha o SDK que ela já usa.
- Proteja as ferramentas que os seus agentes chamam com o MCP Gateway.