怎么给 Stuntman AI 写提示词

怎么给 Stuntman AI 写提示词 从一句话到一份能通过验证的设计

Stuntman AI 由 Anthropic Claude 驱动。你用文字描述实验,它写出 Python 设计脚本,再由 CONVERT 转成 RUN 能执行的 .stunt 文件。

软件界面是英文。下面每个灰框里,上面一行是中文意思,下面小字是原厂英文原文,可以直接复制。把名称、文件名、化学品和数值换成你自己的。方括号里的内容是占位,也要替换。

内容依据原厂 Stuntman AI Example Prompts User Guide 和 AI & CONVERT User Guide(均为 Rev A)。

想看一句提示词怎样变成设计脚本,见 Stuntman AI 体验的四个示例。

一次提一件事,按设计的结构依次提

原厂把提示词分成两类。一类是单一用途的短提示词,一句只让 AI 做一件事。另一类把几条短提示词串起来,完成一个完整实验。刚上手先用短提示词。

建设计时按这个顺序提:设计、化学品、样品库(板)、来源(source)、流程步骤。流程步骤包括分液、处理和检测。这是 AI 生成脚本时用的顺序,按它提,每条请求都落到脚本里该在的位置,来回追问最少。

信息不够时,AI 会追问,不会自己猜。它常问的是台面位置、载具类型、分液类别、用量和单位。你没写、它在 SystemConfiguration.xml 里也查不到的,它就会问。

在新会话里,第一句先问它看到的是哪套系统配置。换了一台没设计过的系统,更要先问。

新会话的第一句

你用的是哪个系统配置?你能做哪些事?

What system configuration are you using and what are your capabilities?

不想让 AI 替你做决定时,在任何请求末尾加一句「先问再改」。下面这条把逐孔操作改成整板操作,最后一句就是这个要求。

先问清楚再改

把这个设计改成整板操作,不再逐孔进行。比如先把整板开盖,再开始分液。改之前有不清楚的地方先问我,不要自己假设。

Modify this design to run full plate instead of well by well. For example, uncap the full plate before beginning any dispenses. Ask me any clarifying questions before making assumptions.

参数都想好了,也可以一条写全。换一个无关的任务,就开一个新会话。

单次响应的上限是 10 分钟。请求太大会超时报错,拆成几步再提。只要一个是或否、一个路径时,在提示词里写明「简短回答」。

只要简短答复

简短回答。

Briefly.

只确认路径,不用解释。

Just confirm the path, no explanation needed.

AI 也会出错。转换和运行之前,先看一遍它写的脚本,尤其是涉及硬件极限和化学品处理的部分。

建设计:每种操作对应一句提示词

新建设计时,AI 读取当前的系统配置,并问你脚本存在哪里。

新建设计

新建一个设计,命名为 MyExperiment。

Create a new design called MyExperiment.

化学品和来源

化学品只写名字就能开始。分子量、密度、浓度、类别、条码和 SMILES 可以在同一句里给,也可以之后补,或者让 AI 替你补。

添加化学品

添加化学品 Benzene。

Add chemical Benzene.

缓冲液这类由几种组分配成、各有浓度的溶液,作为一个混合物化学品添加。

添加多组分混合物

添加化学品 PBS Buffer,组成为 NaCl 137 mM、KCl 2.7 mM、Na2HPO4 10 mM、KH2PO4 1.8 mM。

Add a chemical called PBS Buffer made of NaCl 137 mM, KCl 2.7 mM, Na2HPO4 10 mM, and KH2PO4 1.8 mM.

化学品要先有来源,才能分液。AI 会问它是粉末还是液体,粉末必须放在 hopper 里。这一步可以不单独提:直接让它分液,它会先自动建好来源。

添加来源

给 Benzene 添加一个来源。

Add a source for Benzene.

通过阀和泵接入、不放在台面样品瓶里的液体,添加为台下(off-deck)来源。

添加台下来源

把水添加为台下 backsolvent 来源,接在阀位 2,按 500 mL 可用量记录。

Add water as an off-deck backsolvent source at valve position 2, tracking 500 mL available.

样品库和分液

样品库(板)写名字和行列数就能开始。

添加一块板

添加一块板 MyPlate,8 × 12。

Add a plate MyPlate 8x12.

只写「分液」时,AI 会逐项问用哪种工具、多大吸头、哪个分液类别、什么单位。第二种写法把这些一次给全,省掉这几轮问答。

分液

把 Benzene 分液到 MyPlate。

Dispense Benzene to MyPlate.

