Saltar para o conteúdo principal
RapidClaw

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.

FornecedorUtilização
Microsoft.ComputeVerificações de máquina virtual e quota de VM
Microsoft.NetworkRede virtual, IP público e grupo de segurança de rede
Microsoft.KeyVaultSegredos de tempo de execução
Microsoft.StorageArmazenamento para implementação e diagnósticos
Microsoft.DBforPostgreSQLBase de dados PostgreSQL Flexible Server
Microsoft.CognitiveServicesModelos Microsoft Foundry / Azure OpenAI
Microsoft.InsightsMonitorização e alertas
Microsoft.ConsumptionAlertas de custos
Microsoft.AuthorizationAtribuições de funções de identidade em tempo de execução; registado por defeito
Microsoft.AlertsManagementGestã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.

  1. Abra a sua subscrição Azure > Utilização + quotas.
  2. Filtre por Compute e pela região escolhida.
  3. Para ambas as entradas de quota, confirme que limite - utilização atual seja pelo menos 2.
  4. 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.

  1. Campos 1-8: insira o seu nome, e-mail profissional, nome da empresa e morada.
  2. Campo 9 (Subscription Id): introduza o ID da subscrição dedicada RapidClaw, não o ID do seu inquilino.
  3. Campo 10 (Justification): adapte o texto sugerido abaixo à sua implementação e uso esperado.
  4. 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 MicrosoftValor a inserir
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 RegionA sua região suportada do passo 2.
16. Global Standard Quota300 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.

  1. Ligar: Inicie sessão, crie ou recupere o registo da aplicação, valide o seu direito de uso e selecione a subscrição.
  2. 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.
  3. OpenClaw: Instale o runtime estendido e estável validado e os serviços RapidClaw.
  4. Agentes: Instale agentes, competências, agendamentos, políticas e a extensão do seu produto.
  5. Teams: Publique o pacote Teams específico do inquilino e verifique a sua ligação.
  6. Command Center: Verifique a saúde do runtime e aceda à experiência de administrador.

O que é implementado

DefiniçãoImplementação atual
Máquina virtualStandard_D2as_v6
Sistema operativoUbuntu 24.04 LTS Gen2
OpenClawÚltima versão estável e verificada de RapidClaw
Base de dados de runtimeBase de dados Azure de propriedade do cliente para PostgreSQL Flexible Server
SegredosArmazenamento protegido baseado em Azure Key Vault
Plano de SIImplementaçõ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>."

  1. Verifique se o Microsoft.Compute está Registered na subscrição selecionada em Setup. Um fornecedor não registado pode causar esta mensagem.
  2. 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.
  3. 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.