WASViking Docs
⌘K
WASViking AI GuardianPrimeiros passos

Crie um agente seguro

Dê a cada agente de IA a proteção dele em um só lugar. Escolha quem usa, as ferramentas e os modelos, um nível de proteção e a governança, revise o efeito e o teste do motor de políticas e publique. Cada publicação é uma versão que você pode restaurar, e um agente pode ser pausado na hora.

O Secure Agents do WASViking® AI Guardian coloca em uma só tela tudo que protege um agente de IA: quem usa, as ferramentas que ele recebe pelo MCP Gateway, os modelos que ele chama pelo AI Gateway, os controles em cada chamada e o registro dele no AI Governance. Você muda em um rascunho, vê o efeito em palavras simples e a decisão do motor de políticas de verdade, e publica quando estiver certo.

Um agente aqui não é um tipo novo de objeto. Publicar grava as mesmas coisas que você já consegue configurar à mão: um gateway MCP, um toolkit, um workload do AI Gateway, regras de política do AI Guardian e um caso de uso do AI Governance. Elas continuam visíveis nas próprias telas, então nada fica escondido e nada do que você já configurou muda.

Antes de começar

  • O Secure Agents exige o AI Gateway ou o MCP Gateway no seu contrato (os dois são add-ons a partir do plano Pro). Os agentes publicados vêm incluídos por plano: 3 no Pro, 10 no Business e 25 no Enterprise.
  • Para criar e editar rascunhos você precisa de um papel de administrador, ou de um papel com acesso de gestão ao AI Gateway.
  • Para publicar, pausar ou arquivar um agente você precisa de um papel de administrador, ou de um papel com acesso de gestão ao AI Gateway, às políticas do AI Guardian e ao AI Governance juntos, porque uma publicação muda os três.
  • Cada módulo que o agente usa precisa fazer parte do seu contrato e depois ser ligado: o MCP Gateway para um agente com ferramentas, e o AI Gateway (com uma credencial de provedor) para um agente com modelos. O seu parceiro ou a equipe comercial da WASViking inclui um módulo que não está no seu contrato.
  • As ferramentas que você quer precisam estar aprovadas no MCP Gateway antes. Só ferramentas aprovadas e limpas são oferecidas.

Passo 1: comece um agente

Abra AI Guard > Protection > Secure Agents e escolha um ponto de partida:

Ponto de partida O que ele define
Vulnerability triage Todas as ferramentas do servidor WASViking embutido; mudanças que você acrescentar esperam uma pessoa.
Read-only assistant Nada que muda alguma coisa é oferecido ou roda.
DevOps with approved changes Mudanças esperam aprovação, ferramentas destrutivas nunca rodam, dados pessoais são mascarados.
Start from scratch Um agente vazio cujas mudanças esperam aprovação.

Tudo pode ser mudado antes da primeira publicação. Você também pode começar por um agente que o WASViking encontrou: em AI Agents, abra o agente e clique em Protect this agent. O rascunho já vem com o nome e o dono dele, e o caso de uso fica ligado a ele.

Passo 2: monte o agente no canvas

A página do agente mostra o agente no meio e os blocos em volta. Clique em um bloco para abrir o painel dele e depois em Save to draft. Nada chega aos seus gateways até você publicar.

Bloco O que você escolhe
Who uses it Grupos do diretório e pessoas. Elas entram no endpoint do agente com a conta do WASViking.
Agent Nome, descrição e dono.
Models Se o agente chama modelos pelo WASViking, os modelos permitidos, orçamentos mensal e diário e as rotas para os provedores.
Tools Ferramentas escolhidas uma a uma, regras que pegam todas as ferramentas de um servidor ou tipo (inclusive as que chegarem depois), limites nos argumentos, toolkits existentes para compartilhar e se recursos e prompts são oferecidos.
Controls on every call Um nível de proteção, ou cada controle você mesmo. O bloco mostra o que uma leitura, uma mudança e uma chamada destrutiva vão encontrar.
Governance Propósito, unidade de negócio, nível de risco e os dados que o agente trata.

Os níveis de proteção:

Nível Ferramentas de leitura Mudanças Ferramentas destrutivas
Read only Rodam Nunca rodam Nunca rodam
Changes with approval Rodam Esperam a aprovação de uma pessoa Nunca rodam
Production protected Rodam Esperam aprovação; quem teve o e-mail vazado há pouco tempo só lê Nunca rodam
Custom Rodam Você decide Você decide

