Интеллектуальные возможности > Сервисы Directum Ario > Описание API Ario > Отладка грамматик

В поставку сервисов Directum Ario входят:

•базовые грамматики, полнота извлечения фактов для которых составляет 80% и выше;

•дополнительные грамматики, полнота извлечения для которых может быть ниже 80%.

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

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

Синтаксис

POST {service_url}/api/factextractor/grammar
{
"name": "Наименование грамматики",
"description": "Описание грамматики"
"grammarSetName": "Наименование грамматики, указанное латиницей",
"state": "Статус грамматики после создания",
}

Параметры

•name – наименование грамматики. Соответствует виду документов, для которого она создается. Указывается кириллицей;

•description – описание грамматики;

•grammarSetName – наименование грамматики для обращения к API Smart Service в других HTTP-запросах. Указывается латиницей без пробелов;

•state – статус грамматики. Возможные значения: 0 – неактивная (недействующая), 1 – активная (действующая). Рекомендуемое значение – 1.

Пример запроса

POST http://smart:61100/api/factextractor/grammar
{
"name": "Служебные записки",
"description": "Служебные письма сотрудников наших оргаизаций"
"grammarSetName": "Memo",
"state": 1,
}

Ответ

Содержит основную информацию о созданной грамматике.

Далее в примере ответа параметры, выделенные полужирным шрифтом, принимают значение null, так как грамматика создается с нуля и модель извлечения фактов для нее еще не обучена и не опубликована.

{
"grammarId": 20,
"name": "Служебные записки",
"description": "Служебные письма сотрудников наших организаций",
"grammarSetName": "Memo",
"isSystem": false,
"state": 1,
"factExtractorModelId": null,
"factExtractorModel": null,
"factExtractorModels": null,
}

Где:

•grammarId – ИД созданной грамматики;

•name – наименование грамматики, соответствующее виду документов, для которого она создается. Значение параметра берется из запроса;

•description – описание грамматики. Значение параметра берется из запроса;

•grammarSetName – наименование грамматики для обращения к API Smart Service в других HTTP-запросах. Значение параметра берется из запроса;

•state – статус грамматики. Значение параметра берется из запроса;

•isSystem – признак того, что грамматика базовая. Возможные значения: true – грамматика из поставки, false – грамматика создана пользователем;

•factExtractorModelId – ИД активной модели извлечения фактов;

•factExtractorModel – информация об активной модели извлечения фактов;

•factExtractorModels – другие модели извлечения фактов, обученные для грамматики.