SuperAPI AI 工具集

lancedb-connect

数据与分析

查看项目

更新于 10-15 23:48

技能介绍

用途:在发起 LanceDB REST 请求前,确定每次请求都需要的两个要素——基础 URL(端点)以及请求头(x-api-key,通常还有 x-lancedb-database)。

解析步骤:若用户已提供 URL 和 API 密钥,或已说明所针对的环境,则直接使用。否则查找环境中已有的凭据,例如 LANCEDB_URI、LANCEDB_HOST、LANCEDB_API_KEY 等环境变量,或本地已运行/已端口转发的 LanceDB 端点(REST 默认端口为 2333,即 http://localhost:2333)。若未同时找到 URL 和密钥,应直接询问用户端点 URL 与 API 密钥;若数据库不明确,也需一并询问,不应猜测或进一步探测。

验证连接:发起一个成本较低的带认证请求并检查状态码,例如: curl -s -w "\n%{http_code}" "{base_url}/v1/table/?limit=1" -H "x-api-key: <key>" -H "x-lancedb-database: <database>" 其中 200 表示连接、密钥和数据库请求头均正常;401 表示 API 密钥缺失或错误;400 且提及数据库请求头,说明该部署需要 x-lancedb-database。

非 REST 等价用法:若调用方更倾向 SDK 或 CLI,同一组凭据同样适用。Python SDK:lancedb.connect("db://<database>", api_key="<key>", host_override="<base_url>")。lancedb CLI:在 ~/.lancedb/config.toml 中添加 [profiles.<name>] 条目,包含 http_server_url、api_key、database。

适用场景:需要以 REST 方式连接 LanceDB 部署前准备凭据和验证连通性。限制:资料未提供收费、价格、平台支持范围等其他信息。