Skip to main content
El workspace es el contrato principal del proyecto. Define identidad, modelo, tools, knowledge, sub-agentes, teams y canales.

​
Convencion recomendada

Para el uso mas estable del proyecto, mantén el workspace en: 
OPENAGNO_ROOT/workspace
Hay una diferencia importante:
  • loader.py y management.validator aceptan AGNOBOT_WORKSPACE.
  • La CLI empaquetada y WorkspaceTools operan sobre OPENAGNO_ROOT/workspace.
Si quieres evitar inconsistencias, usa siempre la estructura estandar del repo.

​
Archivos principales

ArchivoFuncion
workspace/config.yamlConfiguracion central: modelo, base de datos, canales, memoria, audio
workspace/instructions.mdPersonalidad, reglas y capacidades del agente
workspace/tools.yamlHerramientas habilitadas (builtin y opcionales)
workspace/mcp.yamlServidores MCP externos
workspace/self_knowledge.mdAuto-consciencia: proveedores, tools y canales validos
workspace/knowledge/docs/Documentos para RAG
workspace/knowledge/urls.yamlURLs para auto-ingesta
workspace/agents/*.yamlDefiniciones de sub-agentes
workspace/agents/teams.yamlEquipos multi-agente y modos de coordinacion
workspace/schedules.yamlTareas cron programadas
workspace/integrations/Integraciones declarativas con env propio

​
Que archivos se leen al arranque

  • config.yaml
  • instructions.md
  • tools.yaml
  • mcp.yaml
  • self_knowledge.md si existe
  • knowledge/docs/*
  • knowledge/urls.yaml
  • agents/*.yaml
  • agents/teams.yaml
  • schedules.yaml
  • integraciones habilitadas en workspace/integrations/*

​
Que archivos suele mutar el sistema

  • workspace/agents/*.yaml cuando creas sub-agentes con tools de workspace o con openagno create agent
  • workspace/tools.yaml y workspace/config.yaml cuando usas openagno add ...
  • .reload_requested en la raiz del proyecto cuando un agente solicita reload
  • backups/ cuando WorkspaceTools guarda respaldos

​
Siguientes lecturas