docs: update references after agent directory rename and devops removal
Actualizar todas las referencias en documentación para reflejar los nuevos nombres de directorio (assistant-bot, asistente-2) y la eliminación del agente devops-bot. Archivos actualizados: CLAUDE.md, create_agent.md, README.md, e2ee.md, creating-agents.md, 03-bot-interaction.md. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
+2
-5
@@ -47,8 +47,7 @@ shell/bus/ → comunicación inter-agente via Go channels
|
||||
shell/protocols/ → adaptadores MCP (mcp.go)
|
||||
|
||||
agents/runtime.go → Agent{}: ensambla core + shell, maneja eventos
|
||||
agents/assistant/ → reglas puras + config del assistant-bot
|
||||
agents/devops/ → reglas puras + config del devops-bot
|
||||
agents/assistant-bot/ → reglas puras + config del assistant-bot
|
||||
|
||||
internal/config/schema.go → tipos completos del YAML de configuración
|
||||
internal/config/loader.go → Load() con expand env vars, LoadMeta() sin validación
|
||||
@@ -76,7 +75,6 @@ Documentación detallada para humanos en `docs/creating-agents.md`.
|
||||
|----------------|-----------|---------|------------------------------------------|
|
||||
| assistant-bot | activo | GPT-4o | Asistente general, responde DMs |
|
||||
| asistente-2 | activo | GPT-4o | Asistente con tools (current_time) |
|
||||
| devops-bot | pendiente | Claude | SSH, deployments, healthchecks |
|
||||
|
||||
## Dependencias clave
|
||||
|
||||
@@ -153,7 +151,6 @@ MATRIX_ADMIN_TOKEN # token admin para registrar bots (cmd/register)
|
||||
MATRIX_TOKEN_<BOT> # access token de cada bot
|
||||
OPENAI_API_KEY # OpenAI
|
||||
ANTHROPIC_API_KEY # Anthropic/Claude
|
||||
SSH_PRIVATE_KEY_PATH # clave SSH para el devops-bot
|
||||
```
|
||||
|
||||
Nunca commitear `.env`. Plantilla en `.env.example`.
|
||||
@@ -172,5 +169,5 @@ Nunca commitear `.env`. Plantilla en `.env.example`.
|
||||
- Conversation history: mantener `[]Message` por room en memoria/SQLite
|
||||
- RBAC real: conectar `SecurityCfg.Roles` al listener
|
||||
- E2EE: habilitar `encryption.enabled: true` con crypto store de mautrix
|
||||
- MCP: exponer tools del devops-bot como MCP server en el puerto configurado
|
||||
- MCP: exponer tools de los agentes como MCP server en el puerto configurado
|
||||
- A2A: agent card HTTP endpoint para comunicación con agentes externos
|
||||
|
||||
@@ -18,7 +18,6 @@ normales: sin token, sin listener propio, sin `user_id`.
|
||||
```
|
||||
agents/
|
||||
assistant/ → bot normal (Matrix user, token, listener)
|
||||
devops/ → bot normal
|
||||
specials/ → componentes de sistema, sin identidad Matrix
|
||||
orchestrator/ → middleware de coordinación multi-bot
|
||||
scheduler/ → (futuro) cron runner
|
||||
@@ -67,7 +66,6 @@ orchestration:
|
||||
- room_id: "${MATRIX_ROOM_SHARED}"
|
||||
participants: # bots que participan en esta sala
|
||||
- id: assistant-bot
|
||||
- id: devops-bot
|
||||
```
|
||||
|
||||
---
|
||||
@@ -147,7 +145,6 @@ type QualityScore struct {
|
||||
System (prompts/routing.md):
|
||||
Eres un coordinador de agentes. Disponibles:
|
||||
- assistant-bot: Asistente general, preguntas, resúmenes, redacción
|
||||
- devops-bot: SSH, deployments, infraestructura
|
||||
Responde SOLO con el ID del bot más adecuado.
|
||||
|
||||
User: [pregunta del humano]
|
||||
@@ -275,4 +272,4 @@ shell/bus/bus.go → soporte para TaskEvent routing
|
||||
|
||||
### Fase 4 — Observabilidad
|
||||
- Topic del room refleja estado del pipeline en curso
|
||||
- `"[2/3] devops-bot respondió · evaluando..."` → topic actualizado en tiempo real
|
||||
- `"[2/3] bot respondió · evaluando..."` → topic actualizado en tiempo real
|
||||
|
||||
@@ -229,4 +229,4 @@ Luego seguir con registro, verificación y arranque usando los dev-scripts.
|
||||
- **No** commitear tokens ni passwords — solo van en `.env`
|
||||
- **No** compartir crypto stores entre agentes — cada uno tiene su `store_path`
|
||||
- Si el agente usa tool_use, asegurarse de que `llm.tool_use.enabled: true` en el config
|
||||
- Usar `agents/asistente2/` como referencia completa de un agente con tools habilitadas
|
||||
- Usar `agents/asistente-2/` como referencia completa de un agente con tools habilitadas
|
||||
|
||||
@@ -84,8 +84,7 @@ agents_and_robots/
|
||||
│
|
||||
├── agents/ ← definición de cada bot
|
||||
│ ├── runtime.go Agent{}: ensambla core + shell
|
||||
│ ├── assistant/ reglas + config del assistant-bot
|
||||
│ └── devops/ reglas + config del devops-bot
|
||||
│ └── assistant/ reglas + config del assistant-bot
|
||||
│
|
||||
├── internal/config/ esquema YAML completo + loader con env vars
|
||||
│
|
||||
@@ -272,17 +271,6 @@ Asistente general con GPT-4o. Responde a DMs y menciones. Sin acceso a herramien
|
||||
@assistant-bot:matrix-af2f3d.organic-machine.com
|
||||
```
|
||||
|
||||
### devops-bot
|
||||
|
||||
Bot de infraestructura. Ejecuta comandos SSH en targets configurados. Requiere `ANTHROPIC_API_KEY`.
|
||||
|
||||
Comandos Matrix:
|
||||
- `!help` — lista de comandos
|
||||
- `!healthcheck` — health check de producción
|
||||
- `!status` — estado de servicios
|
||||
- `!deploy staging` / `!deploy production` (requiere power level ≥ 50)
|
||||
- `!logs` — últimas líneas de journalctl
|
||||
|
||||
---
|
||||
|
||||
## Dependencias
|
||||
|
||||
@@ -135,7 +135,7 @@ System prompt que recibe el LLM. Debe incluir:
|
||||
- Estilo de respuesta
|
||||
- Limitaciones
|
||||
|
||||
Usar como referencia: `agents/assistant/prompts/assistant-system.md` o `agents/asistente2/prompts/system.md`.
|
||||
Usar como referencia: `agents/assistant-bot/prompts/assistant-system.md` o `agents/asistente-2/prompts/system.md`.
|
||||
|
||||
## Paso 2: Registrar el agente en el launcher
|
||||
|
||||
@@ -151,7 +151,6 @@ mibotAgent "github.com/enmanuel/agents/agents/mibot"
|
||||
var rulesRegistry = map[string]func() []decision.Rule{
|
||||
"assistant-bot": assistantagent.Rules,
|
||||
"mi-bot": mibotAgent.Rules, // ← nuevo
|
||||
"devops-bot": devopsagent.Rules,
|
||||
}
|
||||
```
|
||||
|
||||
|
||||
+3
-4
@@ -41,7 +41,7 @@ Y se referencia en `config.yaml`:
|
||||
```yaml
|
||||
encryption:
|
||||
enabled: true
|
||||
store_path: "./agents/assistant/data/crypto/"
|
||||
store_path: "./agents/assistant-bot/data/crypto/"
|
||||
pickle_key: "${PICKLE_KEY_ASSISTANT_BOT}"
|
||||
trust_mode: tofu
|
||||
```
|
||||
@@ -67,9 +67,8 @@ Un pickle key fijo por agente en `.env` evita este problema.
|
||||
Cada agente debe tener su propia crypto.db para evitar corrupción cruzada:
|
||||
|
||||
```
|
||||
agents/assistant/data/crypto/crypto.db
|
||||
agents/asistente2/data/crypto/crypto.db
|
||||
agents/devops/data/crypto/crypto.db
|
||||
agents/assistant-bot/data/crypto/crypto.db
|
||||
agents/asistente-2/data/crypto/crypto.db
|
||||
```
|
||||
|
||||
**No compartir** la crypto store entre agentes.
|
||||
|
||||
Reference in New Issue
Block a user