Desarrolladores

Conector para agentes de IA

Tu agente puede preparar registros de obras por API. Pero aquí no hay certificación automática: cada borrador espera la aprobación de un humano — el titular de la cuenta — antes de entrar al pipeline de sellado. Así lo diseñamos y así lo decimos: un certificado probatorio no debe emitirse sin un acto humano de voluntad.

Cómo funciona

Human-in-the-loop en cuatro pasos

1 — Obtén una clave de agente

Necesitas una cuenta con la Verificación de identidad y perfil aprobada (detrás de cada agente debe haber un humano identificado). Después: Mi panel → Cuenta → «Claves de agente IA» → Crear clave. El token (vugc_…) se muestra una sola vez; guárdalo en tu gestor de secretos. En nuestra base de datos solo vive su hash.

2 — Crea un borrador

Envía la obra por multipart con la cabecera X-Api-Key. La respuesta es honesta: obtienes un workId en estado agent_draft, no un certificado.

curl -X POST https://ugc.veritasdigital.tech/api/v1/agent/works/draft \
  -H "X-Api-Key: vugc_TU_CLAVE" \
  -F "file=@fotografia.jpg" \
  -F "declaredTitle=Fotografía del puente al amanecer" \
  -F "declaredType=image" \
  -F "disclaimerVersion=2026-07-28" \
  -F "locale=es-VE"

# → { "workId": "…", "status": "agent_draft",
#     "message": "Borrador creado. Un humano debe aprobarlo desde su panel
#                 antes de que entre al pipeline de sellado." }

3 — Aprobación humana (el paso que tu agente no puede saltarse)

El titular ve el borrador en Mi panel → Cuenta → «Aprobaciones pendientes» y decide: aprobar (la obra entra al pipeline: cuarentena, hash, certificado, anclaje) o rechazar (el archivo se elimina). No existe ningún endpoint de API que apruebe un borrador: la aprobación exige la sesión del humano.

4 — Consulta el estado (polling)

curl -H "X-Api-Key: vugc_TU_CLAVE" https://ugc.veritasdigital.tech/api/v1/agent/works/WORK_ID

# status: agent_draft → uploaded → quarantined → processing → stored → certified
# "certified" + anchorStatus indican certificado emitido y anclaje Bitcoin.
# Verificación pública: https://ugc.veritasdigital.tech/v/<verificationSlug>

Recomendado: intervalos de 60 s o más. El paso agent_draft → uploaded depende de una persona y puede tardar horas o días.

Límites y manifiesto

20 borradores por hora y clave. Tamaño máximo de archivo: el mismo que en la subida normal. Manifiesto máquina-legible del conector (endpoints, campos, flujo): GET https://ugc.veritasdigital.tech/api/v1/agent/manifest — público, pensado para que tu agente lo lea antes de integrarse. Las claves se revocan al instante desde el panel.

¿Dudas? Escríbenos desde la página de contacto.