Um habitat confiável para seus agentes.

Separe o worker das decisões

Um agente pode planejar uma tarefa enquanto uma fila controla quando um worker a executa. Isso torna as novas tentativas visíveis e evita que uma breve falha de API se transforme em uma ação duplicada. Atribua um identificador a cada job e registre as transições de estado que importam.

Trate as ferramentas como privilégios

Um processo que pode enviar e-mail, gastar dinheiro ou escrever em produção precisa de credenciais mais restritas do que um trabalhador de investigação. Utilize contas de serviço separadas, permissões por ferramenta e passos de aprovação explícitos para ações com consequências. Nunca coloque chaves privadas em prompts ou em ficheiros acessíveis pelo navegador.

• Mantenha segredos fora da raiz web e do controle de versão
• Use limites de gastos e de solicitações para APIs externos
• Mantenha um registro auditável sem armazenar dados pessoais desnecessários

Conceba para um processo parado

Use um gestor de serviços ou runtime de contentores, verificações de estado e uma política de reinício limitada. Um agente deve retomar a partir do estado guardado em vez de repetir cegamente a última ação externa. Monitorize o crescimento do disco, a idade da fila e as taxas de erro, não apenas se o processo existe.

Dimensionar a máquina corretamente

Um worker que chama um modelo remoto precisa frequentemente de CPU modesto e de memória suficiente para as suas ferramentas. A automatização de navegador pode usar consideravelmente mais RAM. A inferência de modelos locais tem requisitos separados de memória e acelerador; um VPS geral não implica uma GPU associada.

Design do fluxo de aprovisionamento

Um fluxo de trabalho de integração de agentes pode consultar planos públicos, registar uma conta e preparar um pedido de serviço dentro de um limite de despesa explícito. O pagamento e a criação do servidor exigem a autorização adequada. Deve receber um identificador de operação, aguardar pelo estado concluído e, em seguida, gerir o servidor com a sua própria chave pública SSH. A eliminação deve ser intencional e preservar os resultados necessários.

Eventos em vez de consultas impacientes

Webhooks assinados podem relatar a liquidação de pagamentos e mudanças no ciclo de vida. Verifique sua autenticidade, deduplique as entregas e reconcilie com o API antes de tomar a próxima ação. O provedor não deve receber a chave SSH privada do agente, a semente da carteira ou credenciais de modelo irrestritas.

Transforme uma tarefa em uma operação durável

Dê a cada tarefa um identificador estável e estados explícitos, como na fila, em execução, aguardando aprovação, concluída ou falhou. Salve o resultado de uma ação externa antes de confirmá-la ao planejador. Um trabalhador reiniciado deve inspecionar o estado persistido em vez de repetir um pagamento, uma mensagem ou uma gravação em produção porque sua saída de terminal foi perdida.

Ferramentas de provisionamento e workers hospedados são produtos separados

Um VPS pode executar o agente de um cliente continuamente utilizando o seu próprio gestor de serviços e credenciais. Um API ou endpoint MCP do plano de controlo de alojamento é uma integração diferente. O primeiro pode ser implementado como uma aplicação; o segundo requer uma integração KoalaVPS do plano de controlo lançada separadamente e não é ligado por esta documentação.

Orçamente o trabalhador completo

Reserve memória para o navegador, o cliente do modelo, a fila e a base de dados em conjunto. Um pequeno worker orientado por API pode precisar de CPU modesto, enquanto sessões de navegador concorrentes esgotam rapidamente RAM. Defina a concorrência da fila e os limites de gastos externos de API antes de aumentar o tamanho da máquina. Nenhuma subscrição de modelo, acelerador ou limite de API de terceiros está incluído por implicação.

Uma transferência operacional útil

Registre o comando de inicialização, o diretório de trabalho, o local do ambiente protegido, a política de reinício, o armazenamento da fila, a verificação de integridade e o responsável por cada credencial externa. Inclua a ação que interrompe com segurança novas tarefas e o caminho para retomar as inacabadas. O monitoramento deve identificar trabalho atrasado ou duplicado, bem como um processo que parou.

Um pouco mais de clareza.