Manual del Agente _judicial: cómo capacitarte, cargar información y operar con el swarm

Regla de Oro del swarm
La IA asiste. El magistrado decide. La firma es humana. La responsabilidad es del juez.
Toda sugerencia es un borrador sujeto a validación humana (gates J1, J2, J3, J4).

📖 Tabla de contenidos

1. Capacitarse: cómo aprender a usar todas las funcionalidades
2. Cargar información: cómo alimentar el agente con datos
3. Operar con el agente: cómo usarlo para las distintas tareas
4. Glosario rápido de comandos
5. Aviso de seguridad y límites

---

1. Capacitarte con el agente

El agente _judicial se ofrece como un bot de Telegram (@judicialsf_bot) que responde en español. Antes de usarlo en un caso real, dedicá 30-45 minutos a recorrer estas prácticas en modo training (casos sintéticos).

1.1. Primer contacto

1. Abrí Telegram y buscá @judicialsf_bot (o hace clic en el link directo).
2. Mandá /start para ver la bienvenida.
3. Mandá /help para ver todos los comandos.
4. Mandá /casos para ver los 3 casos de práctica (basados en datos reales del muestreo oficial del Ministerio de Justicia).

1.2. Recorrido por los 4 roles

El swarm tiene 4 roles administradores y 2 roles especialistas. Empezá por los 4 roles básicos en orden:

Rol	Qué hace	Comando de práctica	Cuándo usarlo
A — Primer Control	Verifica cumplimiento de requisitos formales (sellado, firmas, personería) y detecta urgencias.	/rol-a FAM-2024-001	Cuando ingresa un escrito o demanda al juzgado.
B — Sistematizador	Extrae datos críticos de escritos (partes, DNIs, domicilios) y mantiene actualizada la carátula del expediente.	/rol-b FAM-2024-001	Después del control formal, para abrir/actualizar la ficha.
C — Auxiliar de Trámite	Clasifica el tipo de trámite, resume escritos extensos, controla plazos procesales.	/rol-c FAM-2024-001	Para entender rápidamente qué pidió el profesional y en qué estado está el expediente.
D — Redactor	Genera borradores de decretos y proveídos de mero trámite, con fundamentación.	/rol-d FAM-2024-001	Cuando hay que producir un decreto (admisión, traslado, apertura a prueba, etc.).

1.3. Roles especialistas

Una vez que domines los 4 roles básicos, probá los especialistas:

Rol	Qué hace	Comando	Cuándo usarlo
Pericial Tecnológica	Evalúa informes periciales sobre IA, algoritmos, datos o criptoactivos. Genera preguntas para el perito.	/pericia FAM-2024-003	Cuando tenés que analizar un informe pericial sobre tecnología (Módulo 6 del curso).
Asistente de Sentencia	Acompaña el análisis de fondo. Identifica hechos, prueba, normativa y checklist. NO redacta sentencias.	/sentencia FAM-2024-001	Para preparar la audiencia o el dictado de una resolución sobre el fondo (Módulo 5 del curso, gate J4).

1.4. Ejercicio sugerido (45 minutos)

1. (5 min) Mandá /start, /help, /casos. Familiarizate con la interfaz.
2. (10 min) Recorré los 4 roles básicos sobre el caso FAM-2024-001 (violencia familiar): /rol-a FAM-2024-001, /rol-b FAM-2024-001, /rol-c FAM-2024-001, /rol-d FAM-2024-001. Compará los outputs: ¿qué detectó cada uno?
3. (10 min) Probá FAM-2024-002 (sucesión + alimentos). Notá que el Rol A detecta sin urgencia (a diferencia del caso 1).
4. (10 min) Probá FAM-2024-003 (sucesión con criptoactivos). Usá /pericia para ver el checklist metodológico (Módulo 6).
5. (5 min) Para cualquier caso: /sentencia. Notá los disclaimers: el bot NO redacta sentencias, solo organiza el análisis.
6. (5 min) Usá los botones 👍/👎 al final de cada respuesta para registrar feedback. Esto ayuda a mejorar el swarm.

1.5. Recorrido por los datos abiertos

El bot consulta dos datasets oficiales del Ministerio de Justicia:

• /datos — Estadísticas del muestreo oficial (1.000 casos representativos).
• /cobertura — Provincias y años que tienen datos publicados. Santa Fe tiene cobertura 2016-2025 (10 años).
• /normativa <query> — Búsqueda de normativa por código de materia (FAM, FP, FS, etc.).
• /jurisprudencia <query> — Búsqueda de precedentes en el muestreo.

