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-Keyque 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.hashque 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 /runsen menos de 30 segundos, o responda202y 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-Keyrepetida 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 reemplacedata/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.
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.mtsAntes 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
idde su manifiesto comienza con él. - Su manifiesto ofrece al menos un tipo por el que la plataforma lista un modelo:
receiver_ppv,max_charge,airblastomovement_field. - Su
pricing.modelesincludedolicence. - Su
dataHandlingno conserva nada y nunca entrena con un caso:retentionesnoneytrainsOnCustomerDataesfalse. Cada caso enviado dice lo mismo.
Conéctelo
- Ejecute su host en una dirección https en el puerto predeterminado, accesible desde internet.
- Un administrador del equipo abre Modelos en los ajustes del equipo, elige
Su código, alojadoen Agregar un modelo e indica la dirección con su ruta base. - La plataforma lee su manifiesto y ejecuta el conjunto de pruebas de conformidad contra su host. Cada comprobación es una ejecución real.
- Una vez que las supera, el propietario del equipo lee qué se enviará y adónde, lo acepta y lo publica.