sdk/1.1.0 · actualizado 10/7/2026

Integraciones y SDK

Primeros recorridos para conectar sensores, recibir señales y consumir la lectura ADDA.

El manual de integraciones muestra cómo conectar sensores, consultas de confianza, evidence y módulos de reputación con una referencia compartida.

La buena integración no termina cuando el endpoint responde. También requiere validar formato, gobernanza, trazabilidad y cómo esa nueva fuente impacta tasks, incidents, automations y el manual vivo.

Usá esta guía para convertir una conexión técnica en una capacidad operativa real dentro de ADDA.

Checklist

• Registrar sensor o dominio antes de habilitar ingestión productiva.
• Probar lectura de confianza y registro de evidence con casos controlados.
• Documentar errores frecuentes por integración.

Quickstart

1. Registrá primero la fuente o el dominio a integrar.
2. Probá un flujo mínimo end-to-end antes de dar la integración por lista.
3. Si la integración deja una duda recurrente, convertí eso en manual candidate.

Flujo operativo

Conectar

Alta de sensor, fuente o módulo que va a empujar señales.

Definir identidad técnica y operativa de la integración.

Validar

Chequear que eventos, scores o evidence salgan con formato útil para ADDA.

Ver si la lectura realmente entra al flujo correcto.

Productizar

Enlazar la integración con docs, manual, tasks o automations cuando aplique.

Evitar integraciones aisladas del resto del producto.

flowchart LR
  S1["Conectar"]
  S2["Validar"]
  S3["Productizar"]
  S1 --> S2
  S2 --> S3

Validadores y checks

Ejecutan una lectura contextual para esta superficie y devuelven pasos sugeridos con foco operativo.

Validar recorrido de integración

Resume artículos y próximos pasos para onboarding técnico-operativo.

Ejemplos

Evento mínimo para ingestión

{
  "type": "sensor.alert",
  "source": "adda-agent-demo",
  "severity": "yellow",
  "summary": "Se detecta actividad anómala en endpoint observado."
}

Links y referencias

Rutas relacionadas

Integraciones públicas Sensores en workspace

APIs

/api/adda/v1/sensors
/api/adda/v1/sensors/register
/api/adda/v1/events/ingest

Docs y rutas de apoyo

docs/ADDA_API.md
docs/ADDA_MANUAL.md

Problemas frecuentes

• Conectar una fuente sin validación operativa suele producir ruido más que cobertura.
• No documentar errores frecuentes hace que el equipo repita diagnósticos.

Acciones sugeridas

• Productizar la integración con quickstarts, ejemplos y rutas visibles.
• Elevar a manual candidate cualquier brecha recurrente de onboarding.

Reason codes útiles

Diccionario de score

severity

Prioridad institucional de la señal en escala ADDA.

action

Siguiente paso operativo recomendado por el motor.

reasonCodes

Motivos explicables para justificar la lectura.

Notas de protocolo

• Una integración lista es la que entra a los flujos operativos, no solo a la API.

Historial del artículo

10/7/2026

Se amplió el artículo con quickstart de integración y ejemplo de ingestión.