Pré-requisitos e Implementação Assistida
Conclua estes passos antes de implementar qualquer produto RapidClaw. Utilize uma subscrição Azure dedicada de propriedade do cliente.
1. Crie uma subscrição Azure dedicada
- Abra as Subscrições Azure e crie uma subscrição dedicada, de propriedade do cliente, apenas para RapidClaw. Atribua um nome claro, como RapidClaw Produção ou RapidClaw Piloto.
- Confirme que a subscrição está ativa e que pode criar recursos Azure e um registo de aplicação. Peça ajuda ao administrador de Azure se necessário.
- A pessoa que executa Setup torna-se o primeiro administrador de Command Center.
- Defina um alerta de orçamento para a subscrição. Tenha preparado um orçamento mensal e um e-mail de notificação para Setup. Os alertas avisam-no; não impedem o consumo.
2. Escolha uma região suportada
- Australia East
- East US 2
- South India
- Sweden Central
- West US 3
Use sempre a mesma subscrição e região para as verificações e pedidos abaixo. Setup verifica a disponibilidade em tempo real da VM, rede, modelos e embeddings antes da implementação.
3. Registe os fornecedores de recursos
Registe primeiro o Microsoft.Compute para que o Setup possa ler a quota da VM. O registo exige permissão ao nível da subscrição /register/action, incluída em Contributor e Owner. Continuará a precisar das permissões de implementação do passo 1.
Portal Azure: Abra a sua subscrição > Definições > Fornecedores de recursos. Registe os fornecedores em falta da tabela abaixo; ignore os já registados.
| Fornecedor | Utilização |
|---|---|
| Microsoft.Compute | Verificações de máquina virtual e quota de VM |
| Microsoft.Network | Rede virtual, IP público e grupo de segurança de rede |
| Microsoft.KeyVault | Segredos de tempo de execução |
| Microsoft.Storage | Armazenamento para implementação e diagnósticos |
| Microsoft.DBforPostgreSQL | Base de dados PostgreSQL Flexible Server |
| Microsoft.CognitiveServices | Modelos Microsoft Foundry / Azure OpenAI |
| Microsoft.Insights | Monitorização e alertas |
| Microsoft.Consumption | Alertas de custos |
| Microsoft.Authorization | Atribuições de funções de identidade em tempo de execução; registado por defeito |
| Microsoft.AlertsManagement | Gestão de alertas |
Alternativa CLI: No Cloud Shell de Azure ou numa sessão CLI de Azure autenticada, substitua <subscription-id> pelo ID da sua subscrição 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 restantes fornecedores em falta, substituindo Microsoft.Compute por cada namespace. Aguarde por Registered antes de continuar. O registo ativa um serviço; não cria recursos em tempo de execução nem garante quota. Pode adicionar uma aplicação gerida por Microsoft ao seu inquilino. Orientação de registo da Microsoft.
4. Verificar a quota da família VM
RapidClaw utiliza uma VM Standard_D2as_v6. A sua região deve ter pelo menos 2 vCPUs disponíveis tanto em Standard DASv6 Family vCPUs como em Total Regional vCPUs.
- Abra a sua subscrição Azure > Utilização + quotas.
- Filtre por Compute e pela região escolhida.
- Para ambas as entradas de quota, confirme que limite - utilização atual seja pelo menos 2.
- Se não tiver quota suficiente, solicite um aumento ou verifique outra região suportada.
Entradas de quota em falta? Verifique o registo de Microsoft.Compute, os filtros de subscrição e região, e os seus acessos. Ter quota suficiente não garante a capacidade da VM. Orientação de quota vCPU da Microsoft.
5. Solicitar quota de Microsoft Foundry
Não é necessário criar um projeto Foundry ou recurso Azure AI antecipadamente; RapidClaw irá criá-los durante a implementação. A quota de modelo é separada da quota de VM.
Solicite a quota antes da data de implementação
A aprovação pode demorar vários dias e não é garantida. Microsoft dá prioridade a clientes que utilizam já a sua alocação existente. Prossiga apenas quando Setup confirmar que todos os pré-requisitos estão cumpridos.
Abrir formulário de pedido de quota da Microsoft.
- Campos 1-8: insira o seu nome, e-mail profissional, nome da empresa e morada.
- Campo 9 (Subscription Id): introduza o ID da subscrição dedicada RapidClaw, não o ID do seu inquilino.
- Campo 10 (Justification): adapte o texto sugerido abaixo à sua implementação e uso esperado.
- Campos 11-16: utilize a tabela abaixo. Se a Microsoft alterar a numeração, associe sempre aos nomes dos campos.
Seleções recomendadas no formulário
| Campo do formulário da Microsoft | Valor a inserir |
|---|---|
| 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 | A sua região suportada do passo 2. |
| 16. Global Standard Quota | 300 kTPM (300 000 tokens por minuto). Indique a quota total necessária, não o valor adicional. |
Justificação sugerida
Estamos a implementar RapidClaw na nossa subscrição Azure para executar agentes de SI em fluxos de trabalho empresariais, tarefas agendadas e Microsoft Teams/email, com aprovações e controlos de auditoria. Solicitamos quota de 300 kTPM de Global Standard para gpt-5.6-sol na região Azure suportada escolhida. Iremos monitorizar a utilização e configurar um alerta mensal de custos.
Se Setup indicar falta de quota de embeddings, submeta um pedido separado para text-embedding-3-small: 10 kTPM na mesma subscrição e região, usando o tipo de implementação exigido pelo Setup. Para qualquer um dos pedidos, inclua quota já atribuída a outros workloads para garantir que sobra o suficiente para RapidClaw.
Submeta o pedido e aguarde pela resposta da Microsoft. Se lhe for sugerida outra região ou modelo, confirme que RapidClaw o suporta antes de aceitar. Após a aprovação, volte a executar a verificação de pré-requisitos do Setup na mesma subscrição e região.
A quota é um limite de taxa, não um pré-carregamento de utilização nem um teto de gasto. Azure cobra pelos tokens usados. Orientação de quota da Microsoft.
6. Execute o Setup
Assim que todos os pré-requisitos forem validados, a implementação demora normalmente cerca de 20 minutos. Setup é executado no servidor e pode recuperar o progresso se atualizar a página ou iniciar sessão novamente.
- Ligar: Inicie sessão, crie ou recupere o registo da aplicação, valide o seu direito de uso e selecione a subscrição.
- Implementar: Selecione a região, passe nas verificações dos pré-requisitos, defina o orçamento e o e-mail de alerta, e aprovisione os recursos Azure.
- OpenClaw: Instale o runtime estendido e estável validado e os serviços RapidClaw.
- Agentes: Instale agentes, competências, agendamentos, políticas e a extensão do seu produto.
- Teams: Publique o pacote Teams específico do inquilino e verifique a sua ligação.
- Command Center: Verifique a saúde do runtime e aceda à experiência de administrador.
O que é implementado
| Definição | Implementação atual |
|---|---|
| Máquina virtual | Standard_D2as_v6 |
| Sistema operativo | Ubuntu 24.04 LTS Gen2 |
| OpenClaw | Última versão estável e verificada de RapidClaw |
| Base de dados de runtime | Base de dados Azure de propriedade do cliente para PostgreSQL Flexible Server |
| Segredos | Armazenamento protegido baseado em Azure Key Vault |
| Plano de SI | Implementações diretas de modelos Microsoft Foundry / Azure AI validadas, além de text-embedding-3-small |
Após a implementação
- Verifique tempo de execução, modelos, conectores, Teams, subscrição, memória, utilização e estado de saúde em Command Center.
- Reveja agentes, competências, políticas e Pacotes de Agente específicos do produto. Deixe agendamentos desativados até compreender o seu âmbito, ferramentas, entrega e autorizações.
- Monitore o consumo com alertas de custos Azure e Usage & Costs de Command Center.
Resolver problemas no passo de Implementação
Mensagem de quota da família VM
"Standard_D2as_v6 não está disponível com quota familiar de cores suficiente em <região>."
- Verifique se o Microsoft.Compute está Registered na subscrição selecionada em Setup. Um fornecedor não registado pode causar esta mensagem.
- Confirme que as quotas da família de VM e regionais têm pelo menos 2 vCPUs disponíveis. Solicite um aumento se necessário.
- Se ambas as quotas forem suficientes, verifique a disponibilidade do tamanho de VM e o erro detalhado de Azure.
Microsoft.Compute não está registado
Registe o Microsoft.Compute na subscrição apresentada pelo Setup, aguarde por Registered e tente novamente. Em seguida, resolva quaisquer erros separados de quota ou capacidade.
O tamanho da VM não está disponível na região
Escolha outra região suportada onde as VMs, quota, modelos e embeddings estejam disponíveis. Para manter a sua região original, siga a orientação da Microsoft sobre disponibilidade de SKU. Apenas aumentar a quota não resolve a indisponibilidade de capacidade de VM.