Todos os níveis também retêm resultados de ferramentas com instruções escondidas e mascaram segredos nos resultados; o Production protected também mascara dados pessoais. No Custom, uma escolha que deixa mudanças ou ferramentas destrutivas rodarem sem aprovação de ninguém pede a sua confirmação explícita no painel.

Deixe pronto para as pessoas

No topo da aba Design, o cartão Before people can use it lista o que ainda falta e coloca a solução ao lado de cada item:

Item A solução no cartão
Um módulo está desligado Turn it on, para um módulo do seu contrato. Um módulo fora do seu contrato precisa antes ser incluído pelo seu parceiro ou pela equipe comercial da WASViking.
Nenhum servidor MCP ainda Open the App Catalog
Ferramentas que ainda não podem ser usadas Review them: cada uma abre a sua revisão (veja abaixo)
Nenhuma credencial de provedor para os modelos Add a credential
Pessoas sem conta no WASViking Invite as AI Tools User: elas recebem o e-mail de convite e, depois de aceitar, entram no agente pelo cliente de IA. As regras de domínio de e-mail da sua organização valem.
O rascunho não está publicado Review and publish

Quando tudo está no lugar, o cartão mostra Ready for people.

Para revisar uma ferramenta, clique em Review ao lado dela na tabela What this agent offers, ou clique em uma ferramenta listada como não oferecida. Você vê a descrição, os achados do scanner, o que mudou desde a última aprovação e o que ela faz. Approve (ou Accept findings and approve, com uma nota), Save what it does para classificar de novo, ou Quarantine. Aprovar uma ferramenta faz ela poder ser usada onde for oferecida na sua organização, não só neste agente.

Passo 3: revise e publique

Clique em Review and publish. A revisão mostra:

  • O que muda, em frases simples: quem ganha ou perde o agente, as ferramentas que ele passa a oferecer ou deixa de oferecer, a proteção, os modelos, o orçamento e a governança.
  • Antes de publicar: o que impede a publicação, como falta de dono, nada a oferecer, modelos sem rota ou uma falha no teste.
  • Vale olhar: por exemplo, ninguém consegue usar o agente ainda, uma ferramenta espera revisão, ou um toolkit feito para todos os gateways também vale para este agente.
  • Teste do motor de políticas: o motor de políticas do AI Guardian de verdade decide chamadas de prova (uma mudança em um alvo conhecido, em um desconhecido, em um de alto risco, uma ferramenta destrutiva, um resultado com instruções escondidas, um resultado com um segredo) e cada uma das ferramentas do agente, com as regras novas e todas as outras regras da sua organização. Uma decisão mais fraca do que a proteção promete impede a publicação; uma mais forte, vinda de outra regra sua, aparece como tal.

Acrescente uma nota se quiser e clique em Publish. O agente passa a valer na hora.

Passo 4: conecte clientes e automações

Abra a aba Access:

  • Connect an AI client: copie o endpoint ou a linha pronta para o Claude Code ou o Cursor. As pessoas entram com a conta do WASViking e veem só as ferramentas deste agente.
  • Keys for automations: clique em Create a key para um pipeline ou um serviço. A chave recebe as ferramentas do agente na hora. Copie quando ela aparecer; o WASViking guarda só um hash. As chaves vencem em 90 dias e podem ser revogadas aqui.
  • Models: quando o agente tem modelos, copie a URL base para o SDK do modelo e crie uma chave de modelo.
  • See what a person gets: escolha uma pessoa e clique em Show. O gateway responde com as ferramentas que essa pessoa recebe do agente publicado e por que as outras ficam de fora (não foi dado a ela, espera revisão, a proteção não permite, precisa da conta dela no servidor).

Acompanhe o que o agente faz

A aba Activity mostra as chamadas de ferramentas do agente nos últimos 30 dias, as chamadas recusadas, o que espera aprovação, os resultados mascarados ou retidos, o gasto com modelos em relação ao orçamento e a saúde dos servidores que ele usa. Os pedidos que esperam uma pessoa ficam em Approvals: clique em Approve, ou em Deny com um motivo. Ninguém decide o próprio pedido. Eles também aparecem em Approvals & Exceptions, junto com os dos outros gateways.

