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.
| Provedor | Usado para |
|---|---|
| Microsoft.Compute | VM e verificações de cota de VM |
| Microsoft.Network | Rede virtual, IP público e grupo de segurança de rede |
| Microsoft.KeyVault | Segredos de runtime |
| Microsoft.Storage | Armazenamento para implantação e diagnóstico |
| Microsoft.DBforPostgreSQL | Banco de dados PostgreSQL Flexible Server |
| Microsoft.CognitiveServices | Modelos Microsoft Foundry / Azure OpenAI |
| Microsoft.Insights | Monitoramento e alertas |
| Microsoft.Consumption | Alertas de custo |
| Microsoft.Authorization | Atribuição de função de identidade de runtime; registrado por padrão |
| Microsoft.AlertsManagement | Gerenciamento 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.
- Abra sua assinatura do Azure > Uso + cotas.
- Filtre por Compute e pela região escolhida.
- Para ambas as entradas de cota, confirme que limite - uso atual seja pelo menos 2.
- 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.
- Campos 1-8: insira seu nome, e-mail corporativo, razão social e endereço da empresa.
- Campo 9 (Subscription Id): insira o ID da sua assinatura dedicada do RapidClaw, não o ID do seu tenant.
- Campo 10 (Justification): adapte o texto sugerido abaixo para a sua implantação e uso estimado.
- 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 Microsoft | Valor a ser inserido |
|---|---|
| 11. Quota Type | Model Deployment (PTU/RPM/TPM) |
| 12. Model Type | Azure OpenAI |
| 13. (Azure OpenAI) Quota Request Type | Global Standard |
| 14. (Azure OpenAI) Global Standard Model | gpt-5.6-sol |
| 15. Global Standard Region | Sua região compatível selecionada na etapa 2. |
| 16. Global Standard Quota | 300 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.
- Conectar: Faça login, crie ou recupere o registro de aplicativo, valide seu direito e selecione a assinatura.
- 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.
- OpenClaw: Instale o runtime e os serviços RapidClaw verificados e de versão estendida-estável.
- Agentes: Instale agentes, habilidades, agendas, políticas e a extensão de produto.
- Teams: Publique o pacote do Teams específico do tenant e verifique sua conexão.
- Command Center: Verifique a saúde do runtime e abra a experiência do administrador.
O que é implantado
| Configuração | Implantação atual |
|---|---|
| Máquina virtual | Standard_D2as_v6 |
| Sistema operacional | Ubuntu 24.04 LTS Gen2 |
| OpenClaw | Última versão estendida-estável verificada do RapidClaw |
| Banco de dados de runtime | Banco de Dados para PostgreSQL Flexible Server do Azure de propriedade do cliente |
| Segredos | Armazenamento protegido com suporte ao Azure Key Vault |
| Plano de SI | Implantaçõ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>."
- Verifique se o Microsoft.Compute está Registered na assinatura selecionada no Setup. Um provedor não registrado pode causar essa mensagem.
- 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.
- 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.