AILC History · GPT Actions

AILCHistory

AI Learning Companion for history

GET /personTimelineDisplay a timeline of events for a historical person and return curated factual data.
GET /getHistoricalCountriesByCurrentCountryAndYearGet the list of historical countries (kingdoms, empires) that used to exist in the area of the present day country in the given year.
GET /getWarsByHistoricalCountryAndYearGet the list of wars with their proper, recognizable name by the main actor historical country and the given year.
GET /warMapShow a map of a military conflict (e.g. a battle or a war). It also returns curated data about each battle. Pick and choose from this data as you see fit but don't overload the learner.
GET /historicalCountryMapDisplay a map of historical country (e.g. kingom, empire) in the given year.
GET /historicalContinentMapDisplay a historical map of a continent in the given year.
GET /getTimelineOfHistoricalPeriodsAndNotablePeopleGet a list of historical periods or eras for the given year ad a list of notable people alive at the time. It also returns an image of a timeline showing these periods.
GET /getHistoricalEventsgetHistoricalEvents
Finds a list of historical events and builds a graph of these events with the countries involved pointing at the events. Then returns the list of communities in this graph where each community is a list of vertices. This way we get a list of events with the countries involed in each one.
GET /getMilitaryConflictsgetMilitaryConflicts
Finds a list of wars and revolutions and builds a graph of these conflicts with the main actors involved pointing at the conflict. Then returns the list of communities in this graph. This way we get a list of wars and revolutions with the main actors involed in each one.

原始 API 定义

{
  "openapi": "3.1.0",
  "info": {
    "title": "AILCHistory",
    "description": "AI Learning Companion for history",
    "version": "v1.0.0"
  },
  "paths": {
    "/personTimeline": {
      "get": {
        "operationId": "personTimeline",
        "summary": "Display a timeline of events for a historical person and return curated factual data.",
        "responses": {
          "200": {
            "description": "OK"
          },
          "400": {
            "description": "The input was not recognized as a notable figure or historical person."
          }
        },
        "parameters": [
          {
            "name": "person",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ]
      }
    },
    "/getHistoricalCountriesByCurrentCountryAndYear": {
      "get": {
        "operationId": "getHistoricalCountriesByCurrentCountryAndYear",
        "summary": "Get the list of historical countries (kingdoms, empires) that used to exist in the area of the present day country in the given year.",
        "responses": {
          "200": {
            "description": "OK"
          },
          "400": {
            "description": "The input was not recognized properly. Check that the country is a valid country!"
          }
        },
        "parameters": [
          {
            "name": "currentCountry",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "year",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ]
      }
    },
    "/getWarsByHistoricalCountryAndYear": {
      "get": {
        "operationId": "getWarsByHistoricalCountryAndYear",
        "summary": "Get the list of wars with their proper, recognizable name by the main actor historical country and the given year.",
        "responses": {
          "200": {
            "description": "OK"
          },
          "400": {
            "description": "The input was not recognized properly. check that the country is a valid country!"
          }
        },
        "parameters": [
          {
            "name": "historicalCountry",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "year",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ]
      }
    },
    "/warMap": {
      "get": {
        "operationId": "warMap",
        "summary": "Show a map of a military conflict (e.g. a battle or a war). It also returns curated data about each battle. Pick and choose from this data as you see fit but don't overload the learner.",
        "responses": {
          "200": {
            "description": "OK"
          },
          "400": {
            "description": "The militaryConflict input was not recognized as a battle, war or other known military conflict."
          }
        },
        "parameters": [
          {
            "name": "militaryConflict",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "geoRange",
            "in": "query",
            "required": false,
            "schema": {
              "default": "Actors",
              "type": "string",
              "enum": [
                "Battles",
                "Actors",
                "World"
              ]
            }
          }
        ]
      }
    },
    "/historicalCountryMap": {
      "get": {
        "operationId": "historicalCountryMap",
        "summary": "Display a map of historical country (e.g. kingom, empire) in the given year.",
        "responses": {
          "200": {
            "description": "OK"
          },
          "400": {
            "description": "The input was not recognized properly. check that the historicalCountry is a valid name for a historical country, kingdom or empire.."
          }
        },
        "parameters": [
          {
            "name": "historicalCountry",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "year",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "geoRange",
            "in": "query",
            "required": false,
            "schema": {
              "default": "Automatic",
              "type": "string",
              "enum": [
                "Automatic",
                "Continent",
                "World"
              ]
            }
          }
        ]
      }
    },
    "/historicalContinentMap": {
      "get": {
        "operationId": "historicalContinentMap",
        "summary": "Display a historical map of a continent in the given year.",
        "responses": {
          "200": {
            "description": "OK"
          }
        },
        "parameters": [
          {
            "name": "year",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "continent",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "Europe",
                "Asia",
                "Africa",
                "NorthAmerica",
                "SouthAmerica",
                "Australia"
              ]
            }
          }
        ]
      }
    },
    "/getTimelineOfHistoricalPeriodsAndNotablePeople": {
      "get": {
        "operationId": "getTimelineOfHistoricalPeriodsAndNotablePeople",
        "summary": "Get a list of historical periods or eras for the given year ad a list of notable people alive at the time. It also returns an image of a timeline showing these periods.",
        "responses": {
          "200": {
            "description": "OK"
          }
        },
        "parameters": [
          {
            "name": "year",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ]
      }
    },
    "/getHistoricalEvents": {
      "get": {
        "operationId": "getHistoricalEvents",
        "description": "Finds a list of historical events and builds a graph of these events with the countries involved pointing at the events. Then returns the list of communities in this graph where each community is a list of vertices. This way we get a list of events with the countries involed in each one. ",
        "responses": {
          "200": {
            "description": "OK"
          }
        },
        "parameters": [
          {
            "name": "year",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "yearBack",
            "description": "When including historical events that happened close to the given year, how many years should we look back.",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "default": "1"
            }
          }
        ]
      }
    },
    "/getMilitaryConflicts": {
      "get": {
        "operationId": "getMilitaryConflicts",
        "description": "Finds a list of wars and revolutions and builds a graph of these conflicts with the main actors involved pointing at the conflict. Then returns the list of communities in this graph. This way we get a list of wars and revolutions with the main actors involed in each one. ",
        "responses": {
          "200": {
            "description": "OK"
          }
        },
        "parameters": [
          {
            "name": "year",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "yearBack",
            "description": "When including military conflicts that happened close to the given year, how many years should we look back.",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "default": "1"
            }
          }
        ]
      }
    }
  },
  "servers": [
    {
      "url": "https://f85fg3d940.execute-api.ca-central-1.amazonaws.com/prod"
    }
  ]
}