3. Publicar activos en AgrospAI
Guía sobre como publicar datos y servicios en AgrospAI.
Publicación de un conjunto de datos
Agregar un conjunto de datos al espacio de datos significa registrar sus metadatos para que aparezcan en el mercado para que puedan adquirirse y consumirse. Solo los metadatos se registran en la infraestructura del espacio de datos, los datos permanecen bajo el control del titular de los datos. La publicación se puede realizar de forma interactiva desde el mercado del espacio de datos seleccionando la opción del menú superior "Publicar", como se muestra en Fig. 5. El formulario de publicación recopila primero los metadatos necesarios para el conjunto de datos, incluido el título, la descripción, las etiquetas... Luego, el editor también debe proporcionar cómo se hace accesible el conjunto de datos, a través de "descarga" o "cómputo".
En ambos casos, un "proveedor de datos" intermediará para hacer cumplir las reglas de acceso. Se puede utilizar el proveedor predeterminado, aunque el editor tiene la libertad de definir uno personalizado. La información adicional para el acceso incluye desde dónde están disponibles los datos (generalmente la URL desde donde se pueden descargar y que será mantenida privada por el "Proveedor de datos"), el tiempo de espera para el consumo o un enlace a un archivo de muestra que ayude a los consumidores potenciales a tener una idea sobre los datos. El siguiente paso en el formulario consiste en establecer el precio del conjunto de datos, que puede ofrecerse de forma gratuita o por un precio en EUROe, una versión de prueba de una moneda digital vinculada al euro. Esta es la moneda recomendada para que los precios sean más transparentes para los consumidores.
Por último, es posible revisar cómo se presentará el activo en el marketplace antes de confirmar la publicación mediante la firma de las transacciones correspondientes que mantendrán un registro inmutable de la publicación y vincularán el conjunto de datos a la cuenta que firma las transacciones.
Fig. 5. Formulario de publicación del conjunto de datos (fuente: https://portal.agrospai.udl.cat)
Alternativamente, también es posible publicar un conjunto de datos a partir de código utilizando la libreria TypeScript Nautilus o desde la línea de comandos utilizando el comando "publish" de la herramienta de línea de comandos Pontus-X CLI.
Publicación de un algoritmo
El espacio de datos AgrospAI admite la publicación de conjuntos de datos y algoritmos. Estos últimos son servicios de procesamiento de datos que se empaquetan como contenedores de Docker y scripts que se ejecutarán en el contexto de esos contenedores. La publicación se activa de forma interactiva de la misma manera que se publican los conjuntos de datos, a través de la opción de la barra de menú "Publicar". En el formulario asociado, es necesario seleccionar "Algoritmo" como tipo de activo en lugar de "Conjunto de datos".
Además, además de los metadatos como el título, la descripción o las etiquetas, también es necesario definir la imagen de Docker que se utilizará para el algoritmo. En cuanto a los detalles de acceso, se debe proporcionar un puntero a la ubicación del script que desencadena la ejecución del algoritmo en el contexto del contenedor. Se proporcionan más detalles sobre cómo empaquetar y cómo ejecutar el algoritmo en el espacio de datos en "Writing Algorithms" de Ocean Protocol. Además, hay ejemplos en el repositorio ocean-algo.
Los algoritmos pueden estar disponibles para descargar "Download" o únicamente para procesar "Compute". En el primer caso, el script utilizado por el algoritmo estará disponible para su descarga una vez adquirido. En ambos casos, el algoritmo se puede consumir junto con un conjunto de datos configurado para el consumo de proceso a datos. Al igual que para los conjuntos de datos, también es posible definir la fecha límite de consumo después de la adquisición o el precio del algoritmo. Finalmente, después de revisar los metadatos del algoritmo, la publicación se confirma mediante la firma de las transacciones correspondientes.
Alternativamente, también es posible publicar un conjunto de datos desde código utilizando la libreria en lenguaje TypeScript Nautilus o desde la línea de comandos utilizando el comando "publish" de la CLI de Pontus-X.
Políticas de acceso y uso
El espacio de datos AgrospAI implementa el conjunto de políticas de acceso y uso implementadas en el ecosistema Pontus-X a través de contratos inteligentes y tecnología de contabilidad distribuida. Estas políticas se pueden definir a través de la interfaz de usuario del mercado durante la publicación de recursos. Además, se pueden configurar mediante programación mediante Nautilus o Pontus-X CLI.
Por ejemplo, como se muestra en Fig. 6, es posible definir el tiempo de espera que tiene cualquier persona que adquiera un activo (conjunto de datos o algoritmo) antes de que sea necesario volver a adquirirlo. Oscila entre 1 día y 1 año. Además, el derecho de consumo no puede caducar y puede ser para siempre después de la adquisición.
Fig. 6. Definición del tiempo de espera de consumo de activos durante la publicación (fuente: https://portal.agrospai.udl.cat)
Los instrumentos de definiciones de directiva adicionales durante la publicación de activos son las listas de cuentas permitidas y denegadas, como se muestra en Fig. 7. La lista de permitidos define qué participantes del espacio de datos pueden consumir explícitamente el recurso (conjunto de datos o algoritmo). Si la lista está vacía, cualquiera puede descargar o calcular este recurso. Por otro lado, si una dirección está en la lista de denegación, se denegará la descarga o el cálculo de este recurso para el participante del conjunto de datos correspondiente.
Fig. 7. Definición de cuentas permitidas y denegadas para el consumo de activos durante la publicación (fuente: https://portal.agrospai.udl.cat)
Por último, también es posible editar un conjunto de datos existente configurado para el consumo de "cómputo" para definir los algoritmos individuales que pueden ejecutarse en el conjunto de datos, como se muestra en Fig. 8. Además, los algoritmos permitidos para un conjunto de datos también pueden ser personalizados por el propietario del conjunto de datos utilizando el comando "edit-trusted-algos" de la herramienta Pontus-X CLI.
Fig. 8. Definición de algoritmos permitidos para un conjunto de datos para el consumo de cómputo (fuente: https://portal.agrospai.udl.cat)