用 PDT 和 250 µL 吸头,按 Non-Viscous Liquid 分液类别,把 100 µL Benzene 分液到 MyPlate,并启用 SourceTracking。

Dispense 100 µL of Benzene to MyPlate using PDT with a 250 µL tip, Non-Viscous Liquid category, and enable SourceTracking.

板到板的转移用于梯度稀释或复制板,液体从一块板取,不从化学品来源取。

板间转移

把 Library A 转移到 Library B。

Transfer Library A to Library B.

处理和检测步骤

处理步骤可以是系统 Process Tools 里的任何操作,例如等待、设温度、暂停。检测步骤可以是 Analysis Tools 里的任何操作,例如称量、去皮、测量。

处理步骤

添加一个 5 分钟的等待。

Add a 5-minute delay.

暂停步骤带的是一段文字,不是数值。运行到这一步时,这段文字显示给操作人员。

带提示语的暂停

添加一个暂停步骤,提示语为「继续前请检查样品。」

Add a pause step with the message "Please check the sample before continuing."

检测步骤

添加一个去皮步骤。

Add a tare step.

系统配置里集成了 Stunner、Stunner AF 或 Lunatic 时,可以像其他检测操作一样加一步在线测量。

在线测量

在分液之后加一步 Stunner 浓度测量。

Add a Stunner concentration measurement after the dispense.

用 [设备] 测 [参数]。

Analyze for [parameter] using [equipment].

查系统能做什么

问台面位置时,AI 读的是 SystemConfiguration.xml,不按位置名称猜。名称看着合适的位置,未必支持这种载具。

查可用的台面位置

哪些台面位置支持 Rack 8x12 1mL Vial?

Which deck positions support a Rack 8x12 1mL Vial?

在一台没用过的系统上写流程之前,先问清楚它有哪些操作。

列出可用操作

这台系统上有哪些分液、处理和检测操作?

What dispense, process, and analytics operations are available on this system?

Liquid Dispense 有哪些吸头规格和分液类别?

What tip sizes and dispense categories are available for Liquid Dispense?

也可以让 AI 结合硬件推敲方案,不只照字面执行。

排步骤顺序

按这台系统上的工具,这三个处理步骤怎么排顺序最好?

What's the best way to sequence these three process steps given the tools on this system?

原厂示例:一条提示词分 10 步写全。先建 demo.py,定义 NaCl 和水的存放位置,建 4 × 6 样品瓶板;再逐瓶开盖、加样、加盖;最后加热并涡旋,在 Plan 中打开。截图取自原厂 AI & CONVERT 用户指南。

「Run the script」指 CONVERT,不是 RUN

三个程序各做一件事。对 AI 说「运行脚本」,它调用的是 CONVERT,生成 .stunt 文件并报告输出路径,仪器不会动。

程序:做什么

CONVERT:把 Python 脚本转成 .stunt 文件;也能验证 .stunt 文件

PLAN:打开 .stunt 文件,以图形界面查看和修改设计

RUN:在仪器上执行已经建好的 .stunt 文件

在 RUN 里打开 .stunt 文件之前,硬件上什么都不会发生。在 AI 和 PLAN 里反复修改,不会碰到仪器。

转换成 .stunt

运行脚本。

Run the script.

生成 .stunt 文件。

Generate the .stunt file.

把它转成 .stunt。

Convert this to .stunt.

验证时给出 .stunt 文件路径。一个文件里有多个设计时,还要写设计名。AI 做的检查和 CONVERT 的 Validate Stunt 页相同,分四个阶段。依次是 PLAN 的化学品和样品库规则、来源对应关系、流程步骤、整个设计。结果报通过或失败,并写明原因。

验证设计

验证这个设计。

Validate this design.

检查这个 .stunt 文件在我的系统上是否有效。

Check if this .stunt file is valid for my system.

下面这句可以接在任何建设计的提示词后面。它让 AI 自己修到验证通过,同时不许删步骤,最后在 PLAN 里打开给你看。

修到验证通过为止

逐步验证这个设计。验证失败就修改脚本,直到验证通过。过程中不要删掉任何流程步骤。完成后运行脚本,并在 Plan 中打开。

Work through validating the design. If validation fails, please fix the script to pass validation. Iterate until validation passes. Please do not remove any recipe steps in the process. When complete, run the script and open in Plan.

在 PLAN 中打开

在 Plan 中打开。

Open this in Plan.

改步骤名、调步骤顺序、改一个参数、核对台面分配和耗材体积,这类小改动直接在 PLAN 里改更快。AI 留给建设计、推敲方案和较大的修改。

