Autonomous Relay System (ARS)

Back to Home

Description

The Autonomous Relay System (ARS) by the Link Brokers team for NCATS Biomedical Data Translator

The ARS is built by NCATS staff and relays translator queries from the user to the autonomous relay agents (ARAs) using an iterative process to generate results in the form of a knowledge graph that is then provided to the user.

The ARS:​

• Relays the query from the user to the ARAs​
• Uses an iterative process with the ARAs to generate the result in the form of a knowledge graph provided to the user​
• Decides which ARAs to invoke​
• Ranks and scores answers as being most correct/relevant to the user's query​

Team Contact:

Mark Williams

Interface

Access the public deployment at https://ars-prod.transltr.io/

Example query to submit a query to the ARS at https://ars-prod.transltr.io/ars/api/submit:

curl -H "Content-Type: application/json" --data @D.1-hgd-alkaptonuria.json https://ars-prod.transltr.io/ars/api/submit
{
  "model": "tr_ars.message",
  "pk": "18dda691-eef3-4670-bbf5-a6d5779b50b9",
  "fields": {
    "name": "",
    "code": 202,
    "status": "Running",
    "actor": 19,
    "timestamp": "2022-09-08T16:52:12.461Z",
    "data": {
      "message": {
        "query_graph": {
          "edges": {
            "e00": {
              "subject": "n00",
              "object": "n01",
              "predicates": [
                "biolink:related_to"
              ]
            },
            "e01": {
              "subject": "n01",
              "object": "n02",
              "predicates": [
                "biolink:related_to"
              ]
            }
          },
          "nodes": {
            "n00": {
              "ids": [
                "MONDO:0008753"
              ],
              "categories": [
                "biolink:Disease"
              ]
            },
            "n01": {
              "categories": [
                "biolink:NamedThing"
              ]
            },
            "n02": {
              "ids": [
                "NCBIGene:3081"
              ],
              "categories": [
                "biolink:Gene"
              ]
            }
          }
        }
      }
    },
    "url": null,
    "ref": null
  }

The ARS should return your query run ID:

{
  "model": "tr_ars.message",
  "pk": "81a75d1d-1223-4456-8927-734ad6b600fc",
  "...": ["..."]
}

Results of the query can be found in the ARS messages: https://ars-prod.transltr.io/ars/api/messages

The ARAX web interface can also be used to consult the result of your query:

1. Go to https://arax.ncats.io
2. Go to the <id> tab (in Query)
3. Copy the run ID previously obtained in the text box
4. Click on Load to see the detailed results of your query

You can also directly access your query result by providing the run ID with the id= URL param: https://arax.ncats.io/?source=ARS&id=YOUR_RUN_ID

External Documentation

• Documentation pages for the Autonomous Relay System (ARS) can be found here: https://github.com/NCATSTranslator/Relay
• Walk-through to query the ARS and retrieve results using the ARAX web interface: https://docs.google.com/document/d/1_a4gE_lY-2oZTrdFMtaZ_pxqNgd-x_1ZYI7hRGfFjng/edit
• Documentation on the TRAPI standard for messages: https://github.com/NCATSTranslator/ReasonerAPI/tree/master/examples/Message

Translator Components Registered with ARS

• ARAGORN/STRIDER (Ranking Agent)
• BTE (Exploring Agent)
• xARA (Explanatory Agent)
• Improving Agent (imProve Agent)
• Unsecret Agent
• Genetics Knowledge Provider
• Molecular Knowledge Provider
• CAM Provider
• Open Predict Provider
• Text Mining Provider
• ICEEs
• Clinical Data Knowledge Provider