---

2. Cargar información para usarla después

El agente _judicial trabaja con datos de tres fuentes principales:

1. Casos sintéticos del swarm (los 3 casos FAM-2024-001/002/003).
2. Muestreo oficial de causas no penales del Ministerio de Justicia de la Nación (1.000 casos, 256 KB).
3. E-learning de Odoo (curso 6: "IA para la Práctica Judicial", 8 slides, 31 horas).

2.1. Cómo se cargan los casos sintéticos

Los 3 casos están embebidos en el archivo ~/.hermes/profiles/_judicial/skills/_judicial-expediente-reader/SKILL.md como un diccionario Python (CASOS_FAMILIA_TRAINING). Para agregar un caso nuevo:

1. Editá el archivo y agregá una entrada con el formato:

   "FAM-2024-004": {
       "caratula": "...",
       "fuero": "Familia",
       "juzgado": "...",
       "objeto": "...",
       "partes": [...],
       "nna": [...],
       "estado": "...",
       "metadata_para_capacitacion": {
           "patron_real": "...",
           "alertas_reales": "..."
       }
   }

2. Sincronizá el bot copiando los mismos casos a telegram/scripts/bot.py en la variable CASOS.
3. Reiniciá el bot: pkill -f bot.py; python3 scripts/bot.py &

2.2. Cómo se carga el muestreo oficial

El archivo ~/.hermes/profiles/_judicial/data/muestreo_causas_no_penales.csv contiene 1.000 registros descargados del portal datos.jus.gob.ar. Para actualizarlo:

curl -L -o muestreo_causas_no_penales.csv \
  "https://datos.jus.gob.ar/dataset/031d3827-927e-47af-b679-7fda70aa44a7/resource/41510df2-8ad2-44b0-8acf-c526a97db66a/download/poderes-judiciales-causas-no-penales-muestreo.csv"

El bot lee este CSV en cada consulta, así que no requiere reinicio.

2.3. Cómo se carga el index de provincias/años

El archivo provincias_y_anios_disponibles.csv indica qué provincias tienen datos y para qué años. Útil para responder consultas tipo "¿hay datos de Santa Fe de 2020?".

2.4. Cómo se cargan los slides del e-learning

Los slides se crean vía XML-RPC en el Odoo e-learning. El comando es:

python3 scripts/update_odoo_slides.py \
  --course 6 \
  --module 8 \
  --title "Módulo 8: ..."

2.5. Configuración del bot (operadores y permisos)

En el archivo ~/.hermes/profiles/_judicial/telegram/.env (chmod 600, gitignored):

TELEGRAM_BOT_TOKEN=*** Operadores autorizados para funciones admin.
# Separados por coma. Solo ellos pueden usar /feedback, /stats, /admin.
ALLOWED_USERS=543303318,1007231414
MODE=training

Para agregar un operador nuevo, editá el .env y reiniciá el bot.

2.6. Casos personalizados para capacitación

Si querés cargar casos específicos para una cohorte (por ejemplo, casos propios del juzgado), usá CASOS_FAMILIA_TRAINING como plantilla. Recomendamos:

• Usar datos sintéticos o anonimizados (no nombres reales).
• Mantener el formato JSON del swarm (caratula, partes, nna, estado, metadata_para_capacitacion).
• Documentar la fuente real en case_id_real cuando corresponda.
• Mantener el watermark ⚠️ DRAFT - Requiere validación humana en cualquier output.

---

3. Cómo usar el agente para las distintas tareas

El agente _judicial asiste en 4 tipos de tareas, mapeadas a las que realiza un juzgado en su operatoria cotidiana. Cada tarea tiene un flujo recomendado.

3.1. Tarea: Dictar sentencias

Rol principal: Asistente de Sentencia (gate J4) + Rol D (Redactor).

El agente NO redacta sentencias completas. Lo que hace:

• Identifica los hechos relevantes del caso (con foja).
• Lista la prueba disponible.
• Cita la normativa aplicable (con fuente).
• Cita la jurisprudencia relevante (con fuente).
• Subraya las cuestiones discrecionales donde el magistrado decide.
• Devuelve un checklist de verificación final.

Flujo recomendado:

1. /expediente FAM-2024-001 — Leé el expediente completo.
2. /sentencia FAM-2024-001 — Obtené el checklist de análisis (hechos, prueba, normativa, checklist).
3. /jurisprudencia <tema> — Buscá precedentes en el muestreo.
4. Redactá TU sentencia con el análisis del agente como insumo.

