dataforge/agents_and_robots
1
0
Fork 0
Code Issues Pull Requests 2 Actions Packages Projects Releases Wiki Activity
Files
e743a3e982be8c88ec05d8878fe540ccd28bd900
agents_and_robots/agents/_template/config.yaml
T
egutierrez e743a3e982 feat: sistema de personalidades enriquecido + agente template 
Fase 1: Sistema de personalidades enriquecido
- Ampliar PersonalityCfg con role, backstory, expertise, limitations
- Añadir CommunicationCfg (formality, humor, personality, response_style, quirks, catchphrases)
- Crear tipos puros en pkg/personality/traits.go
- Implementar BuildPersonalityPrompt() para generar bloque de system prompt
- Integrar personalidad en agents/runtime.go (FromConfig + concatenacion al system prompt)

Fase 2: Agente plantilla
- Añadir campo Template bool a AgentMeta
- Filtrar agentes template en launcher (skip si template: true)
- Crear agents/_template/ con config.yaml completo y documentado
- Incluir TODAS las secciones (skills, shared_knowledge, schedules, security)
- agent.go minimo + prompts/system.md plantilla
- Actualizar dev-scripts/agent/new-agent.sh para copiar desde _template/

Fase 3: Ejemplos de personalidades
- Crear agents/_template/PERSONALITIES.md con 4 perfiles:
  * DevOps pragmatico
  * Analista meticuloso
  * Asistente amigable
  * Guardian de seguridad

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2026-03-08 22:28:40 +00:00

414 lines
12 KiB
YAML
Raw Blame History

