docs: refresh LoongSuite integration guides and fix util-genai standalone init (#159)

Author: Cirilla-zmh

CHANGELOG-loongsuite.md

@@ -17,11 +17,15 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   ([#155](https://github.com/alibaba/loongsuite-python-agent/pull/155))
 - **`loongsuite-site-bootstrap`**: initialize .pth-based OTel auto-instrumentation package
   ([#156](https://github.com/alibaba/loongsuite-python-agent/pull/156))
+- **Top-level docs**: add Chinese README (**`README-zh.md`**) translated from **`README.md`**.
+  ([#159](https://github.com/alibaba/loongsuite-python-agent/pull/158))
 
 ### Changed
 
 - **`instrumentation-loongsuite/*`**, **`loongsuite-distro`**, and **`util/opentelemetry-util-genai`**: `pyproject.toml` metadata and dependencies for standalone PyPI installs
   ([#155](https://github.com/alibaba/loongsuite-python-agent/pull/155))
+- **`loongsuite-site-bootstrap`**, **`loongsuite-distro`** docs: update **`README.md`**.
+  ([#159](https://github.com/alibaba/loongsuite-python-agent/pull/158))
 
 ## Version 0.2.0 (2026-03-12)
 

README-zh.md

@@ -25,6 +25,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   outermost wrapper
   ([#153](https://github.com/alibaba/loongsuite-python-agent/pull/153))
 
+### Changed
+
+- Update README integration flow to align with the root recommended LoongSuite pattern using Option C (`pip install loongsuite-instrumentation-agentscope`) and `loongsuite-instrument`.
+  ([#159](https://github.com/alibaba/loongsuite-python-agent/pull/159))
+
 ### Added
 
 - Add ReAct step span instrumentation for ReAct agents

README.md

@@ -1,6 +1,6 @@
-# OpenTelemetry AgentScope Instrumentation
+# LoongSuite AgentScope Instrumentation
 
-OpenTelemetry instrumentation for [AgentScope](https://github.com/agentscope-ai/agentscope) framework.
+LoongSuite instrumentation for [AgentScope](https://github.com/agentscope-ai/agentscope) framework.
 
 ## Features
 
@@ -13,24 +13,22 @@ OpenTelemetry instrumentation for [AgentScope](https://github.com/agentscope-ai/
 ## Installation
 
 ```bash
-pip install opentelemetry-distro opentelemetry-exporter-otlp
-opentelemetry-bootstrap -a install
+# Step 1: install LoongSuite distro
+pip install loongsuite-distro
 
-pip install agentscope
-
-# Install this instrumentation
-pip install ./instrumentation-loongsuite/loongsuite-instrumentation-agentscope
+# Step 2 (Option C): install this instrumentation from PyPI
+pip install loongsuite-instrumentation-agentscope
 
-# Note: This instrumentation uses ExtendedTelemetryHandler from opentelemetry-util-genai
-pip install ./util/opentelemetry-util-genai
+# Optional app dependency
+pip install agentscope
 ```
 
 ## Usage
 
 ### Auto-instrumentation
 
 ```bash
-opentelemetry-instrument \
+loongsuite-instrument \
     --traces_exporter console \
     --metrics_exporter console \
     python your_agentscope_app.py
@@ -62,7 +60,7 @@ export OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf
 export OTEL_EXPORTER_OTLP_TRACES_ENDPOINT=<trace_endpoint>
 export OTEL_EXPORTER_OTLP_METRICS_ENDPOINT=<metrics_endpoint>
 
-opentelemetry-instrument python your_app.py
+loongsuite-instrument python your_app.py
 ```
 
 ### Content Capture

instrumentation-loongsuite/loongsuite-instrumentation-agentscope/CHANGELOG.md

@@ -7,6 +7,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## Unreleased
 
+### Changed
+
+- Update README integration flow to align with the root recommended LoongSuite pattern using Option A (`loongsuite-bootstrap -a install --latest`) for this package not yet on PyPI.
+  ([#159](https://github.com/alibaba/loongsuite-python-agent/pull/159))
+
 ## Version 0.2.0 (2026-03-12)
 
 There are no changelog entries for this release.

instrumentation-loongsuite/loongsuite-instrumentation-agentscope/README.md

@@ -1,12 +1,16 @@
-# OpenTelemerty Agno Instrumentation
+# LoongSuite Agno Instrumentation
 
 Agno Python Agent provides observability for Agno applications. This document provides examples of usage and results in the Agno instrumentation. For details on usage and installation of LoongSuite and Jaeger, please refer to [LoongSuite Documentation](https://github.com/alibaba/loongsuite-python-agent/blob/main/README.md).
 
 ## Installation
 
 ```shell
-git clone https://github.com/alibaba/loongsuite-python-agent.git
-pip install ./instrumentation-loongsuite/loongsuite-instrumentation-agno
+# Step 1: install LoongSuite distro
+pip install loongsuite-distro
+
+# Step 2 (Option A): install instrumentations from LoongSuite release
+loongsuite-bootstrap -a install --latest
+# for specific version: loongsuite-bootstrap -a install --version X.Y.Z
 ```
 
 ## RUN
@@ -40,23 +44,7 @@ agent.print_response(
 
 ### Collect Data
 
-There are two ways to run the `demo.py` script with instrumentation:
-
-### Option 1: Using OpenTelemetry
-
-```shell 
-export OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT=true
-
-opentelemetry-instrument \
---exporter_otlp_protocol grpc \
---traces_exporter otlp \
---exporter_otlp_insecure true \
---exporter_otlp_endpoint YOUR-END-POINT \
---service_name demo \
-python demo.py
-```
-
-### Option 2: Using Loongsuite
+Use LoongSuite recommended runtime:
 
 ```shell 
 export OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT=true

instrumentation-loongsuite/loongsuite-instrumentation-agno/CHANGELOG.md

@@ -11,6 +11,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - Adapt imports to `opentelemetry-util-genai` module layout change
   ([#158](https://github.com/alibaba/loongsuite-python-agent/pull/158))
+- Update README integration flow to align with the root recommended LoongSuite pattern using Option C (`pip install loongsuite-instrumentation-crewai`) and `loongsuite-instrument`.
+  ([#159](https://github.com/alibaba/loongsuite-python-agent/pull/159))
 
 ### Added
 

instrumentation-loongsuite/loongsuite-instrumentation-agno/README.md

@@ -5,9 +5,11 @@ This library provides automatic instrumentation for [CrewAI](https://www.crewai.
 ## Installation
 
 ```bash
-git clone https://github.com/alibaba/loongsuite-python-agent.git
-cd loongsuite-python-agent
-pip install ./instrumentation-loongsuite/loongsuite-instrumentation-crewai
+# Step 1: install LoongSuite distro
+pip install loongsuite-distro
+
+# Step 2 (Option C): install this instrumentation from PyPI
+pip install loongsuite-instrumentation-crewai
 ```
 
 ## Usage

instrumentation-loongsuite/loongsuite-instrumentation-crewai/CHANGELOG.md

@@ -7,6 +7,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## Unreleased
 
+### Changed
+
+- Update README integration flow to align with the root recommended LoongSuite pattern using Option A (`loongsuite-bootstrap -a install --latest`) for this package not yet on PyPI.
+  ([#159](https://github.com/alibaba/loongsuite-python-agent/pull/159))
+
 ## Version 0.2.0 (2026-03-12)
 
 There are no changelog entries for this release.