Metadata-Version: 2.5
Name: huaweicloud-opentelemetry-instrumentation-llama-index
Version: 1.0.1
Summary: Huawei Cloud standalone instrumentation for LlamaIndex agents, RAG and workflows
License-Expression: Apache-2.0
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.9
Requires-Dist: opentelemetry-api==1.39.1
Requires-Dist: opentelemetry-exporter-otlp==1.39.1
Requires-Dist: opentelemetry-instrumentation==0.60b1
Requires-Dist: opentelemetry-sdk==1.39.1
Requires-Dist: opentelemetry-semantic-conventions-ai>=0.5.0
Requires-Dist: wrapt<2.0.0,>=1.0.0
Description-Content-Type: text/x-rst

Huawei Cloud LlamaIndex Instrumentation
======================================

Huawei Cloud AgentArts standalone OpenTelemetry instrumentation for
LlamaIndex agents, RAG query engines and workflows.

The probe captures events via LlamaIndex's official callback mechanism
(``CBEventType.LLM`` / ``QUERY`` / ``RETRIEVE`` / ``SYNTHESIZE``) plus a
lightweight patch of ``agent.run()`` / ``query()`` / ``workflow.run()``
entry points to delimit agent turns, and reports Trace (APM) and
Metrics (AOM) to the AgentArts platform over OTLP gRPC.

Features
--------

- Zero-code integration via ``sitecustomize`` (``auto_instrument()``)
- Agent conversations, RAG query engines and workflows all covered
- Span tree aligned with Hermes: AGENT -> react step -> chat / execute_tool
- 16 metric instruments aligned with the AgentArts metric spec

Usage
-----

::

    from opentelemetry.instrumentation.huawei_llama_index import auto_instrument
    auto_instrument()

See ``LLAMA_INDEX_HISTORY.md`` for the design and development history.
