Automatice la actualización de sus posiciones con su propio agente

Qué hace el flujo

Con Jade activo, su propio agente puede convertir una exportación de posiciones de una institución en una cartera actualizada en Portfonia. Comprueba la fuente, lee la cartera, prepara y valida cambios, los guarda y consulta el historial. Su agente y sus herramientas gestionan el acceso a la institución, las exportaciones y la programación. Portfonia no inicia sesión en instituciones, descarga estados de cuenta ni programa estas ejecuciones; guarda y actualiza registros de posiciones y no ejecuta operaciones bursátiles.

Configuración inicial

En la página Agente de IA, cree un token de escritura de posiciones para un agente que las actualice, o un token de solo lectura para uno que únicamente lea. Entregue al agente el token y https://portfonia.com/llms.txt. Primero llama a GET /agent/v1/token (Verificar los permisos del token). Un agente que actualiza se detiene si capabilities.holdings_write es false; uno de solo lectura se detiene si capabilities.holdings_read es false.

Cada ejecución, paso a paso

  1. Compruebe que la exportación incluya todas las cuentas de la institución y tenga la fecha de corte esperada. Omita una exportación parcial o desactualizada.
  2. Lea GET /agent/v1/holdings y conserve el valor version y el id de cada posición.
  3. Vincule las filas existentes por su ID estable, nunca solo por ticker. El mismo instrumento en dos cuentas corresponde a dos filas.
  4. Cambie únicamente las filas de esta institución. Use POST /agent/v1/holdings para crear, PATCH /agent/v1/holdings/{holding_id} para modificar o DELETE /agent/v1/holdings/{holding_id} para eliminar. DELETE elimina el ID de la ruta. Como alternativa, PUT /agent/v1/holdings debe incluir las demás filas sin cambios: conserve las filas existentes en holdings y enumere los ID eliminados en delete_ids. Si una fila existente falta en ambas listas, falla toda la solicitud.
  5. Antes de crear, reemplazar toda la cartera, reemplazar una fila o aplicar PATCH, llame a POST /agent/v1/holdings/validate con operation create, replace_all, replace o patch y los campos correspondientes descritos en agent.md. Continúe solo si valid es true y escriba con la version actual. El reemplazo de una fila usa PUT /agent/v1/holdings/{holding_id}. La eliminación no tiene paso de validación; envíe su versión actual entre comillas en el encabezado If-Match, sin cuerpo JSON. La validación no reserva una versión ni garantiza una escritura posterior.
  6. Ante 409 version_conflict, vuelva a leer la cartera y recalcule el cambio previsto. Nunca reenvíe un cuerpo anterior cambiando solo version. Use la versión devuelta para cada escritura posterior.
  7. Para crear mediante POST, envíe Idempotency-Key. Tras un tiempo de espera agotado, reintente con la misma clave y el mismo cuerpo, incluida la versión original, dentro de 24 horas para obtener el resultado original. Vuelva a leer antes de otra escritura.
  8. Después, lea GET /agent/v1/holdings/changes con fechas ET start y end inclusivas dentro de los últimos 30 días para confirmar los cambios. Si truncated es true, reduzca el intervalo. Las escrituras sin cambios y los reintentos idempotentes no crean un grupo en el historial.

Límites y medidas de protección

Jade permite 100 filas guardadas, incluidos el efectivo y las posiciones en observación. Las escrituras de una fila comparten 30 solicitudes por minuto y 100 por hora entre todos sus tokens. Las lecturas, PUT de toda la cartera y la validación usan los límites de lectura habituales. Los períodos de pausa suspenden las solicitudes desde cinco minutos antes de una tarea programada pesada hasta cinco minutos después de su finalización; use Retry-After si se rechaza una solicitud. La API no permite eliminar la última posición; vacíe la cartera solo en la web. Las lecturas correctas de posiciones actuales, historial de cambios, instantáneas y resultados de riesgo de Jade comparten como máximo un aviso de acceso por día ET. Las escrituras correctas pueden generar un aviso diario de modificación separado; la validación y los reintentos idempotentes no envían avisos de datos. El enlace del aviso revoca todos los tokens de su cuenta a la vez, incluidos los de otros agentes. Detiene accesos futuros y no deshace cambios guardados. Una escritura del agente o una carga de archivo que reduzca considerablemente las filas de posiciones o cambie su valor total puede generar una alerta por correo separada, como máximo una por fecha de la escritura en hora del Este.

Qué cambia en Portfonia

Las escrituras actualizan la cartera actual guardada en Portfonia. Los resúmenes posteriores y las herramientas de Jade de simulación histórica de posiciones, riesgo de cola, escenarios de estrés histórico, exposición por estilo y seguimiento usan la cartera actualizada. Cada solicitud queda en el registro de auditoría, que guarda metadatos de la solicitud, sin cuerpos de posiciones ni tokens completos.