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)
|
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
|
||||||
|
|||||||
@@ -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
|
||||||
|
|||||||
@@ -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
|
||||||
|
|||||||
@@ -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
|
||||||
|
|||||||
@@ -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
@@ -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.
|
||||||
|
|||||||
Reference in New Issue
Block a user