⚠️ Importante (Gate J4): la decisión sobre el fondo es exclusivamente del magistrado. El agente te ayuda a organizar, no decide.

3.2. Tarea: Mantener actualizada la carátula del expediente

Rol principal: Rol B (Sistematizador).

El Rol B extrae datos críticos de los escritos y mantiene la ficha del juicio:

• Nombres y DNI/CUIT de las partes.
• Profesionales intervinientes.
• Domicilios (físicos y constituidos electrónicos).
• Pretensión principal.
• Vínculos en casos de familia o sucesiones.

Flujo recomendado:

1. /rol-b FAM-2024-001 — Obtené la extracción de datos.
2. Verificá la información contra el escrito original.
3. Actualizá la ficha del juicio con los datos validados.

3.3. Tarea: Controlar cuestiones formales

Rol principal: Rol A (Primer Control).

El Rol A verifica el cumplimiento de requisitos de admisibilidad (sellado, firmas digitales, personería, documentación). Detecta urgencias. Redacta decretos de cumplimiento previo.

Flujo recomendado:

1. /rol-a FAM-2024-001 — Obtené el control formal del escrito.
2. Si hay urgencia, priorizá el caso y derivá al magistrado.
3. Si hay faltantes no urgentes, usá el decreto propuesto por el Rol A como base y adaptalo.
4. Si todo OK, avanzá con el trámite normal.

3.4. Tarea: Gestión administrativa y procedimental

Roles principales: Rol C (Auxiliar) + Rol D (Redactor).

El Rol C clasifica el trámite, resume escritos extensos y controla plazos. El Rol D redacta proveídos.

Flujo recomendado:

1. /rol-c FAM-2024-001 — Conocé el tipo de trámite y el estado procesal.
2. Si necesitás un decreto: /rol-d FAM-2024-001.
3. Para escritos extensos: pedile al Rol C un resumen ejecutivo.

3.5. Tarea: Evaluar prueba pericial tecnológica

Rol principal: Pericial Tecnológica (gate J1 + J2).

Útil cuando tenés un informe pericial sobre IA, algoritmos, datos o criptoactivos.

Flujo recomendado:

1. /pericia FAM-2024-003 — Evaluá el informe pericial.
2. Leé las preguntas generadas para el perito.
3. Si el informe es insuficiente, usá la ampliación sugerida.
4. Cumplimentá el checklist del magistrado antes de dictar resolución.

3.6. Tabla resumen de uso por tarea

Tarea	Comandos principales	Rol / Skill	Gate
Dictar sentencias	/expediente, /sentencia, /jurisprudencia	Asistente de Sentencia	J1+J2+J3+J4
Mantener carátula	/rol-b, /expediente	Rol B (Sistematizador)	J1
Control formal	/rol-a	Rol A (Primer Control)	J1
Gestión administrativa	/rol-c, /rol-d	Rol C (Auxiliar), Rol D (Redactor)	J1+J3
Pericial tecnológica	/pericia	Pericial Tecnológica	J1+J2
Búsqueda de normativa	/normativa, /jurisprudencia, /datos, /cobertura	Datos Abiertos	J2
Operaciones de operador	/feedback, /stats, /admin	Solo operadores autorizados	—

---

Glosario rápido de comandos

Comando	Función	Quién puede usarlo
/start	Bienvenida del bot	Cualquiera
/help	Lista de comandos	Cualquiera
/casos	Lista los 3 casos disponibles	Cualquiera
/datos	Estadísticas del dataset oficial	Cualquiera
/cobertura	Provincias y años con datos	Cualquiera
/rol-a <caso>	Control formal (Mesa de Entradas)	Cualquiera
/rol-b <caso>	Sistematización de la carátula	Cualquiera
/rol-c <caso>	Clasificación de trámite	Cualquiera
/rol-d <caso>	Draft de decreto / proveído	Cualquiera
/pericia <caso>	Evaluar pericial tecnológica (Módulo 6)	Cualquiera
/sentencia <caso>	Análisis para sentencia (gate J4)	Cualquiera
/expediente <caso>	Lectura completa del expediente	Cualquiera
/normativa <query>	Buscar normativa en muestreo	Cualquiera
/jurisprudencia <query>	Buscar jurisprudencia	Cualquiera
/admin	Ver tu rol (operador o usuario)	Cualquiera
/feedback	Ver feedback reciente	Solo operadores
/stats	Estadísticas de uso del bot	Solo operadores

---

Aviso de seguridad y límites

---

Manual del agente _judicial · Programa de capacitación "IA para la Práctica Judicial" · Poder Judicial de la Provincia de Santa Fe · 2026