3. Publicar actius a AgrospAI
Guia sobre com publicar dades i serveis a AgrospAI.
Publicació d'un conjunt de dades
Afegir un conjunt de dades a l'espai de dades significa registrar els seus metadades perquè apareguin al mercat perquè puguin adquirir-se i consumir-se. Només les metadades es registren a la infraestructura de l' espai de dades, les dades romanen sota el control del titular de les dades. La publicació es pot realitzar de forma interactiva des del mercat de l'espai de dades seleccionant l'opció del menú superior "Publicar", com es mostra a Fig. 5. El formulari de publicació recopila primer les metadades necessàries per al conjunt de dades, inclòs el títol, la descripció, les etiquetes... Després, el editor també ha de proporcionar com es fa accessible el conjunt de dades, a través de "descàrrega" o "còmput".
En ambdós casos, un "proveïdor de dades" intermediarà per fer complir les regles d'accés. Es pot utilitzar el proveïdor predeterminat, encara que l'editor té la llibertat de definir-ne un de personalitzat. La informació addicional per a l'accés inclou des d'on estan disponibles les dades (generalment l'URL des d'on es poden descarregar i que serà mantinguda privada pel "Proveïdor de dades"), el temps d'espera per al consum o un enllaç a un arxiu de mostra que ajudi els consumidors potencials a tenir una idea sobre les dades. El següent pas en el formulari consisteix a establir el preu del conjunt de dades, que pot oferir-se de forma gratuïta o per un preu en EUROe, una versió de prova d'una moneda digital vinculada a l'euro. Aquesta és la moneda recomanada perquè els preus siguin més transparents per als consumidors.
Finalment, és possible revisar com es presentarà l'actiu al marketplace abans de confirmar la publicació mitjançant la signatura de les transaccions corresponents que mantindran un registre immutable de la publicació i vincularan el conjunt de dades al compte que signa les transaccions.
Fig. 5. Formulari de publicació del conjunt de dades (font: https://portal.agrospai.udl.cat)
Alternativament, també és possible publicar un conjunt de dades a partir de codi utilitzant la libreria TypeScript Nautilus o des de la línia d'ordres utilitzant la comanda "publish" de l'eina de línia d'ordres Pontus-X CLI.
Publicació d'un algoritme
L'espai de dades AgrospAI admet la publicació de conjunts de dades i algoritmes. Aquests últims són serveis de processament de dades que s'empaqueten com a contenidors de Docker i scripts que s'executaran en el context d'aquests contenidors. La publicació s'activa de forma interactiva de la mateixa manera que es publiquen els conjunts de dades, a través de l'opció de la barra de menú "Publicar". En el formulari associat, cal seleccionar "Algoritme" com a tipus d'actiu en lloc de "Conjunt de dades".
A més, a més de les metadades com el títol, la descripció o les etiquetes, també cal definir la imatge de Docker que s'utilitzarà per a l'algoritme. Pel que fa als detalls d'accés, s'ha de proporcionar un punter a la ubicació de l'script que desencadena l'execució de l'algoritme en el context del contenidor. Es proporcionen més detalls sobre com empaquetar i com executar l'algoritme a l'espai de dades a "Writing Algorithms" de Ocean Protocol. A més, hi ha exemples al repositori ocean-algo.
Els algoritmes poden estar disponibles per descarregar "Download" o únicament per processar "Compute". En el primer cas, l'script utilitzat per l'algoritme estarà disponible per a la seva descàrrega un cop adquirit. En ambdós casos, l'algoritme es pot consumir juntament amb un conjunt de dades configurat per al consum de procés a dades. Igual que per als conjunts de dades, també és possible definir la data límit de consum després de l'adquisició o el preu de l'algoritme. Finalment, després de revisar les metadades de l'algoritme, la publicació es confirma mitjançant la signatura de les transaccions corresponents.
Alternativament, també és possible publicar un conjunt de dades des de codi utilitzant la libreria en llenguatge TypeScript Nautilus o des de la línia d'ordres utilitzant la comanda "publish" de la CLI de Pontus-X.
Polítiques d'accés i ús
L'espai de dades AgrospAI implementa el conjunt de polítiques d'accés i ús implementades a l'ecosistema Pontus-X a través de contractes intel·ligents i tecnologia de comptabilitat distribuïda. Aquestes polítiques es poden definir a través de la interfície d'usuari del mercat durant la publicació de recursos. A més, es poden configurar mitjançant programació mitjançant Nautilus o Pontus-X CLI.
Per exemple, com es mostra a Fig. 6, és possible definir el temps d'espera que té qualsevol persona que adquireixi un actiu (conjunt de dades o algoritme) abans que sigui necessari tornar a adquirir-lo. Oscil·la entre 1 dia i 1 any. A més, el dret de consum no pot caducar i pot ser per sempre després de l'adquisició.
Fig. 6. Definició del temps d'espera de consum de actius durant la publicació (font: https://portal.agrospai.udl.cat)
Els instruments de definicions de directiva addicionals durant la publicació d'actius són les llistes de comptes permesos i denegats, com es mostra a Fig. 7. La llista de permesos defineix quins participants de l'espai de dades poden consumir explícitament el recurs (conjunt de dades o algoritme). Si la llista està buida, qualsevol pot descarregar o calcular aquest recurs. D'altra banda, si una adreça està a la llista de denegació, es denegarà la descàrrega o el càlcul d'aquest recurs per al participant del conjunt de dades corresponent.
Fig. 7. Definició de comptes permesos i denegats per al consum d'actius durant la publicació (font: https://portal.agrospai.udl.cat)
Finalment, també és possible editar un conjunt de dades existent configurat per al consum de "còmput" per definir els algoritmes individuals que poden executar-se en el conjunt de dades, com es mostra a Fig. 8. A més, els algoritmes permesos per a un conjunt de dades també poden ser personalitzats pel propietari del conjunt de dades utilitzant la comanda "edit-trusted-algos" de l'eina Pontus-X CLI.
Fig. 8. Definició d'algoritmes permesos per a un conjunt de dades per al consum de còmput (font: https://portal.agrospai.udl.cat)