注射剂稳定性筛选:先写整个流程,再逐条细化

配样、施加应力、检测,这种分几个阶段的生物药流程,原厂建议先用一条较长的提示词描述整体,再逐条细化。不必一开始就把每块板、每个约束都写全。下面四条按顺序在同一个会话里提。

原文提示词里有一句「Use Skip Map」,用来处理这台系统上执行不了的步骤。

第 1 条:描述整个流程

请帮我建一个注射剂稳定性流程设计,包括以下步骤:1)制剂配制:称量,粘稠溶液和水溶液的液体分液,加盖和开盖。2)处理:施加应力条件,如振荡、高温和冻融。3)检测:颜色、浊度、颗粒计数,以及在 Lunatic 上测 UV-Vis。系统上执行不了的步骤用 Skip Map 处理。

Please help me create a parenteral stability workflow design with the following steps: 1) Formulation prep with weighing, liquid dispense of viscous and aqueous solutions, capping/decapping. 2) Process with stress conditions like shaking, high temperature, and freeze-thaw. 3) Analyze for color, turbidity, particle count, and UV-Vis on Lunatic. Use Skip Map for any steps that cannot be run on the system.

第 2 条:调整板的布局

请做以下修改:先做一块母板,再按应力类型分出不同的子板(振荡/温度、冻融)。其中一些样品可以直接检测(如 pH 或 VIS),另一些需要取一份转到检测板上(如 Lunatic 板)。

Please make these changes: make one master plate and then create separate daughter plates for different types of stressing (shaking/temperature, freeze/thaw), and then some of those samples may be immediately ready for analysis (e.g. pH or VIS) while others will involve transferring an aliquot to an analytical plate (like Lunatic).

不同检测对样品瓶盖子的要求不同:在 VIS 站成像要加盖,测 pH 要开盖。把这条约束单独告诉 AI。

第 3 条:按检测类型加盖或开盖

在 VIS 站成像时,样品瓶必须加盖。测 pH 时,样品瓶必须开盖。请更新脚本体现这两点。最后,按实验方案的格式总结整个流程的每一步。

Vials must be capped for imaging in the VIS station. Vials must be uncapped for pH measurements. Please update the script to reflect this. Finally, summarize the step-by-step workflow like an experimental protocol.

AI 只按当前系统配置里有的设备写步骤。先在系统配置里加上 Lunatic,再让它补测量步骤。

第 4 条:更新系统配置后加测量

我已经在系统配置里加上了 Lunatic。现在能把 Lunatic 测量加进设计脚本吗?

I've updated the configuration to include Lunatic. Can you now update the design script to measure on Lunatic?

也可以把板的布局和检测对应关系合成一条。这条写明了转到 Lunatic 板的体积是 2 µL,AI 就不用再追问这个数。

另一种写法:一条写全

帮我建一个注射剂稳定性筛选流程的 Stuntman 设计。先做一块母板,再按应力类型分出不同的子板(振荡、温度、冻融)。然后检测:加盖的样品瓶做 VIS,开盖的样品瓶测 pH,取 2 µL 到 Lunatic 板上测 Lunatic。系统上执行不了的步骤用 SkipMap 处理。流程的所有步骤写完后,在 Plan 中打开设计。

Help me create a Stuntman design for parenteral stability screening workflow. Make one master plate and then create separate daughter plates for different types of stressing (shaking, temperature, freeze/thaw). Then analyze using VIS with capped vials, pH with uncapped vials and Lunatic by aliquoting 2 uL into a Lunatic plate. Use SkipMap for steps that cannot be run on the system. When done with all the steps for recipe, open the design in Plan.

在 PLAN 中打开后的样子,见 Stuntman 软件概览 里 PLAN 第 3 步的截图,那份注射剂稳定性设计就是 AI 生成的。

改已有脚本:写明文件名和要改的地方

不必每次从头写。指给 AI 一个已有脚本,说要改什么。它读取当前文件,把改动以 diff 形式列出来。

点 Accept,改动写进文件;点 Reject,改动丢弃,原文件不变。改动待定期间,AI 不直接改你的 .py 文件,而是写到旁边一个隐藏文件里做对比。

改一个数值

在 my_experiment.py 里,把 Benzene 的浓度改为 20 mM。

In my_experiment.py, change the Benzene concentration to 20 mM.

把 Chemical A 的分液体积增加 10%。

Increase the dispense volume for Chemical A by 10%.

加或删一步

