SuperAPI AI 工具集

alibabacloud-tablestore-agent-storage

数据与分析

查看项目

更新于 10-15 19:55

技能介绍

用途:帮助用户使用 tablestore-agent-storage Python SDK 构建和管理 Tablestore 知识库,覆盖环境检查、SDK 安装、配置收集与持久化、知识库创建或连接、文档上传导入与检索,以及本地目录同步。

主要能力:创建、列出、查看知识库;上传本地文件、从 OSS 路径导入文档、查询文档状态、列出文档;支持混合检索(DENSE_VECTOR + FULL_TEXT,RRF 重排)、纯向量检索及元数据过滤;支持 subspace 逻辑分区隔离文档;支持自定义元数据字段。

使用方式:先确认 Python >= 3.8,安装 pip install tablestore-agent-storage==1.0.4(超时可加 -i https://pypi.tuna.tsinghua.edu.cn/simple)。分步收集凭据(默认凭据链获取临时凭证)、ots_endpoint、ots_instance_name,写入 tablestore_agent_storage/ots_kb_config.json。实例不存在时可用 tablestore_cli list_instance -r <region_id> 检查,并用 tablestore_cli create_instance -n <instance_name> -r <region_id> -d "Auto-created by Agent" 创建。需要本地文件或目录同步时再收集 OSS 配置,并授权 AliyunOTSAccessingOSSRole。同步脚本固定为 tablestore_agent_storage/sync_knowledge_base.py,缓存为 .sync_cache.json,可用 OpenClaw Cron 或系统 Crontab 定时执行。

限制:所有删除操作严格禁止,包括 delete_documents、delete_knowledge_base、delete_instance 等,即使用户明确要求也应拒绝并建议通过控制台或 CLI 手动处理。写入操作需幂等,当前写入 API 已幂等。ots_endpoint 必须为 http://ots-<region-id>.aliyuncs.com 格式。OSS 须与 OTS 同地域。不得索取明文 AK/SK,不得将配置文件放在项目根目录。