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:
2026-03-06 00:55:20 +00:00
parent 1a649fdcb2
commit df714c44dd
6 changed files with 9 additions and 29 deletions
+2 -5
View File
@@ -47,8 +47,7 @@ shell/bus/ → comunicación inter-agente via Go channels
shell/protocols/ → adaptadores MCP (mcp.go) shell/protocols/ → adaptadores MCP (mcp.go)
agents/runtime.go → Agent{}: ensambla core + shell, maneja eventos agents/runtime.go → Agent{}: ensambla core + shell, maneja eventos
agents/assistant/ → reglas puras + config del assistant-bot agents/assistant-bot/ → reglas puras + config del assistant-bot
agents/devops/ → reglas puras + config del devops-bot
internal/config/schema.go → tipos completos del YAML de configuración internal/config/schema.go → tipos completos del YAML de configuración
internal/config/loader.go → Load() con expand env vars, LoadMeta() sin validació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 | | assistant-bot | activo | GPT-4o | Asistente general, responde DMs |
| asistente-2 | activo | GPT-4o | Asistente con tools (current_time) | | asistente-2 | activo | GPT-4o | Asistente con tools (current_time) |
| devops-bot | pendiente | Claude | SSH, deployments, healthchecks |
## Dependencias clave ## Dependencias clave
@@ -153,7 +151,6 @@ MATRIX_ADMIN_TOKEN # token admin para registrar bots (cmd/register)
MATRIX_TOKEN_<BOT> # access token de cada bot MATRIX_TOKEN_<BOT> # access token de cada bot
OPENAI_API_KEY # OpenAI OPENAI_API_KEY # OpenAI
ANTHROPIC_API_KEY # Anthropic/Claude ANTHROPIC_API_KEY # Anthropic/Claude
SSH_PRIVATE_KEY_PATH # clave SSH para el devops-bot
``` ```
Nunca commitear `.env`. Plantilla en `.env.example`. 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 - Conversation history: mantener `[]Message` por room en memoria/SQLite
- RBAC real: conectar `SecurityCfg.Roles` al listener - RBAC real: conectar `SecurityCfg.Roles` al listener
- E2EE: habilitar `encryption.enabled: true` con crypto store de mautrix - 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 - A2A: agent card HTTP endpoint para comunicación con agentes externos
+1 -4
View File
@@ -18,7 +18,6 @@ normales: sin token, sin listener propio, sin `user_id`.
``` ```
agents/ agents/
assistant/ → bot normal (Matrix user, token, listener) assistant/ → bot normal (Matrix user, token, listener)
devops/ → bot normal
specials/ → componentes de sistema, sin identidad Matrix specials/ → componentes de sistema, sin identidad Matrix
orchestrator/ → middleware de coordinación multi-bot orchestrator/ → middleware de coordinación multi-bot
scheduler/ → (futuro) cron runner scheduler/ → (futuro) cron runner
@@ -67,7 +66,6 @@ orchestration:
- room_id: "${MATRIX_ROOM_SHARED}" - room_id: "${MATRIX_ROOM_SHARED}"
participants: # bots que participan en esta sala participants: # bots que participan en esta sala
- id: assistant-bot - id: assistant-bot
- id: devops-bot
``` ```
--- ---
@@ -147,7 +145,6 @@ type QualityScore struct {
System (prompts/routing.md): System (prompts/routing.md):
Eres un coordinador de agentes. Disponibles: Eres un coordinador de agentes. Disponibles:
- assistant-bot: Asistente general, preguntas, resúmenes, redacción - assistant-bot: Asistente general, preguntas, resúmenes, redacción
- devops-bot: SSH, deployments, infraestructura
Responde SOLO con el ID del bot más adecuado. Responde SOLO con el ID del bot más adecuado.
User: [pregunta del humano] User: [pregunta del humano]
@@ -275,4 +272,4 @@ shell/bus/bus.go → soporte para TaskEvent routing
### Fase 4 — Observabilidad ### Fase 4 — Observabilidad
- Topic del room refleja estado del pipeline en curso - 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
+1 -1
View File
@@ -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** commitear tokens ni passwords — solo van en `.env`
- **No** compartir crypto stores entre agentes — cada uno tiene su `store_path` - **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 - 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
+1 -13
View File
@@ -84,8 +84,7 @@ agents_and_robots/
├── agents/ ← definición de cada bot ├── agents/ ← definición de cada bot
│ ├── runtime.go Agent{}: ensambla core + shell │ ├── runtime.go Agent{}: ensambla core + shell
── assistant/ reglas + config del assistant-bot ── assistant/ reglas + config del assistant-bot
│ └── devops/ reglas + config del devops-bot
├── internal/config/ esquema YAML completo + loader con env vars ├── 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 @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 ## Dependencias
+1 -2
View File
@@ -135,7 +135,7 @@ System prompt que recibe el LLM. Debe incluir:
- Estilo de respuesta - Estilo de respuesta
- Limitaciones - 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 ## 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{ var rulesRegistry = map[string]func() []decision.Rule{
"assistant-bot": assistantagent.Rules, "assistant-bot": assistantagent.Rules,
"mi-bot": mibotAgent.Rules, // ← nuevo "mi-bot": mibotAgent.Rules, // ← nuevo
"devops-bot": devopsagent.Rules,
} }
``` ```
+3 -4
View File
@@ -41,7 +41,7 @@ Y se referencia en `config.yaml`:
```yaml ```yaml
encryption: encryption:
enabled: true enabled: true
store_path: "./agents/assistant/data/crypto/" store_path: "./agents/assistant-bot/data/crypto/"
pickle_key: "${PICKLE_KEY_ASSISTANT_BOT}" pickle_key: "${PICKLE_KEY_ASSISTANT_BOT}"
trust_mode: tofu 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: Cada agente debe tener su propia crypto.db para evitar corrupción cruzada:
``` ```
agents/assistant/data/crypto/crypto.db agents/assistant-bot/data/crypto/crypto.db
agents/asistente2/data/crypto/crypto.db agents/asistente-2/data/crypto/crypto.db
agents/devops/data/crypto/crypto.db
``` ```
**No compartir** la crypto store entre agentes. **No compartir** la crypto store entre agentes.