在 my_experiment.py 里,第二次分液之后加一步 10 分钟的加热。

Add a 10-minute heating step after the second dispense in my_experiment.py.

从这个脚本里删掉去皮步骤。

Remove the tare step from this script.

换化学品或换板

把这个脚本里的 48 孔板换成 96 孔板。

Replace the 48-well plate in this script with a 96-well plate.

在这个设计里,所有用 Chemical A 的地方都换成 Chemical B。

Use Chemical B instead of Chemical A everywhere in this design.

脚本转换失败时,把 CONVERT 的报错贴进来或描述一下,并指明要改哪个脚本。

修复转换失败的脚本

这个脚本报错,提示缺少化学品名称,你能修好吗?

This script fails with a missing chemical name error, can you fix it?

扩展到更大的板型

把 coupling.py 扩展成 96 孔设计。

Extend coupling.py to a 96-well design.

在 Python Editor 里打开文件之前,会弹窗请你确认。删除文件之前也会弹窗。

打开脚本

在 Python Editor 中打开 C:\Stuntman\AI\optimization.py。

Open C:\Stuntman\AI\optimization.py in Python Editor.

设计跑通后,把脚本留作模板。下一个相似的实验,从「改这个脚本」开始,不用从空白写起。

从 .stunt 文件取数据:写明孔位和测量项

AI 能直接打开 .stunt 文件,查看里面的结构。先问文件里有什么,它会列出内部的 groups 和 datasets,再决定要取哪一项。

看文件里有什么

myplate1.stunt 里有什么?

What's in myplate1.stunt?

取设计信息

design_v2.stunt 用了哪些化学品和样品库?

What chemicals and libraries does design_v2.stunt use?

这个设计是为哪套系统建的?

What system was this design built for?

取结果时,写明孔位、测量项或设计名。问得越具体,答得越快、越可靠。

取某个结果

看一下 completed_run.stunt,告诉我 A1 孔的读数。

Look at completed_run.stunt and tell me the reading for well A1.

这次运行记录的最终浓度是多少?

What was the final concentration recorded in this run?

按列提取运行数据

帮我从「C:\Stuntman\AI\Demo.stunt」的运行数据里提取分液数据:Target Volume、Actual Volume、Target Weight、Actual Weight、Dispense Time (sec)、Source Name。

Help me extract dispense data (Target Volume, Actual Volume, Target Weight, Actual Weight, Dispense Time (sec), Source Name) from "C:\Stuntman\AI\Demo.stunt" from runtime execution.

同一类文件要反复取同一种数据时,让 AI 写一个脚本,以后每个新文件直接跑这个脚本。这样不用每次都让 AI 重新解析文件结构。

写一个可重复用的提取脚本

写一个 Python 脚本,从布局相同的 .stunt 文件里读出每个孔的最终 [数据]。

Write a Python script that reads the final [data] for every well out of a .stunt file with this same layout.

日常浏览、筛选和导出一次运行的结果,用 SHOW。

闭环优化从原厂示例脚本改起

闭环流程包括分液、运行、读结果、判断、调整、再运行,从空白脚本写起很难一次写对。原厂提供一套闭环示例脚本,用蔗糖水解反应演示整个流程。流程依次是加底物和酶、运行、读结果、判断是否达标、生成下一轮调整后的脚本。

手上没有这套脚本,可以联系 support@unchainedlabs.com。示例的运行结果见 闭环优化应用笔记。

开始改之前,另存一份没动过的原始示例。改坏了,可以回到一个能跑的版本重新开始。改写过程和其他脚本修改一样,每处改动都以 diff 列出,由你接受或退回。

换成你的实验

我有蔗糖水解的闭环示例脚本。请把它改成用 [你的化学品] 跑 [你的反应],整体循环结构保持不变。

I have the sucrose hydrolysis closed-loop example script. Adapt it to run [your reaction] with [your chemicals] instead, using the same overall loop structure.

换读数

这个脚本根据吸光度读数做调整。改成根据浊度读数调整。

This script adjusts based on an absorbance reading. Change it to use a turbidity reading instead.

改目标条件

修改目标条件:读数进入 [目标值] 的 5% 以内就停止调整,不必完全等于目标值。

Change the target condition so it stops adjusting once the reading is within 5% of [target], instead of exactly matching it.

改轮数上限

修改停止条件:跑满 5 轮就停,不管是否达到目标。

Change the stopping condition in this script so it stops after 5 iterations regardless of whether the target was reached.

  • biologics · 注射剂稳定性例子