Semantic Ethical Glass Box (SEGB) documentation

This service is the SEGB API, a RESTful API designed to manage and query the SEGB system. The SEGB serves as a Semantic Ethical Glass Box for registering and managing the results of activities conducted by robots or intelligent agents interacting with humans. The API provides endpoints for:

• Logging and auditing activities data.

• Managing the SEGB graph, including retrieval, deletion, and querying.

• Retrieving activities-specific information and history.

Developed by

HumanAILab, managed by GSI-UPM

This Semantic Ethical Glass Box (SEGB) service is part of the HumanAILab, which is managed by the Grupo de Sistemas Inteligentes (GSI) at the Universidad Politécnica de Madrid (UPM).

Documentation Index

This documentation is organized into several sections, each covering different aspects of the SEGB API.

Contents:

• 1. AMOR Project
  • Funding
• 2. Introduction to SEGB
  • 2.1. Semantic model
  • 2.2. SEGB Pipeline
• 3. API Description
  • Authentication and Permissions
  • 3.1. GET /
  • 3.2. GET /health
  • 3.3. POST /log
  • 3.4. GET /log
  • 3.5. GET /graph
  • 3.6. DELETE /graph
  • 3.7. GET /experiments
  • 3.8. GET /history
  • 3.9. GET /query
  • 3.10. GET /docs
• 4. Deployment Tutorial
  • 4.1. Starting the SEGB locally
  • 4.2. Sending and Retrieving Data from SEGB GUI
  • 4.3. Sending and Retrieving Data from code
  • 4.4. Personalized logging
• 5. Generic Usage Tutorial
  • 5.1. Overview
  • 5.2. Auxiliary functions
  • 5.3. SEGB’s usage tutorial
• 6. AMOR-Specific Usage Tutorial
  • 6.1. Overview
  • 6.2. Motivational Scenario
  • 6.3. Use Case: Interaction Human-Robot
  • Auditing

Funding

Project funded by the Spanish Ministry for Economic Affairs and Digital Transformation and by the European Union - NextGenerationEU within the Programme UNICO I+D Cloud.