Aduana Digital de Defensa Argentina
创建 ADDA 访问权限
← ADDA 手册

sdk/1.1.0 · 更新于 2026年7月9日

集成与 SDK

连接传感器、接收信号并使用 ADDA 评估的首要路径。

集成手册说明如何通过共享引用连接传感器、信任查询、evidence 和信誉模块。

良好的集成不会在 endpoint 响应时结束。还必须验证格式、治理、可追溯性,以及新来源如何影响 tasks、incidents、automations 和动态手册。

使用本指南,把技术连接转化为 ADDA 内真正的运营能力。

检查清单

  • • 启用生产摄取前注册传感器或域名。
  • • 使用受控案例测试信任评估和 evidence 记录。
  • • 记录常见集成错误。

快速开始

  1. 1. 先注册要集成的来源或域名。
  2. 2. 在认为集成已就绪前,测试最小端到端流程。
  3. 3. 如果集成留下重复出现的问题,请将其转为 manual candidate。

运维流程

连接

注册将推送信号的传感器、来源或模块。

定义集成的技术和运营身份。

验证

检查事件、scores 或 evidence 是否采用对 ADDA 有用的格式。

确认评估是否真正进入正确流程。

产品化

适当时将集成关联到文档、手册、tasks 或 automations。

避免集成与产品其他部分隔离。

flowchart LR
  S1["连接"]
  S2["验证"]
  S3["产品化"]
  S1 --> S2
  S2 --> S3

验证器与检查

针对当前界面执行上下文分析,并返回以运维为重点的建议步骤。

验证集成路径

汇总技术运营 onboarding 的文章和后续步骤。

示例

用于摄取的最小事件

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

链接与参考

APIs

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

Docs 与支持路由

  • docs/ADDA_API.md
  • docs/ADDA_MANUAL.md

常见问题

  • • 没有运营验证就连接来源,通常产生的噪音多于覆盖能力。
  • • 不记录常见错误会让团队重复诊断。

建议操作

  • • 通过 quickstarts、示例和可见路由将集成产品化。
  • • 将任何重复出现的 onboarding 缺口提升为 manual candidate。

实用 Reason Codes

Score 字典

severity

信号在 ADDA 量表上的机构优先级。

action

引擎建议的下一项运营步骤。

reasonCodes

用于证明评估合理的可解释原因。

协议说明

  • • 就绪的集成应进入运营流程,而不只是 API。

文章历史

2026年7月9日

通过集成快速入门和摄取示例扩展了文章。