…
Início do curso

Proteção de Agentes com OpenShell e NemoClaw

Resumo

Agentes modernos estão por toda parte e partem de uma ideia simples: um modelo conectado a ferramentas, memória e uma decisão de roteamento que continua em execução até concluir a tarefa. O curso começa com a construção desse sistema do zero e liga cada etapa aos frameworks usados por profissionais de software e por pessoas sem formação técnica. Você avançará de uma chamada de API para coordenação entre agentes, recuperação fundamentada, planejamento profundo e implantação segura com NVIDIA OpenClaw e NemoClaw™.

1Confirme as rotas de modelo abaixo. Chat e embeddings usam por padrão os modelos do build.nvidia.com. Você pode trocar o modelo e o endpoint de cada rota conforme o desempenho necessário.
2Siga os módulos em ordem para percorrer o caminho padrão ou vá diretamente à tarefa de que precisa. Cada página termina em um artefato ativo no navegador, com seu JavaScript disponível para inspeção e adaptação.
3Crie um launchable do NemoClaw para hospedar a stack do curso: OpenClaw dentro do OpenShell, a partir do blueprint do NemoClaw. Isso pode ser reproduzido localmente sem acesso a GPU usando endpoints de modelos.

Objetivos de aprendizagem

Ao concluir o curso, você saberá:

  • Construir um ciclo básico de agente e identificar seus componentes centrais.
  • Implementar uso confiável de ferramentas e chamadas de função em um sistema de agentes.
  • Projetar e coordenar sistemas multiagente com padrões estruturados de roteamento.
  • Usar o OpenShell para configurar identidades de agentes e garantir operações seguras em sandbox.
  • Implantar e gerenciar agentes autônomos enquanto cria bibliotecas persistentes de skills.
O mascote do NemoClaw segura o escudo do OpenShell ao lado de uma estação de trabalho de IA local.
NemoClaw para OpenClaw em uma estação de trabalho local.
Fonte: cartão do blueprint no NVIDIA Build.

Como informar sua chave de API

O navegador salva as rotas de chat e embeddings entre as aulas e envia cada chave somente ao endpoint selecionado. Use uma rota personalizada apenas quando tiver um endpoint HTTPS acessível.

Como usar estas lições

Execute os exemplos, examine a saída e altere uma entrada para comparar os resultados. O JavaScript fica no controle de código de cada célula; você pode ler e executar os exemplos antes de editar o código.

Clique no título de uma seção ou na seta para expandir ou recolher essa seção. A cor reforça o texto: azul indica informação, âmbar indica um alerta e vermelho indica um erro. Leia o texto em vez de depender apenas da cor.

Use Seções para encontrar uma seção. Os links dos títulos podem ser salvos ou compartilhados. O assistente pode considerar a seção atual ao responder. Os controles de modelo e sessão são opcionais; comece perguntando sobre o exemplo que está lendo.

Se uma solicitação ao modelo falhar

Parar cancela a solicitação atual. Uma mensagem de solicitação abortada, sozinha, não revela se houve cancelamento, navegação ou interrupção da conexão. Guarde o erro visível e qualquer saída parcial. Um tempo limite excedido significa que nenhum cabeçalho de resposta ou dado do fluxo chegou dentro da espera configurada.

Se o exemplo apenas consulta o modelo, confira o acesso configurado acima, espere um pouco e execute novamente uma vez. Se a falha se repetir, anote a lição, o link da seção, o rótulo da célula, o modelo, o erro e o horário. Nunca inclua uma chave de API. Antes de repetir uma ferramenta ou comando que altere arquivos, agende trabalho ou crie uma sessão, confira se a primeira tentativa já realizou a ação.

Para HTTP 401 ou 403, confira as credenciais e as permissões. HTTP 429 indica limitação de solicitações; espere antes de tentar de novo. Uma resposta 5xx pode indicar falha do provedor ou do relay. Tratamento da solicitação, na configuração, controla a espera e as novas tentativas opcionais antes do início da transmissão. Aumentar o tempo de espera ou o número de tentativas não corrige credenciais inválidas. Relate falhas persistentes pelo link de suporte no rodapé desta página.

Como explorar o material

Você pode fazer os módulos a seguir conforme sua preferência ou em ordem. Fique à vontade para alternar entre eles, mas lembre-se de que alguns se baseiam nos anteriores. Cada módulo termina com um artefato ativo, e o código de suporte está disponível para consulta e adaptação. Você pode alterar os exemplos no navegador, hospedá-los por conta própria ou fornecer este repositório como contexto a um agente de código para uma implantação ou aplicação local.

Onde o curso é executado

O curso usa estes três sistemas pelo navegador. Cada cartão mostra a função do sistema e abre o serviço ou catálogo correspondente.

A interface do curso é executada no GitHub Pages. As chamadas ao modelo usam o endpoint que você configurou. Os módulos 3 e 4 se conectam ao launchable do NemoClaw no Brev, com uma implantação local compatível como alternativa.