Registry / llm-agents / loongsuite-util-genai

loongsuite-util-genai

JSON →
library0.4.0pypypiunverified

LoongSuite GenAI Utils is a utility package for generative AI workloads within the LoongSuite ecosystem. Version 0.4.0 is the latest, released as part of the loongsuite-python-agent distribution. The package provides utilities such as the RetrievalDocument dataclass for typed retrieval document representation. Release cadence follows the loongsuite-python-agent releases (currently every few months).

llm-agentsai-ml
pip install loongsuite-util-genai==0.4.0
github ↗package ↗
INSTALL
IMPORT
SIG · LOONGSUITE-UTIL-GE
L
loongsuite-util-genai
llm-agentspythonv0.4.0
harness data pending
Install & Compatibility
Where this runs

No compatibility data collected yet for this library.

Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

RetrievalDocument
✓ from opentelemetry import RetrievalDocument
✗ from loongsuite.util.genai import RetrievalDocument

Import and use RetrievalDocument dataclass. Adjust logging via environment variable.

from loongsuite.util.genai import RetrievalDocument from typing import Optional, Dict doc = RetrievalDocument( id="doc-123", content="This is a sample document.", score=0.95, metadata={"source": "example"} ) print(doc) # Enable verbose logging (optional) import os os.environ.get('LOONGSUITE_LOG_LEVEL', 'WARNING')
Debug
Known issues
breakingThe import path changed from underscore-based (loongsuite_util_genai) to dot-based (loongsuite.util.genai) starting in v0.3.0. Code using old imports will break.
fix
Update imports to: from loongsuite.util.genai import ...
affects: >=0.3.0
gotchaThe package is part of a larger distro; installing only loongsuite-util-genai may not include all dependencies needed for full functionality (e.g., OpenTelemetry integrations). Run loongsuite-bootstrap for complete setup.
fix
Run: pip install loongsuite-distro && loongsuite-bootstrap -a install
affects: all
deprecatedThe RetrievalDocument dataclass fields 'score' and 'metadata' were made optional in v0.4.0; previously they were required. Code relying on positional arguments may break.
fix
Use keyword arguments for optional fields: RetrievalDocument(..., score=0.95, metadata={})
affects: 0.4.0
Upgrade
Version history
0.4.0latest on PyPI · released Apr 3, 2026
Audit
Dependencies
loongsuite-distrorequiredRequired for full LoongSuite agent integration; install via loongsuite-bootstrap
Agent activity
12 hits · last 30 days
node
10
OpenAI (training)
1
Resources
githubhttps://github.com/alibaba/loongsuite-python-agent ↗
packagehttps://pypi.org/project/loongsuite-util-genai/ ↗
loongsuite-util-genai — pip install loongsuite-util-genai · libregistry