system-docs/v4-archive/context/docs/USAGE.md

Guía de Uso

Conexión

ssh -i ~/.ssh/tzzr root@localhost "sudo -u postgres psql -d architect"

Consultar Contexto

Contexto completo de un agente

SELECT get_agent_full_context('architect');

Ver bloques asignados

SELECT cb.codigo, cb.tipo, aci.peso, aci.orden
FROM agent_context_index aci
JOIN context_blocks cb ON aci.block_id = cb.id
WHERE aci.agent_id = 'architect' AND aci.activo = true
ORDER BY aci.orden;

Listar todos los bloques

SELECT codigo, tipo, length(contenido) as bytes, tags
FROM context_blocks
ORDER BY tipo, codigo;

Añadir Bloques

Crear nuevo bloque

INSERT INTO context_blocks (codigo, tipo, contenido, tags) VALUES
('mi_bloque', 'knowledge', 'Contenido del bloque...', '{tag1,tag2}');

Asignar bloque a agente

INSERT INTO agent_context_index (agent_id, block_id, peso, orden)
SELECT 'deck', id, 0.9, 10
FROM context_blocks WHERE codigo = 'mi_bloque';

Modificar Bloques

Actualizar contenido

UPDATE context_blocks SET contenido = 'Nuevo contenido...'
WHERE codigo = 'mi_bloque';

Cambiar peso/orden

UPDATE agent_context_index SET peso = 0.8, orden = 5
WHERE agent_id = 'deck'
AND block_id = (SELECT id FROM context_blocks WHERE codigo = 'mi_bloque');

Desactivar Bloques

Desactivar temporalmente

UPDATE agent_context_index SET activo = false
WHERE agent_id = 'deck'
AND block_id = (SELECT id FROM context_blocks WHERE codigo = 'mi_bloque');

Bloque con expiración

INSERT INTO agent_context_index (agent_id, block_id, expires_at)
SELECT 'architect', id, NOW() + INTERVAL '1 day'
FROM context_blocks WHERE codigo = 'temporal_block';

Buscar Bloques

Por tag

SELECT * FROM context_blocks WHERE 'services' = ANY(tags);

Por contenido

SELECT codigo, tipo FROM context_blocks
WHERE contenido ILIKE '%mailcow%';

Estadísticas

Bloques por tipo

SELECT tipo, COUNT(*) as cantidad
FROM context_blocks
GROUP BY tipo ORDER BY tipo;

Bloques por agente

SELECT agent_id, COUNT(*) as bloques
FROM agent_context_index
WHERE activo = true
GROUP BY agent_id ORDER BY bloques DESC;

Tamaño total por agente

SELECT agent_id, SUM(length(cb.contenido)) as bytes
FROM agent_context_index aci
JOIN context_blocks cb ON aci.block_id = cb.id
WHERE aci.activo = true
GROUP BY agent_id ORDER BY bytes DESC;