CLI for AI Agents

为 Agent 准备的专病库

为 AI Agent 与自动化脚本准备的专病库命令行接口:患者 360、查询引擎、电子表单、文档中心,一条命令即刻访问;配合 Skill 包,让 WorkBuddy 等 Agent 直接读懂并操作专病库。

Agent-Ready Database

Agent 可直接读写的数据底座

专病库不只是给人用的界面,更是为 Agent 准备的结构化数据底座:患者数据、表单定义、查询引擎全部以机器可读的方式对外开放。

输出即上下文

所有查询支持 JSON / Markdown / 表格输出,结果可直接进入 LLM 上下文,无需二次解析页面或截图。

患者 360 一条命令

ivycli patient view360 输出患者全景 Markdown:诊疗、手术、检验检查、随访全病程一次整合。

BigQuery 高级查询

浏览查询字段树、按表达式自定义筛选研究队列,Agent 可自主构建多条件检索。

表单 Schema 机器可读

电子表单的字段定义、选项、取值约束经 CLI 完整输出,Agent 依此生成提取代码或自动填表。

AI 数据治理与文档中心

AI 数据治理任务列表查询、任务 XML 下载、原始病历文档下载,为代码生成与质检 Agent 提供原料。

API Key 自动化认证

API Key 登录、环境变量传参,适合脚本与 Agent 无人值守运行;权限与人的账号体系一致。

装上 Skill,Agent 就是专病库的原生用户。

Use Cases

Agent 结合专病库能做什么

三类典型场景:把重复、繁琐、需要严格流程的科研工作交给 Agent,由 IvyCLI 提供数据通道,Skill 包提供标准作业流程。

场景一 · 结构化提取代码生成

CodingAgent Skill 驱动 Agent 自动下载 AI 数据治理任务 XML 与病历原文,对照电子表单 Schema 逐阶段生成 Python 提取代码,并与 AI 提取结果做字段级对齐评估、迭代优化直至达标。

  • 自动获取任务、文档与表单定义
  • 9 阶段提取代码生成与评估
  • Git 版本管理,可回滚可审计

场景二 · 研究队列筛选

Agent 根据自然语言研究需求,先浏览 BigQuery 字段树、搜索目标字段,再组装表达式筛选队列:「年龄大于 60 岁的男性 PCI 术后患者」一条命令即成队列。

  • 字段树浏览与关键词搜索
  • 表达式多条件组合筛选
  • 结果可直接导出供统计分析

场景三 · 数据集统一检索

dataset Skill 提供「发现数据集 → 查看 Schema → 统一检索」的固定三步工作流,内置库、专病库数据集、PubMed 文献与外部结构化数据集同一入口查询。

  • Google / SQL 双语法查询
  • 跨数据集关联分析
  • S3 预签名链接交付结果文件
# 一次真实的 Agent 会话(队列筛选场景) $ ivycli module query "冠心病" → 匹配到专病库:冠心病数据库(moduleId: module_coron) $ ivycli bigquery search module_coron 年龄 → 命中字段:age(年龄)、ageGroup(年龄分组)… $ ivycli bigquery query module_coron -e "age > 60 AND gender = '男'" -f name,age,gender,opDate → 命中 128 例,返回前 50 例(truncated: true) $ ivycli patient view360 12345 module_coron -f markdown # 患者 360 视图 · 张×× 男 · 58 岁 ## 最近就诊 2026-08-12 · 心内科 ## 最近检查 冠脉 CTA · 2026-08-10
Download & Install

五分钟完成安装与登录

IvyCLI 以 npm 包形式分发,Node.js 18 及以上环境即可运行;院内私有化部署时,将 host 指向院内服务地址即可。

  • 安装包也可在下载页获取
  • API Key 在系统「个人中心」中生成
  • 配置文件存于 ~/.ivycli/

安装与快速开始

# 1. 下载安装包 curl -O https://www.aiyikeyan.com/download/cli/ivycli-1.0.0.tgz # 2. 全局安装(也可直接 npm install -g <下载地址>) npm install -g ./ivycli-1.0.0.tgz # 3. 配置 API 地址(私有化部署请填写院内地址) ivycli config set host https://api.aiyikeyan.com # 4. 使用 API Key 登录 ivycli user login -k <your-api-key> # 5. 验证连接与身份 ivycli config test && ivycli user me
Skills for Agents

配置 Skill,让 WorkBuddy 等 Agent 直接操作专病库

Skill 包把专病库的使用方法写成 Agent 可读的固定工作流(SKILL.md)。装入 WorkBuddy 等支持 Skill 机制的 Agent 后,Agent 会按标准流程自动调用 IvyCLI 与开放接口,无需逐条指示。

安装并登录 IvyCLI

按上一节完成安装,确认 ivycli user me 能正常返回身份信息。

获取 Skill 包

Skill 包(dataset、codingagent 等)随安装交付提供,或联系产品专家获取最新版本。

放入 Agent 的 skills 目录

将 Skill 目录复制到 WorkBuddy 等 Agent 的 skills 目录,Agent 启动时自动加载。

配置 API Key

设置 IVY_API_KEY 环境变量,Agent 即可在 Skill 指引下无人工干预地调用专病库。

目录结构示例

# 以 WorkBuddy 为例,其他 Agent 的 skills 目录同理 ~/.workbuddy/skills/ ├── dataset/ │ └── SKILL.md # 数据集统一检索:list → schema → query └── codingagent/ └── SKILL.md # 结构化提取代码生成固定工作流 # 环境变量(写入 shell 配置或 Agent 运行环境) export IVY_API_KEY=sk-xxxxxxxx

内置 Skill 一览

  • dataset — 数据集统一检索:数据集发现、Schema 查看、双语法查询
  • codingagent — 专病库结构化提取代码生成与迭代评估
  • 更多 Skill(随访、队列、知识库等)随版本持续发布

除 Skill 外,专病库还内置 MCP Server(ivy-mcp),支持 MCP 协议的 Agent 可免安装直接接入工具能力。

让您的 Agent 用上专病库