Saltar al contenido principal
Menú para desarrolladores
Vista previa para sociosv0

Alojar su modelo

Su modelo se ejecuta en un host que usted controla, y un equipo lo conecta por su dirección. La plataforma lo llama a través de la Model API, con firma, y conserva sus respuestas junto a las de la propia plataforma. Nunca guarda su modelo: solo su dirección, su manifiesto, sus claves públicas y lo que respondió.

Qué envía la plataforma

  • El caso de una voladura, solo con las entradas que su manifiesto declara, como POST /runs.
  • Solo cuando alguien del equipo lo pide: “Ejecutar modelos conectados” en una voladura, o una prueba retrospectiva (backtest). Nunca porque una voladura haya cambiado.
  • Cada solicitud firmada con la clave Ed25519 de la plataforma, con una Idempotency-Key que es la misma en cada reintento de una ejecución.
  • Una URL de callback propia de la ejecución, si usted responde 202. Manténgala privada: identifica la ejecución.

Qué no envía nunca

  • Una entrada que su manifiesto no declara, ni siquiera durante las pruebas de conformidad.
  • Quién pidió la ejecución, ni ningún otro dato sobre las personas del equipo.
  • Un secreto compartido. Nadie tiene la clave privada de la otra parte.
  • Un encabezado Authorization. Su host debe ser accesible sin él.

Qué conserva la plataforma

  • Su manifiesto tal como se conectó, y su hash, para saber cuándo cambia.
  • Las claves públicas que su manifiesto declara, para comprobar sus callbacks.
  • Sus respuestas, como registros del equipo junto a los de la plataforma, sin provenance.parameters.
  • El build.hash que usted informa, con cada resultado.
  • Cuándo se envió y se respondió cada solicitud, y cómo terminó.

Qué debe hacer su host

  • Compruebe la firma de cada solicitud, salvo /healthz, contra las claves de /developers/keys/v0.json.
  • Responda a POST /runs en menos de 30 segundos, o responda 202 y envíe después un callback firmado con su clave.
  • Mantenga cada ejecución consultable en GET /runs/{id} durante 24 horas: la plataforma consulta allí cuando un callback se retrasa.
  • Responda al mismo caso de la misma manera, y a una Idempotency-Key repetida con la ejecución original.
  • Decline lo que no pueda responder, y diga por qué, en lugar de adivinar.
  • No cambie nada bajo una versión que ya conectó. Un manifiesto, o el build que responde, que cambia bajo la misma versión detiene las ejecuciones del modelo hasta que se restablezca o se conecte una versión nueva.
  • Rote su clave en tres pasos: cree usted mismo la nueva (openssl genpkey -algorithm ed25519), publique y conecte una versión que liste ambas mientras sigue firmando con la antigua, y luego firme con la nueva (HOST_SIGNING_KEY, o reemplace data/host-key.pem) y retire la antigua en la versión siguiente.

Parta de una plantilla

Las plantillas hacen todo lo anterior: un servidor Node sin dependencias y uno en Python que solo necesita cryptography, cada uno con un modelo de ejemplo resuelto para reemplazar. bootstrap.sh descarga una en una máquina nueva. En su primer arranque, una plantilla crea su clave en data/host-key.pem e imprime el bloque signing para pegarlo en manifest.json. A partir de entonces sirve exactamente las claves listadas allí, y no arranca sin su archivo de clave (o HOST_SIGNING_KEY) ni con una clave que la lista omita, de modo que una clave perdida nunca se convierte en una nueva bajo la misma versión.

shell
curl -fsSL https://app.shockai.co/developers/templates/v0/bootstrap.sh | sh -s -- node
PUBLIC_ORIGIN=https://models.example.com BUILD_HASH=$(git rev-parse --short HEAD) node shockai-model/server.mts

Antes de conectar

  • Su equipo tiene activados Modelos del equipo y Modelos conectados. Cómo los obtiene un equipo.
  • Su equipo tiene su espacio de nombres de modelos, que ShockAI asigna con Modelos del equipo. El id de su manifiesto comienza con él.
  • Su manifiesto ofrece al menos un tipo por el que la plataforma lista un modelo: receiver_ppv, max_charge, airblast o movement_field.
  • Su pricing.model es included o licence.
  • Su dataHandling no conserva nada y nunca entrena con un caso: retention es none y trainsOnCustomerData es false. Cada caso enviado dice lo mismo.

Conéctelo

  1. Ejecute su host en una dirección https en el puerto predeterminado, accesible desde internet.
  2. Un administrador del equipo abre Modelos en los ajustes del equipo, elige Su código, alojado en Agregar un modelo e indica la dirección con su ruta base.
  3. La plataforma lee su manifiesto y ejecuta el conjunto de pruebas de conformidad contra su host. Cada comprobación es una ejecución real.
  4. Una vez que las supera, el propietario del equipo lee qué se enviará y adónde, lo acepta y lo publica.