ConceptosConceptos fundamentalesProcedencia y atribución

Concept

Procedencia y atribución

Conserve el origen de una memoria sin confundir los metadatos de origen con la autorización o la propiedad.

La provenance forma parte del registro público de memoria

El contrato de memoria expone provenance junto con content, path, source_identity, agent_id, agent_instance_id_hash y agent_instance_source. La provenance es evidencia estructurada sobre cómo se produjo un registro; no es un bearer token y no puede ampliar el acceso del caller.

  • source_identity es la etiqueta compacta de caller/source que usan las rutas de escritura y auditoría.
  • provenance es un objeto JSON para campos de source, adapter, event u otras evidencias.
  • agent_instance_id_hash es el valor de atribución de instalación que preserva la privacidad.

Los eventos de agente llevan su origen

AgentEvent.to_memory_candidate crea un MemoryCandidate con provenance que contiene source=agent_integration, adapter=<event source> y event_id. La metadata del candidato también conserva el tipo de evento, la hora, el id de agente, el id de tarea, el nombre de la herramienta, el comando, el file path y el status después de ejecutar el sanitizador compartido.

{
  "provenance": {
    "source": "agent_integration",
    "adapter": "codex",
    "event_id": "evt_<stable-event-id>"
  },
  "metadata": {
    "agent_event": {
      "event_type": "decision_made",
      "task_id": "<task-id>"
    }
  }
}

Escribir atribución con la memoria

Los modelos públicos de solicitud remember y store aceptan source y provenance. Proporcione etiquetas estables y no secretas durante la captura; mantenga la credencial de acceso en su encabezado o entorno y deje que el servidor sanitice content, metadata y provenance antes de persistirlos.

POST /v1/remember
X-API-Key: <your-assigned-api-key>
Content-Type: application/json

{
  "content": "The deployment decision was verified.",
  "path": "projects/memory-os/decisions",
  "source": "codex",
  "provenance": {
    "source": "agent_integration",
    "adapter": "codex",
    "event_id": "evt_<stable-event-id>"
  }
}

La sanitización no borra la trazabilidad

El sanitizador de persistencia recorre estructuralmente content, metadata y provenance. Elimina los valores con forma de credencial; si hay redaction, el servidor registra metadata de auditoría privacy.server_write_sanitizer y conserva los campos seguros de provenance. Trate el registro resultante como evidencia sanitizada, no como un archivo de eventos sin procesar.

Flujos de roles

Usuario de ChatGPT

Dale a ChatGPT acceso duradero a tus preferencias de XMemo, datos de proyecto, decisiones y TODOs sin pegar fichas bearer en un chat.

Guarde una nota de preferencia sintética o de proyecto, inicie un nuevo chat y luego pida a ChatGPT que la recuerde a través de XMemo antes de continuar el trabajo.

Copiloto / Codex desarrollador

Lleve decisiones de repo, convenciones de codificación, notas de corrección de errores e historial de tareas entre los agentes IDE y CLI.

Grabe una decisión de base de código o corrección de errores, y luego pida al siguiente agente IDE o CLI que recuerde el contexto XMemo relevante antes de editarlo.

Equipo / propietario del piloto de la empresa

Evalúe la memoria compartida con controles de cuenta, atribución de origen, flujos de trabajo export/delete y pruebas de configuración seguras para los revisores.

Haga que un miembro piloto guarde una memoria sintética del equipo, confirme la atribución de origen en XMemo, luego revise delete/export y las rutas de soporte.

Fuente: Identidad del agente