SuperAPI AI 工具集

datalens-sdk

数据与分析

查看项目

更新于 10-15 20:33

技能介绍

用途:通过官方 Python 包 datalens-sdk 驱动 Yandex DataLens 实体,进行自动化操作,不手写 HTTP 请求。适用于在 Python 中创建或管理 DataLens 对象的任务。

前置条件:本技能依赖名为 datalens(或命名空间 basename 为 datalens)的可用技能,提供共享的安装与对象模型上下文;若缺失,应说明 DataLens 公共技能安装不完整并停止。本技能的指令存放于已安装的 datalens-sdk 包内,需先从包中加载,不能凭猜测编写代码。

使用方式:首次操作前,将本包装技能目录解析为绝对路径,并在用户项目目录运行引导脚本:bash "/absolute/path/to/datalens-sdk/scripts/bootstrap.sh"。脚本按 uv/Poetry 项目、./.venv 的顺序解析环境,仅在非托管项目下创建 ./.venv,并校验所选解释器归属。解析 ---BOOTSTRAP--- 后的 KEY=VALUE:STATUS=ready 时使用 PYTHON 的绝对解释器;STATUS=decision_required 时按 REASON 处理,例如 sdk_install_required 需经用户同意后运行 bash ".../bootstrap.sh" --install-sdk;sdk_update_available 需告知已安装版本与可用新版本并询问是否升级,同意后运行 bash ".../bootstrap.sh" --upgrade-sdk "$AVAILABLE_SDK_VERSION";STATUS=blocked 时转达 REASON,不擅自改用其他安装命令。

准备就绪后,用报告的解释器运行 "$PYTHON" -c "import datalens_sdk; [print(p) for p in datalens_sdk.agent_skill_paths()]",得到若干绝对路径,先读取第一个路径中的 SKILL.md 并遵照执行,按需读取其指向的 references。不得 cd 进入这些目录。

范围与限制:驱动 DataLens 实体的 Python 任务属于本技能;由 DataLens 渲染的独立 HTML 页面与报告属于 datalens-html-pages;通过 SDK 发布或管理 HTML 页面则按包内指令执行。DataLens Web UI、截图、嵌入及指标解读不在范围内。SDK 为 0.x alpha,小版本可能重命名类与方法,应以包内指令为准;写入文件只写用户项目目录或临时目录。