Skip to content

README.adoc

Latest commit

 

History

History
74 lines (54 loc) · 2.75 KB

README.adoc

File metadata and controls

74 lines (54 loc) · 2.75 KB
Raw

NER Ambiverse

Table of Contents

Intention

Receives a textual question recognizes named entities and stores them.

Behavior

Comment: This component does the same thing as the corresponding NED, but just saves not all the information. Ambirverse API is no longer maintained. A new local endpoint should be established https://github.com/ambiverse-nlu/ambiverse-nlu

As a Qanary component, it reads the question and the annotations produced by upstream components from the Qanary triplestore (the shared process memory), performs its task — recognise (spot) named-entity mentions in the question text — and writes the result back as standard Qanary (Web Annotation / qa:) annotations. See Input specification / Output specification below for the exact annotation contract.

Characteristics

Implementation

  • Language: Java (JDK 21).

  • Major frameworks: Spring Boot 3.5 (spring-boot-starter-parent); the Qanary component framework eu.wdaqua.qanary:qa.component 4.0.0 (transitively Spring Boot Admin client + Apache Jena 5).

  • Main component class: src/main/java/eu/wdaqua/qanary/component/ambiverse/ner/AmbiverseNER.java (extends eu.wdaqua.qanary.component.QanaryComponent).

  • Tests: 2 test class(es) under src/test/java/ (QanaryServiceControllerTest.java, SwaggerUiAvailabilityTest.java).

Build and run

Targets the current Qanary framework 4.0.0 (Spring Boot 3, Java 21). Install the framework first (mvn install in the Qanary repository), then build with JDK 21:

JAVA_HOME=/path/to/jdk21 mvn clean package
docker build --build-arg JAR_FILE=target/qanary-component-ner-ambiverse.jar -t qanary/qanary-component-ner-ambiverse .

Input specification

Not applicable as the textual question is a default parameter

Output specification

Comment: no score in the output

@prefix qa: <http://www.wdaqua.eu/qa#> .
@prefix oa: <http://www.w3.org/ns/openannotation/core/> .

<urn:qanary:output> a qa:AnnotationOfInstance .
<urn:qanary:output> oa:hasTarget [
    a   oa:SpecificResource;
        oa:hasSource    <urn:qanary:myQanaryQuestion> ;
        oa:hasSelector  [
            a oa:TextPositionSelector ;
            oa:start "0"^^xsd:nonNegativeInteger ;
            oa:end  "5"^^xsd:nonNegativeInteger
        ]
    ] .
<urn:qanary:output> oa:annotatedBy <urn:qanary.NED#Ambiverse> ;
    oa:annotatedAt "2001-10-26T21:32:52"^^xsd:dateTime .