Почему не работает пример quickstart из документации GLiNKER?

Question

[derasoft]

Взял код со страницы Quickstart из документации GLiNKER

from glinker import ProcessorFactory

# Create a simple entity linking pipeline
executor = ProcessorFactory.create_simple(
    model_name="knowledgator/gliner-bi-base-v2.0",
    threshold=0.5,
    entities=[
        {"entity_id": "Q101", "label": "insulin", "description": "Peptide hormone regulating blood glucose"},
        {"entity_id": "Q102", "label": "glucose", "description": "Primary blood sugar and key metabolic fuel"},
        {"entity_id": "Q103", "label": "GLUT4", "description": "Insulin-responsive glucose transporter in muscle and adipose tissue"},
        {"entity_id": "Q104", "label": "pancreatic beta cell", "description": "Endocrine cell type that secretes insulin"},
    ],
)

result = executor.execute({
    "texts": [
        "After a meal, pancreatic beta cells release insulin, which promotes GLUT4 translocation and increases glucose uptake in muscle."
    ]
})

l0_result = result.get("l0_result")
for entity in l0_result.entities:
    if entity.linked_entity:
        print(f"{entity.mention_text} → {entity.linked_entity.label}")
        print(f"  Confidence: {entity.linked_entity.score:.3f}")

Я ничего в нём не меняю, но при запуске приложения получаю следующее исключение:

Exception has occurred: AttributeError
'list' object has no attribute 'linked_entity'
  File "C:\work\test\linker.py", line 23, in <module>
    if entity.linked_entity:
       ^^^^^^^^^^^^^^^^^^^^
AttributeError: 'list' object has no attribute 'linked_entity'

Comments

[Wispik]

Смысл то вопроса в чем?
Почему не рабочий код в документации, надо спрашивать у того, кто её писал
Почему ошибка, все понятно написано. entity у тебя list. Вместо последнего if сделай print(entity) и увидишь что там находится
UPD: ну и проверь последняя ли версия библиотеки установлена

[derasoft]

Я подумал, что вдруг найдётся какой-то знающий человек, который работал с библиотекой и который скажет что-то в духе "да, они поменяли список параметров такого-то объекта, а документацию уже полгода не могут обновить, просто сделай вот так вот."

Answer 1

[Пума Тайланд]

похоже баг в доках, а не в твоём коде. l0_result.entities в текущей версии — List[List[L0Entity]], список сущностей на каждый входной текст. В цикле for entity in l0_result.entities entity — это сам список, а не сущность, отсюда и AttributeError. Для одного текста бери entities[0]. И заодно у linked_entity поле называется confidence, а не score — в квикстарте на доке тоже не поправили.