用途：该技能面向阿里云 OpenSearch 向量检索版，通过 Python SDK（alibabacloud-ha3engine）完成文档推送与检索，适合 RAG、向量检索等流水线，仅涉及 API/SDK 用法，不含控制台步骤。
主要能力：使用 push_documents 进行文档的 add/delete 更新；执行 HA 查询（支持向量与关键词混合检索，速度快、灵活）；执行 SQL 风格查询，便于处理结构化数据。
使用方式：建议在虚拟环境中安装 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（可选，默认 id）、OPENSEARCH_CLUSTER（可选，默认 general）。可用脚本快速开始：python skills/ai/search/alicloud-ai-search-opensearch/scripts/quickstart.py，支持可选参数 --cluster、--hit、--query。
限制与注意：超过 30KB 的查询字符串应改用 RESTful 检索 API；推送出现 4xx 需检查 schema 字段与 pk_field 是否对齐；认证错误需核对用户名/密码与实例访问权限；5xx 建议退避重试。验证方式为对脚本执行 python3 -m py_compile，命令退出码为 0 且生成 output/alicloud-ai-search-opensearch/validate.txt 即通过。产物、命令输出与 API 响应摘要应保存在 output/alicloud-ai-search-opensearch/ 下，并记录关键参数以便复现。