Системные справочники в Graph

Обновлено 28 апреля 2025

Graph

Статичные сущности мы называем справочниками, потому что они не меняются со временем. Например, города, страны или имена людей. На странице Сущности в редакторе вы можете скачать файлы этих справочников, чтобы увидеть, какие сущности входят в эти справочники.

При работе вам может понадобиться информация о том, как работать сразу с несколькими одинаковыми сущностями и как извлекать значения из сущностей.

$CITY

Эту сущность можно использовать, чтобы извлечь из реплики пользователя какой-либо город мира. Например, если в примерах реплик указать

Я живу в $CITY

то проект будет реагировать на реплики, в которых пользователь называет город проживания. При этом проект создаст переменную $CITY, в которой сохранит объект со следующими полями:

• name — название города в именительном падеже;
• lat — широта;
• lon — долгота;
• country — код страны;
• continent — континент;
• timezone — часовой пояс;
• population — численность населения;
• capital — столица или нет.

Например, если пользователь в нашем примере скажет «Я живу в Москве», то проект создаст переменную $CITY со значением:

{
    "name": "Москва",
    "lat": 55.75222,
    "lon": 37.61556,
    "country": "RU",
    "timezone": "Europe/Moscow",
    "population": 10381222,
    "capital": "true",
    "continent": "Europe"
}

$CAPITAL

Эту сущность можно использовать, чтобы извлечь из реплики пользователя какое-либо название столицы. При этом проект создаст переменную $CAPITAL, в которой сохранит объект со следующими полями:

• name — название города
• country — название страны
• genCountry — название страны в родительном падеже
• continent — название континента
• continent_part — название части света
• duplicateName — «true», если название столицы совпадает с названием страны, иначе «false»
• facts — факт или набор фактов о стране, массив может быть пустым
• complexity — уровень сложности (от «1» до «5»), который определяет, насколько легко отгадать столицу

$COUNTRY

Все страны мира. Если в реплике пользователя есть страна, то проект создаст переменную $COUNTRY со следующими полями:

• name — название страны в именительном падеже;
• currency — валюта страны.

$NAME

Эта сущность позволяет извлечь из реплики пользователя самые популярные имена собственные. Если в реплике пользователя есть имя, то проект создаст переменную $NAME с полями:

• name name — имя;
• full full — полное имя;
• diminutive — уменьшительно-ласкательное;
• sex — пол (строка «м» или «ж»).