Pular para o conteúdo principal
RapidClaw

Pré-requisitos e Implantação pelo Assistente

Conclua estas etapas antes de implantar qualquer produto RapidClaw. Use uma assinatura dedicada e de propriedade do cliente no Azure.

1. Crie uma assinatura dedicada do Azure

  • Abra Assinaturas do Azure e crie uma assinatura de propriedade do cliente exclusiva para o RapidClaw. Dê um nome claro, como RapidClaw Produção ou RapidClaw Piloto.
  • Confirme que a assinatura está ativa e que você pode criar recursos Azure e um registro de aplicativo. Peça ajuda ao administrador do Azure se necessário.
  • A pessoa que executa o Setup se torna o primeiro administrador do Command Center.
  • Defina um alerta de orçamento para a assinatura. Tenha um orçamento mensal e um e-mail de notificação pronto para o Setup. Alertas avisam você, mas não impedem gastos.

2. Escolha uma região compatível

  • Australia East
  • East US 2
  • South India
  • Sweden Central
  • West US 3

Use a mesma assinatura e região para as verificações e solicitações abaixo. O Setup verifica em tempo real a disponibilidade da VM, rede, modelos e embeddings antes da implantação.

3. Registre os provedores de recursos

Registre primeiro o Microsoft.Compute para que o Setup possa ler a cota de VM. O registro requer permissão de nível de assinatura /register/action, incluída em Colaborador e Proprietário. Ainda são necessárias as permissões de implantação listadas na etapa 1.

Portal do Azure: Abra sua assinatura > Configurações > Provedores de recursos. Registre os provedores ausentes da tabela abaixo; ignore os que já estiverem registrados.

ProvedorUsado para
Microsoft.ComputeVM e verificações de cota de VM
Microsoft.NetworkRede virtual, IP público e grupo de segurança de rede
Microsoft.KeyVaultSegredos de runtime
Microsoft.StorageArmazenamento para implantação e diagnóstico
Microsoft.DBforPostgreSQLBanco de dados PostgreSQL Flexible Server
Microsoft.CognitiveServicesModelos Microsoft Foundry / Azure OpenAI
Microsoft.InsightsMonitoramento e alertas
Microsoft.ConsumptionAlertas de custo
Microsoft.AuthorizationAtribuição de função de identidade de runtime; registrado por padrão
Microsoft.AlertsManagementGerenciamento de alertas

Alternativa via CLI: No Cloud Shell do Azure ou em uma sessão autenticada do Azure CLI, substitua <subscription-id> pelo ID da sua assinatura do RapidClaw:

az provider register --namespace Microsoft.Compute --subscription <subscription-id>
az provider show --namespace Microsoft.Compute --subscription <subscription-id> --query registrationState --output tsv

Repita para os demais provedores ausentes, trocando Microsoft.Compute por cada namespace. Aguarde o Registered antes de seguir. O registro habilita um serviço; não cria recursos de runtime nem garante cota. Pode adicionar um aplicativo gerenciado pelo Microsoft ao seu tenant. Orientação de registro do Microsoft.

4. Verifique a cota da família de VMs

O RapidClaw usa uma VM Standard_D2as_v6. Sua região precisa de pelo menos 2 vCPUs disponíveis tanto em Standard DASv6 Family vCPUs quanto em Total Regional vCPUs.

  1. Abra sua assinatura do Azure > Uso + cotas.
  2. Filtre por Compute e pela região escolhida.
  3. Para ambas as entradas de cota, confirme que limite - uso atual seja pelo menos 2.
  4. Se alguma estiver abaixo, solicite um aumento ou verifique outra região compatível.

Entradas de cota ausentes? Verifique o registro do Microsoft.Compute, os filtros de assinatura e região, e seu acesso. Ter cota suficiente não garante capacidade de VM. Orientação sobre cota de vCPUs do Microsoft.

5. Solicite cota de Microsoft Foundry

Não é necessário criar um projeto Foundry ou recurso Azure AI antes; o RapidClaw cria os seus durante a implantação. A cota de modelo é separada da cota de VM.

Solicite a cota antes da data de implantação

A aprovação pode levar alguns dias e não é garantida. O Microsoft prioriza clientes que utilizam sua alocação existente. Prossiga apenas quando o Setup confirmar que todos os pré-requisitos foram aprovados.

Abrir formulário de solicitação de cota do Microsoft.

  1. Campos 1-8: insira seu nome, e-mail corporativo, razão social e endereço da empresa.
  2. Campo 9 (Subscription Id): insira o ID da sua assinatura dedicada do RapidClaw, não o ID do seu tenant.
  3. Campo 10 (Justification): adapte o texto sugerido abaixo para a sua implantação e uso estimado.
  4. Campos 11-16: utilize a tabela abaixo. Se o Microsoft alterar a numeração, use o nome dos campos para confronto.

