用途：通过 ha3engine Python SDK 调用阿里云 OpenSearch 向量检索版，完成文档推送与 HA/SQL 搜索，适用于 RAG 和向量检索场景。仅覆盖 API/SDK 用法，不含控制台步骤。
必要用法：先安装 SDK，建议使用虚拟环境： python3 -m venv .venv . .venv/bin/activate python -m pip install alibabacloud-ha3engine
连接配置通过环境变量提供：OPENSEARCH_ENDPOINT、OPENSEARCH_INSTANCE_ID、OPENSEARCH_USERNAME、OPENSEARCH_PASSWORD、OPENSEARCH_DATASOURCE、OPENSEARCH_PK_FIELD。
主要能力：使用 push_documents 进行 add/delete 更新；HA 查询示例为 config=hit:5,format:json,qrs_chain:search&&query=title:hello&&cluster=general；SQL 风格搜索使用 models.SearchQuery(sql=...) 构造请求。
快速验证：python skills/ai/search/aliyun-opensearch-search/scripts/quickstart.py，可选参数 --cluster、--hit、--query，额外环境变量 OPENSEARCH_CLUSTER（默认 general）。
限制与注意：超过 30KB 的查询字符串应改用 RESTful 搜索 API；推送 4xx 需检查 schema 字段与 pk_field 是否匹配；认证错误需核对用户名密码及实例权限；5xx 建议退避重试。输出与证据保存至 output/aliyun-opensearch-search/，并在证据中记录关键参数以便复现。