Mude com segurança

  • Rascunho: toda edição fica no rascunho até você publicar. Discard changes volta o rascunho para a versão publicada.
  • Histórico: toda publicação fica guardada com o efeito e quem publicou. Load into draft traz uma versão anterior de volta para revisar e publicar.
  • Pause: desliga os gateways do agente na hora; toda chamada responde que o gateway está desligado. Resume liga de novo.
  • Archive: pausa o agente e desliga as regras de política dele. Restore traz de volta pausado.
  • Segunda aprovação: no bloco Agent, ligue Second approval e toda publicação espera outro administrador, que aprova ou recusa na página do agente. Só um administrador da organização consegue desligar.

Mudado fora do builder

Os objetos de um agente continuam sendo objetos comuns. Se alguém editar o toolkit, o gateway, o caso de uso ou uma das regras do agente em outra tela, a página do agente marca o bloco como Changed outside e diz o que mudou. A próxima publicação só coloca a versão do agente de volta depois que você confirmar na revisão.

Uso e limites

Os agentes publicados contam na franquia do seu contrato: 3 vêm incluídos no Pro, 10 no Business e 25 no Enterprise. Um agente pausado continua contando; rascunhos e agentes arquivados não contam, e publicar uma nova versão de um agente que já está publicado não ocupa outra vaga.

  • Publicar acima da franquia é recusado com "Your contract allows N published agents. Archive an agent you no longer use, or ask your WASViking partner or WASViking for more." A mesma verificação vale quando uma segunda aprovação é dada.
  • Um painel logo abaixo do cabeçalho da tela Secure Agents mostra os agentes publicados frente à franquia, e a aba AI Guardian de Profile & Plan Usage traz os mesmos números em um cartão por módulo.
  • As chamadas de ferramentas e as requisições a modelos do agente contam no uso do MCP Gateway e do AI Gateway. Quando um deles segura novas chaves depois de 30 dias acima do contrato, as chaves criadas na aba Access também esperam. As chaves existentes continuam funcionando e nada é cobrado automaticamente.

Quem aumenta a franquia é o seu parceiro WASViking, ou a equipe comercial da WASViking se você compra direto. Se a sua organização recebeu o Secure Agents como um trial de 60 dias quando os módulos foram empacotados, o painel também mostra a data em que o trial termina.

Solução de problemas

O que você vê O que fazer
Uma ferramenta aparece na tabela marcada como esperando Aprove em MCP Gateway > Tools & Security; até lá ela fica escondida do agente.
"Not offered because the protection does not allow what they do" A ferramenta muda alguma coisa e o nível é Read only, ou ela é destrutiva e o nível não permite ferramentas destrutivas. Mude o nível ou tire a ferramenta.
"Toolkits for every MCP gateway also apply to this agent" Um toolkit sem lista de gateways vale para todos os gateways de toolkits, inclusive o deste agente. Limite aos gateways dele em MCP Gateway > Toolkits para manter o agente só com as próprias ferramentas. Os controles do agente continuam valendo para ele.
"Another gateway already uses the identifier" Os gateways do agente se chamam agent-<name>. Renomeie o outro gateway ou o agente antes da primeira publicação.
"The test could not run" O motor de políticas não respondeu. Tente de novo em instantes.
"Nothing to publish" O rascunho é igual à versão publicada. Mude um bloco antes.
"Your contract allows N published agents" Todos os agentes publicados do seu contrato estão em uso. Arquive um agente que você não usa mais, ou peça mais ao seu parceiro WASViking ou à WASViking.
Ao criar uma chave, o portal avisa que a organização está há 30 dias acima do uso contratado do AI Gateway ou do MCP Gateway O AI Gateway ou o MCP Gateway segura novas chaves até a capacidade ser aumentada. As chaves existentes continuam funcionando. Peça ao seu parceiro ou à WASViking para aumentar a capacidade.
O card mostra "Not in your contract", ou as chamadas do agente são recusadas com module_not_contracted O AI Gateway ou o MCP Gateway que o agente usa não faz parte do seu contrato, então não pode ser ligado. Peça ao seu parceiro ou à equipe comercial da WASViking para incluí-lo.

O que vem depois

  • Aprove as ferramentas de que os seus agentes precisam no MCP Gateway.
  • Cadastre credenciais de provedor e rotas no AI Gateway antes de dar modelos a um agente.
  • Inscreva um canal em AI Guardian Approval Requested para que quem aprova mudanças fique sabendo delas.