35 lines
2.1 KiB
Markdown
35 lines
2.1 KiB
Markdown
# 🤖 Antigravity VPS Agent - Central de Controle
|
|
|
|
Este é um Agente de IA avançado para gerenciamento de VPS, projetado para operar tanto via **Telegram** quanto por uma **Interface Web Customizada**. O agente possui acesso root e pode executar comandos shell, ler arquivos e gerenciar o Coolify/Docker.
|
|
|
|
## 🏗️ Arquitetura Atual (Handover Context)
|
|
|
|
### 1. Loop ReAct (`ai_agent.py`)
|
|
O "cérebro" do bot usa um loop de raciocínio (Thinking -> Action -> Observation).
|
|
- **IA**: Gemini 2.5 Flash (API Key do Marcos).
|
|
- **Attempts**: Até 10 tentativas por tarefa para resolver problemas complexos sem desistir.
|
|
- **Output**: Separa Logs Técnicos (Terminal) de Resumos Visuais (Painel de Insights) usando as tags `<REFINED>`.
|
|
|
|
### 2. Interface Web (`templates/index.html`)
|
|
- Painel de 2 colunas: Chat Técnico (esquerda) e Insights Visuais (direita).
|
|
- **Recurso de Áudio**: Implementamos gravação nativa (Web Audio API) com transcrição no backend (STT).
|
|
- **Padrão de Resposta**: Se o usuário fala por áudio, o bot sintetiza (TTS via gTTS) e responde por áudio também (Audio-to-Audio).
|
|
|
|
### 3. Integração com Infraestrutura
|
|
- **Docker**: O bot roda em container (`vps-ai-agent`) com acesso ao `docker.sock` em modo `rw`.
|
|
- **Gitea**: Repositório de código fonte em `https://git.reifonas.cloud/admtracksteel/BotVPS.git`.
|
|
- **Coolify**: Gerencia aplicações. Os domínios foram recentemente migrados de `reifonas.cloud` para `tracksteel.com.br` (ex: `tscut.tracksteel.com.br`).
|
|
|
|
### 4. Ferramentas (Tools)
|
|
- `run_bash_command`: Execução de comandos shell.
|
|
- `get_system_health`: CPU, RAM, Disco.
|
|
- `get_docker_stats`: Uso de recursos por container (Especializado para evitar erro de chaves).
|
|
- `read_vps_file`: Leitura de arquivos de log/config.
|
|
|
|
## 🚀 Como Executar
|
|
Use o script `./start.sh`, que inicia o servidor FastAPI (port 8000) com `--reload` e o processo do Telegram em background.
|
|
|
|
---
|
|
**Recado para a Próxima Instância do Antigravity:**
|
|
> Marcos utiliza este bot para controle total da VPS. Sempre verifique o `.env` e o `data/config.json` para as credenciais. Mantenha o padrão de resposta visual no painel de insights para facilitar a leitura.
|