--- name: chemvision description: 当用户询问化学相关问题时使用此技能——包括化学品名称、分子结构（SMILES）、分子式、分子量、安全信息（GHS 危险性）或化学反应预测。支持中英文化学名称、IUPAC 名称及常用名。调用 PubChem 和 OPSIN 真实化学数据库，显著降低 LLM 幻觉风险。返回分子结构图像与化学方程式渲染结果。 metadata: skill_version: "3.3.0" tags: ["AIPC", "chemistry", "agent", "tool-calling", "pubchem"]

ChemVision AI 化学家

化学数据查询服务 — 基于 PubChem + OPSIN 真实数据库，支持分子结构图生成与化学方程式渲染。

适用场景

• 化学品查询（名称 → 结构、SMILES → 信息）
• 安全信息 / GHS 危险性说明
• 化学反应预测（由 Agent 给出答案，工具提供底层数据）
• 分子结构图像渲染

步骤 0：确认服务正在运行

cd {this_skill_dir} && python manage.py status

端口说明：默认端口为 8899。若被占用，服务将自动选择下一个可用端口（8900、8901…）。执行 python manage.py status 可查看实际使用的端口。该服务使用环境变量 CHEMVISION_PORT（而非 SERVER_PORT）以避免与 Agent 主进程发生端口冲突。

如未运行，请执行：python manage.py start
停止服务请执行：python manage.py stop

步骤 1：调用工具

向 http://localhost:8899/api/tools/call 发送 POST 请求。

name_to_structure

curl -s -X POST http://localhost:8899/api/tools/call 
  -H "Content-Type: application/json" 
  -d '{"tool_name":"name_to_structure","arguments":{"name":"苯甲酸"}}'

返回 SMILES 字符串、分子式、分子量及 svg_url。

重要提示：所有工具仅接受英文名称。若用户使用中文提问，Agent 必须先将其翻译为英文，再调用工具。例如：“苯甲酸” → “benzoic acid”。

inspect_smiles

curl -s -X POST http://localhost:8899/api/tools/call 
  -H "Content-Type: application/json" 
  -d '{"tool_name":"inspect_smiles","arguments":{"smiles":"CCO"}}'

safety_info

curl -s -X POST http://localhost:8899/api/tools/call 
  -H "Content-Type: application/json" 
  -d '{"tool_name":"safety_info","arguments":{"query":"benzene"}}'

predict_reaction

查询反应物的化学数据。反应本身应由 Agent 进行推理并作答。

curl -s -X POST http://localhost:8899/api/tools/call 
  -H "Content-Type: application/json" 
  -d '{"tool_name":"predict_reaction","arguments":{"reactants":"acetic acid + ethanol"}}'

步骤 2：展示结果

分子结构图

1. 在浏览器中打开工具返回结果中的 svg_url
2. 截图并保存为文件
3. 发送给用户：send_file_to_user(file_path="xxx.png", caption="分子结构图")

化学方程式

在回答完反应后，渲染对应化学方程式：

1. 在浏览器中访问：http://localhost:8899/api/formula/{equation}
2. 截图并保存为文件
3. 发送给用户：send_file_to_user(file_path="xxx.png", caption="化学方程式")

方程式格式规范：

• 下标自动识别：H2O、CH3COOH、Ca(OH)2
• 上标表示：Fe^{2+}、SO4^{2-}
• 箭头类型：->（单向反应）、<=>（可逆平衡）
• 反应条件：[加热]、[催化剂]（显示于箭头上方或下方）
• 示例：CH3COOH+C2H5OH<=>[浓硫酸][加热]CH3COOC2H5+H2O

备用方案

若 predict_reaction 调用失败，Agent 应基于自身化学知识直接作答，并通过 /api/formula/ 渲染方程式。

注意事项

• 纯数据型工具 — 不依赖 LLM，全部推理均由 Agent 完成
• 所有数据均来自 PubChem / OPSIN 真实化学数据库
• 本地部署 — 所有化学数据严格保留在本机，不会外传
• Swagger UI 文档地址：http://localhost:8899/docs