how to 1 document and many aspects

[kibarik]

I saw most examples are built for “1 document = 1 aspect,” but in my case I need to get many aspects from one document (like a chat with several different agreements). Each aspect would have a bunch of concepts inside.

So, my structure is:
1 document = many aspects (and each aspect = a set of concepts).

Could you please explain how to set this up in ContextGem? Is there a recommended way to extract multiple aspects from one document, or maybe some options/tricks I should know?

Any example or tips for building this kind of pipeline would be super helpful. Thanks again for your cool tool!

Best,
Aleks Ishmanov

[SergiiShcherbak]

Aspects API supports multiple concepts within a single Aspect instance. You can simply assign a list of your concepts to an Aspect and then run llm.extract_all(...). You can see an example here: https://contextgem.dev/advanced_usage/#extracting-aspects-containing-concepts

Please note that "vision" concepts (i.e. concepts with llm_role="extractor_vision" or llm_role="reasoner_vision") are not supported within aspects, since such concepts will be extracted from the aspect context which is text-only.

[kibarik]

Found it:

print(f"Extracted {len(doc.aspects[0].extracted_items)} items from the aspect")

[SergiiShcherbak]

And multiple aspects extraction is of course also supported: https://contextgem.dev/advanced_usage/#extracting-aspects-and-concepts-from-a-document