Seleções recomendadas para o formulário

Campo do formulário do MicrosoftValor a ser inserido
11. Quota TypeModel Deployment (PTU/RPM/TPM)
12. Model TypeAzure OpenAI
13. (Azure OpenAI) Quota Request TypeGlobal Standard
14. (Azure OpenAI) Global Standard Modelgpt-5.6-sol
15. Global Standard RegionSua região compatível selecionada na etapa 2.
16. Global Standard Quota300 kTPM (300.000 tokens por minuto). Informe a cota total necessária, não a quantidade adicional.

Justificativa sugerida

Estamos implantando o RapidClaw em nossa assinatura Azure para executar agentes de SI para fluxos de trabalho de negócios, tarefas agendadas e Microsoft Teams/e-mail, com aprovações e controles de auditoria. Solicitamos 300 kTPM de cota Global Standard para gpt-5.6-sol na região Azure compatível escolhida. Faremos o monitoramento do uso e configuraremos um alerta mensal de custos.

Se o Setup sinalizar falta de cota de embedding, envie uma solicitação separada para text-embedding-3-small: 10 kTPM na mesma assinatura e região, usando o tipo de implantação exigido por Setup. Inclua nas solicitações a cota já consumida por outras cargas de trabalho para garantir o suficiente para o RapidClaw.

Envie a solicitação e aguarde a resposta do Microsoft. Se for oferecida outra região ou modelo, confirme que o RapidClaw é compatível antes de aceitar. Após a aprovação, execute novamente a checagem de pré-requisitos do Setup na mesma assinatura e região.

A cota é um limite de taxa, não um consumo pré-pago ou limite de gastos. O Azure cobra pelos tokens usados. Orientação sobre cota do Microsoft.

6. Execute o Setup

Quando todas as checagens de pré-requisitos forem aprovadas, a implantação normalmente leva cerca de 20 minutos. O Setup é executado no servidor e pode recuperar o progresso se você atualizar a página ou fizer login novamente.

  1. Conectar: Faça login, crie ou recupere o registro de aplicativo, valide seu direito e selecione a assinatura.
  2. Implantar: Selecione a região, passe pelas checagens de pré-requisito, defina o orçamento e o e-mail de alerta, e provisione os recursos do Azure.
  3. OpenClaw: Instale o runtime e os serviços RapidClaw verificados e de versão estendida-estável.
  4. Agentes: Instale agentes, habilidades, agendas, políticas e a extensão de produto.
  5. Teams: Publique o pacote do Teams específico do tenant e verifique sua conexão.
  6. Command Center: Verifique a saúde do runtime e abra a experiência do administrador.

O que é implantado

ConfiguraçãoImplantação atual
Máquina virtualStandard_D2as_v6
Sistema operacionalUbuntu 24.04 LTS Gen2
OpenClawÚltima versão estendida-estável verificada do RapidClaw
Banco de dados de runtimeBanco de Dados para PostgreSQL Flexible Server do Azure de propriedade do cliente
SegredosArmazenamento protegido com suporte ao Azure Key Vault
Plano de SIImplantações diretas Microsoft Foundry / Azure AI verificadas, além de text-embedding-3-small

Após a implantação

  • Verifique runtime, modelos, conectores, Teams, assinatura, memória, uso e integridade no Command Center.
  • Revise agentes, habilidades, políticas e Pacotes de Agentes específicos do produto. Deixe agendas desativadas até compreender seu escopo, ferramentas, entrega e aprovações.
  • Monitore gastos pelos alertas de custo do Azure e pelo Usage & Costs no Command Center.

Solução de problemas na etapa de Implantação

Mensagem de cota da família de VMs

"Standard_D2as_v6 não está disponível com cota suficiente de núcleo da família em <região>."

  1. Verifique se o Microsoft.Compute está Registered na assinatura selecionada no Setup. Um provedor não registrado pode causar essa mensagem.
  2. Certifique-se de que tanto a cota de família de VM quanto a regional total tenham ao menos 2 vCPUs disponíveis. Solicite aumento, se necessário.
  3. Se ambas as cotas forem suficientes, confira a disponibilidade do tamanho da VM e o erro detalhado do Azure.

Microsoft.Compute não está registrado

Registre o Microsoft.Compute na assinatura mostrada pelo Setup, aguarde o Registered e tente novamente. Depois, resolva quaisquer outros erros de cota ou capacidade separadamente.

Tamanho da VM não está disponível na região

Escolha outra região compatível onde a VM, cota, modelos e embeddings estejam disponíveis. Para manter sua região original, siga a orientação sobre disponibilidade de SKU do Microsoft. Apenas aumentar a cota não resolve indisponibilidade de capacidade de VM.