Cadence JedAI + ChipStack 从零安装配置教程(含 Module 环境与 cli_config.yaml 实战)

Source

本文流程基于 Cadence 官方文档整理:《JedAI Platform Installation Quick Start Guide》(Product 26.13)与《ChipStack User Guide》(Product Version 2.1/2.2)。第五、六两节的 Module 环境与 cli_config.yaml 配置,节选自一套实际在用的环境(ChipStack 2.2.0 + JedAI 26.14.001,Ubuntu 24.04),IP 与用户名已替换为占位符。文中流程示意图为自制,界面截图均来自作者自己部署的环境;具体下载入口、License 服务器地址以你公司与 Cadence 的商务协议及内部流程为准。

一、先把关系搞清楚:ChipStack 和 JedAI 是什么

很多新手第一次接触这两个名字时会犯迷糊:装 ChipStack 为什么要先装 JedAI?

一句话版本:ChipStack 是面向芯片设计与验证任务的"多智能体协作平台",而 JedAI 是它脚下的"Agentic AI 基础设施"——模型接入、RAG 检索、鉴权、会话管理都由 JedAI 提供。官方文档的原话是:ChipStack 与所有 Cadence Agentic 解决方案一样,依赖(relies on)JedAI。所以安装顺序必须是:先 JedAI,后 ChipStack。

ChipStack 在 Cadence Agentic AI 体系中的位置

从分层图可以看到,ChipStack 处于"Super Agents"这一层,向下调用 JedAI Platform,JedAI 再对接底层的大模型(LLM)、重排序(Re-Ranking)和向量嵌入(Embedding)服务。理解了这个结构,后面每一步"为什么这么做"就顺理成章了。

二、安装前的准备清单

动手前先核对这张表,缺一项都会在后面卡住:

检查项 要求 说明
操作系统 RHEL 8.6 / Rocky Linux 8.6+ / Alma Linux 8.6+ / SLES 15 SP3+ 官方支持平台;Ubuntu 24.04 实测可用,但需要 OpenSSL 1.1 shim(见第五节)
JedAI Platform 已安装且可访问 文档版本 26.13;本文实测环境为 26.14.001,流程一致
License CPSTCKBASE(ChipStack AI SuperAgent Annual Base) ChipStack 的 License Feature,有效期默认 365 天;JedAI 侧还有 JEDAI100/200/250/260/300 系列feature,见第五节对照表
JedAI 登录账号 一个可用的 username config init 时要填
安装包 JedAI 安装包 + ChipStack 安装包 从 downloads.cadence.com 按公司流程获取

提示一:官方文档把配置目录变量写作 CHIPstack_HOME(混合大小写),而我们实际的 modulefile 里设置的是全大写 CHIPSTACK_HOME=~/.chipstack_personal。不设置时默认 ~/.chipstack。如果是多人共用的服务器,务必给每个人设置独立目录,避免配置互相覆盖;配好后用 echo $CHIPSTACK_HOME 确认到底生效的是哪个名字。

提示二:如果公司服务器用 Environment Modules 管理工具(module avail 有输出),ChipStack/JedAI 的 PATH 和环境变量不要自己 export,直接走 modulefile——第五节给了一份可以照抄的真实配置。

三、第一步:安装 JedAI 平台

JedAI 的安装一共 7 步,全部在 Linux 终端完成:

JedAI 安装 7 步

对照上图,逐条解释每条命令在做什么:

# 1. 从 downloads.cadence.com 下载安装包(需企业账号)

# 2. 指定运行时数据目录(必设)——会话、索引等数据都放这里
export JEDAI_DATA_DIR=/path/to/data

# 3. 解压安装包到安装目录
tar -xvf jedai-<version>.tar -C <installation-directory>

# 4. 把 jedai 命令加入 PATH
export PATH=<installation-path>/jedai/bin:$PATH

# 5. 启动全部 JedAI 服务
jedai start

# 6. 检查服务状态与健康探针
jedai status

# 7. 打开终端输出的 Gate URL

验证标准(三条都满足才算过了这一关):

  1. jedai status 显示所有服务 active;
  2. 浏览器能打开终端打印的 Gate URL 并成功登录;
  3. 平台里能看到可选择的模型列表。

第 2 条的实机样子——浏览器打开 Gate URL 后就是 JedAI 的登录页,输入账号密码进入:

JedAI Gate 登录页:本机部署地址为 127.0.0.1:8080,共享部署换成服务器地址即可

第 3 条:登录后进入 Chat 主界面。真正值得看的是右侧 Chat Settings 面板,一眼能核对四件事——LLM 模型、流式开关、知识库检索(USE KNOWLEDGE)与重排序(RERANKING)、外部 MCP 开关。这四项与第六节 cli_config.yaml 里的 jedai.model / rag / mcp_enabled 一一对应:

JedAI Chat 主界面与右侧 Chat Settings 面板:模型、流式、知识库检索、重排序、MCP 开关都在这里

比"模型列表"更值得盯的是 My Provider Keys 页面。LLM / Embedding / Re-ranking 三类模型各自列出了 Policy(Optional / Required)与 Key Status:

My Provider Keys 页面:LLM、Embedding、Re-ranking 三类模型的 key 策略与状态

看这张图抓两个要点:

  • Required + Not set 的模型不能选:策略标记为 Required 且 key 状态是 Not set 的模型,选它做默认模型会直接不可用;Optional 的模型由平台侧统一供 key,个人不设也能用。
  • Embedding 和 Re-ranking 是 RAG 的底座:这两个没就绪(截图里已显示绿色 ✓ Credentials set),后面 cli_config.yaml 里的 RAG 参数调得再精细也检索不出东西。

进阶用户可以再用 AAI 命令行做一次全面体检:aai health-check --full(测试所有模型、产品与嵌入服务),或 aai model list --url <jedai-url> 确认模型已就绪。

几个常用的服务管理命令,建议顺手记下:jedai stop(优雅停止)、jedai restart(改完配置后干净重启)、jedai -V(看版本)。

四、第二步:chipstack config init——一条命令完成绑定

ChipStack 本体的"安装"非常简单,核心是 config init 这条交互式命令。它会一口气帮你完成六件事:

chipstack config init 的六个步骤

执行过程是问答式的,你只需要准备好两样东西:用户名和 JedAI 的 URL(就是上一步浏览器里打开的 Gate 地址):

# 设置配置目录(可选,不设则默认 ~/.chipstack)
export CHIPstack_HOME=~/.chipstack

# 交互式初始化
chipstack config init

命令会依次:询问 username → 询问 JedAI URL → 首次访问触发登录(身份方式由 JedAI 侧的 JEDAI_AUTH_BACKEND 决定,比如 LDAP)→ 列出可用模型让你选一个默认模型 → 把 Seed Skills 安装到 $CHIPstack_HOME/skills → 生成初始配置文件。

初始化完成后,$CHIPstack_HOME/cli_config.yaml 里的核心结构长这样:

username: "your username"
jedai:
  connection:
    server: https://jedai-url:<port>
    provider