# ============================================
# AGENTE PLANTILLA
# ============================================
# Este archivo sirve como referencia canonica para la configuracion de todos los agentes.
# NO se lanza (template: true). Copiar y adaptar para crear nuevos agentes.
agent:
id: "_template"
name: "Template Agent"
version: "0.0.0"
enabled: true
template: true # el launcher ignora este agente
description: "Agente plantilla. No se lanza. Sirve como referencia para crear nuevos agentes."
tags: [template]
# ============================================
# PERSONALIDAD Y COMPORTAMIENTO
# ============================================
personality:
# --- Identidad narrativa ---
role: "asistente general"
backstory: "Un asistente amigable creado para ayudar con tareas cotidianas."
expertise: [general]
limitations: []
# --- Estilo basico ---
tone: friendly # direct | friendly | formal | casual | technical
verbosity: concise # minimal | concise | detailed | verbose
language: es
languages_supported: [es, en]
emoji_style: minimal # none | minimal | moderate | heavy
prefix: ""
error_style: helpful # terse | helpful | detailed
# --- Comunicacion avanzada ---
communication:
formality: semiformal # formal | semiformal | casual | coloquial
humor: none # none | subtle | moderate | frequent
personality: pragmatic # analytical | creative | pragmatic | empathetic | assertive
response_style: structured # structured | conversational | bullet_points | narrative
quirks: [] # rasgos unicos del personaje
avoid_topics: [] # temas a evitar
catchphrases: [] # frases tipicas
# --- Directivas libres ---
custom_directives: [] # instrucciones extra para el system prompt
# --- Templates de respuesta ---
templates:
greeting: "Hola, soy {name}. En que puedo ayudarte?"
unknown_command: "No entiendo ese comando. Usa !help."
permission_denied: "No tienes permiso para eso."
error: "Algo salio mal: {{.Error}}"
success: "{{.Summary}}"
busy: "Estoy procesando otra solicitud, un momento..."
# --- Comportamiento ---
behavior:
proactive: false
ask_confirmation: false
show_reasoning: false
thread_replies: true
typing_indicator: true
acknowledge_receipt: false
# ============================================
# LLM — CONEXION Y RAZONAMIENTO
# ============================================
llm:
primary:
provider: openai # openai | anthropic | claude-code
model: "gpt-4o"
api_key_env: OPENAI_API_KEY
base_url: "" # opcional: custom endpoint
max_tokens: 4096
temperature: 0.7
# Claude Code: subproceso claude -p (solo si provider: claude-code)
claude_code:
binary: "claude"
timeout: 3m
disable_tools: false
allowed_tools: [] # vacio = permitir todas
disallowed_tools: []
working_dir: "" # default: tmpdir aislado
permission_mode: "default" # default | acceptEdits | bypassPermissions | plan
model: "sonnet" # sonnet | opus | haiku | full model name
fallback_model: ""
session_id: ""
add_dirs: []
# Fallback LLM (opcional)
fallback:
provider: ""
model: ""
api_key_env: ""
base_url: ""
max_tokens: 0
temperature: 0
reasoning:
system_prompt_file: "prompts/system.md" # relativo a agents/<id>/
context_window: 16384
memory_messages: 30 # mensajes previos a incluir en el contexto
tool_use:
enabled: false # habilitar function calling
max_iterations: 5 # ciclos tool-call → execute → feedback
parallel_calls: false # permitir llamadas paralelas a tools
rate_limit:
requests_per_minute: 60
tokens_per_minute: 200000
concurrent_requests: 5
# ============================================
# TOOLS — HERRAMIENTAS DISPONIBLES
# ============================================
tools:
ssh:
enabled: false
allowed_targets: [] # lista de targets definidos en ssh.targets
allowed_commands: [] # allowlist: si no esta vacio, solo estos comandos
forbidden_commands: [] # blocklist
timeout: 30s
max_concurrent: 3
require_confirmation: [] # comandos que necesitan confirmacion
http:
enabled: false
allowed_domains: [] # si no esta vacio, solo estos dominios
timeout: 10s
max_retries: 2
scripts:
enabled: false
scripts_dir: "./scripts"
allowed: [] # si no esta vacio, solo estos scripts
timeout: 60s
sandbox: false
file_ops:
enabled: false
allowed_paths: [] # si no esta vacio, solo estos paths
read_only: true
matrix_send:
allowed_rooms: [] # si no esta vacio, solo enviar a estos rooms
mcp:
enabled: false
servers: [] # lista de servidores MCP externos
# Ejemplo:
# - name: "filesystem"
# transport: stdio
# command: "npx"
# args: ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/data"]
# env: {}
# tools: [] # filtro: solo estas tools (vacio = todas)
# prefix: "fs_" # prefijo para evitar colisiones
# timeout: 30s
expose:
port: 0 # exponer las tools propias via MCP server
tools: [] # tools a exponer (vacio = todas)
memory:
enabled: false # tool para acceder a memoria del agente
knowledge:
enabled: false
dir: "./knowledge" # knowledge privado del agente
shared_knowledge:
enabled: false
dir: "knowledges" # knowledge compartido entre agentes
db_path: "knowledges/data/knowledge.db"
skills:
allowed_interpreters: ["bash", "sh"] # interpretes permitidos para skills
# ============================================
# SKILLS — SISTEMA DE SKILLS
# ============================================
skills:
enabled: false
path: "skills/" # ruta base de skills (relativa al proyecto)
categories: [] # vacio = todas las categorias | ["devops", "system"] = filtradas
timeout: 60s # timeout para ejecucion de scripts
# ============================================
# MEMORIA — VENTANA DE CONVERSACION
# ============================================
memory:
enabled: false
window_size: 20 # mensajes por room en ventana deslizante
db_path: "" # default: agents/<id>/data/memory.db
# ============================================
# MATRIX — CONEXION Y ROOMS
# ============================================
matrix:
homeserver: "https://matrix.example.com"
user_id: "@template:matrix.example.com"
access_token_env: MATRIX_TOKEN_TEMPLATE
device_id: "DEVICEID"
encryption:
enabled: false
store_path: "./agents/_template/data/crypto/"
pickle_key_env: PICKLE_KEY_TEMPLATE
trust_mode: tofu # tofu | cross-signing | manual
recovery_key_env: "" # SSSS recovery key para cross-signing
rooms:
listen: [] # rooms donde escuchar sin responder
respond: [] # rooms donde responder automaticamente
admin: [] # rooms de admin (para comandos especiales)
filters:
command_prefix: "!"
mention_respond: true # responder a menciones
dm_respond: true # responder a DMs
ignore_bots: true
ignore_users: []
unauthorized_response: silent # silent | explicit
min_power_level: 0
threads:
enabled: true # responder en threads si el mensaje viene de un thread
auto_thread: false # crear thread automatico por cada conversacion nueva
# ============================================
# COMUNICACION INTER-AGENTES
# ============================================
agents:
peers: []
# Ejemplo:
# - id: other-agent
# capabilities: [devops, monitoring]
# room: "!roomid:server.com"
delegation:
enabled: false
can_delegate_to: []
can_receive_from: []
max_delegation_depth: 1
timeout: 30s
protocol:
format: json # json | protobuf | msgpack
channel: matrix # matrix | grpc | channel
heartbeat_interval: 60s
# ============================================
# SSH — INVENTARIO DE SERVIDORES
# ============================================
ssh:
defaults:
user: "root"
port: 22
key_file_env: SSH_KEY_FILE
known_hosts: "~/.ssh/known_hosts"
keepalive_interval: 30s
timeout: 60s
targets: {}
# Ejemplo:
# prod-web:
# hosts: ["web01.example.com", "web02.example.com"]
# user: "deploy"
# port: 22
# key_file_env: SSH_KEY_PROD
# bastion:
# hosts: ["bastion.example.com"]
# user: "admin"
# ============================================
# PERMISOS Y SEGURIDAD
# ============================================
security:
# Nota: roles/audit/secrets aqui son legacy. Usar security/ centralizado.
audit:
enabled: false
log_file: "./agents/_template/data/audit.log"
log_to_room: ""
include: []
secrets:
provider: env # env | vault | sops
# Sanitizacion de prompts (deteccion de injection)
sanitize:
enabled: false
mode: warn # warn | strip | reject
min_severity: medium # low | medium | high
disabled_patterns: []
# Rate limiting de tools por room
tool_rate_limit:
enabled: false
max_calls_per_min: 10
cleanup_interval_s: 60
# ============================================
# SCHEDULING — AUTOMATIZACIONES CRON
# ============================================
schedules: []
# Ejemplo 1: enviar mensaje (send_message)
# - name: "buenos-dias"
# cron: "0 9 * * 1-5" # lunes a viernes a las 9am
# action:
# kind: send_message
# message: "Buenos dias equipo!" # inline
# # template: "prompts/daily.md" # o desde archivo
# output_room: "!roomid:server.com"
# on_failure:
# notify_room: "!admin:server.com"
# escalate_to: ""
# Ejemplo 2: ejecutar tool (run_tool)
# - name: "check-disk"
# cron: "0 */6 * * *" # cada 6 horas
# action:
# kind: run_tool
# target: ssh_exec
# command: "df -h"
# output_room: "!ops:server.com"
# on_failure:
# notify_room: "!admin:server.com"
# Ejemplo 3: prompt LLM (llm_prompt)
# - name: "resumen-logs"
# cron: "0 18 * * *" # diario a las 6pm
# action:
# kind: llm_prompt
# prompt: "Dame un resumen de los logs del dia."
# output_room: "!ops:server.com"
# on_failure:
# notify_room: ""
# ============================================
# OBSERVABILIDAD
# ============================================
observability:
logging:
level: info # debug | info | warn | error
format: json # json | text
output: stdout # stdout | file
file: "./agents/_template/data/template.log"
metrics:
enabled: false
port: 9090
path: /metrics
export: prometheus # prometheus | datadog | ...
health:
enabled: true
port: 8080
path: /healthz
tracing:
enabled: false
provider: "" # jaeger | zipkin | datadog
endpoint: ""
# ============================================
# RESILIENCIA
# ============================================
resilience:
circuit_breaker:
failure_threshold: 5 # abrir tras N fallos consecutivos
timeout: 30s # tiempo en open antes de half-open
half_open_max: 2 # intentos en half-open antes de cerrar
retry:
max_attempts: 2
backoff: exponential # fixed | exponential
initial_delay: 1s
max_delay: 10s
shutdown:
timeout: 10s # tiempo maximo para graceful shutdown
drain_messages: true # procesar mensajes pendientes
save_state: false
state_file: ""
queue:
enabled: true
max_size: 100
priority_users: [] # usuarios con prioridad
# ============================================
# ALMACENAMIENTO Y ESTADO
# ============================================
storage:
base_path: "" # root para datos; default: $AGENTS_DATA_DIR/<id> o agents/<id>/data
state:
backend: sqlite # sqlite | redis | file
path: "./agents/_template/data/template.db"
cache:
enabled: true
backend: memory # memory | redis
ttl: 5m
max_entries: 200
history:
backend: sqlite
path: "./agents/_template/data/history.db"
retention: 168h # 7 dias
Reference in New Issue View Git Blame Copy Permalink