Python语法指南

📚 Python语法速查（扣子专用）

📦 变量与数据类型

扣子智能体开发中最常用的4种数据类型

基础示例

# 字符串 - 用户输入/回复内容
user_name = "张三"
reply = f"你好，{user_name}！"  # f-string格式化

# 数字 - 计数/评分/价格
score = 95
price = 19.9

# 布尔值 - 开关/判断条件
is_vip = True

# 列表 - 多条消息/标签集合
tags = ["AI", "客服", "自动回复"]

# 字典 - 用户信息/配置参数（最常用！）
user = {
    "name": "李四",
    "level": "vip",
    "balance": 199.00
}

💡 扣子代码节点中，直接用 return {"reply": reply} 返回结果给工作流

✏️ 字符串操作（高频使用）

处理用户输入、生成回复必备技能

常用方法

text = "  Hello World  "

# 🔹 去除首尾空格
clean = text.strip()  # "Hello World"

# 🔹 转小写（意图识别必用）
lower = text.lower()  # "  hello world  "

# 🔹 判断是否包含关键词
if "天气" in user_input:
    return {"intent": "weather_query"}

# 🔹 分割字符串
cities = "北京,上海,广州".split(",")
# ['北京', '上海', '广州']

# 🔹 替换内容
msg = "你好{name}".replace("{name}", "张三")

🔀 条件判断（流程控制核心）

根据不同用户输入，执行不同逻辑

if/elif/else

user_level = "vip"

if user_level == "vip":
    reply = "尊享专属服务✨"
elif user_level == "premium":
    reply = "高级会员服务🌟"
else:
    reply = "欢迎使用基础服务~"

return {"reply": reply}

扣子实战：意图识别分流

# 获取用户输入（扣子传入）
msg = inputs.get("user_msg", "").lower().strip()

# 关键词匹配判断意图
if "订单" in msg or "查单" in msg:
    return {"next_node": "order_query", "keyword": "order"}
elif "退款" in msg or "退货" in msg:
    return {"next_node": "refund"}
elif "客服" in msg or "人工" in msg:
    return {"next_node": "human_service"}
else:
    return {"reply": "请问您想咨询什么？"}

🗂️ 列表 & 字典操作

处理多条数据、结构化参数的核心

常用操作

# 🔹 列表：添加/遍历/过滤
items = ["A", "B", "C"]
items.append("D")  # 添加元素

# 遍历列表
for item in items:
    print(item)

# 列表推导式：过滤含"AI"的标签
ai_tags = [t for t in tags if "AI" in t]

# 🔹 字典：安全获取/设置值
user = {"name": "张三"}
name = user.get("name", "未知")  # 推荐：避免KeyError
user["age"] = 25  # 添加或修改字段

# 🔹 字典推导式
upper_users = {k: v.upper() for k, v in user.items()}

⚙️ 函数（封装复用逻辑）

扣子中可定义函数让代码更整洁

函数示例

# 定义格式化回复的函数
def format_reply(name, message):
    return f"👋 {name}，{message}"

# 调用函数
result = format_reply("张三", "欢迎使用智能客服！")
# result = "👋 张三，欢迎使用智能客服！"

# 🔹 扣子实战：标准化响应生成器
def make_response(success, data, error=None):
    import time
    return {
        "success": success,
        "data": data,
        "error": error,
        "timestamp": int(time.time())
    }

# 使用
return make_response(True, {"reply": "处理成功"})

🔄 JSON处理（扣子节点传参）

扣子工作流节点间多用JSON格式传递数据

导入json模块

import json

# 🔹 字典转JSON字符串
data = {"name": "张三", "age": 25}
json_str = json.dumps(data, ensure_ascii=False)
# '{"name": "张三", "age": 25}'

# 🔹 JSON字符串转字典
input_json = '{"city": "北京", "date": "2026-01-15"}'
params = json.loads(input_json)
city = params.get("city")  # "北京"

# 💡 扣子小贴士：
# 大多数情况下，扣子会自动处理JSON转换
# 你只需关注字典的构建和返回即可
# return {"reply": "结果", "next": "node_name"}

✅ 调试技巧： 用 print() 输出变量，在扣子调试面板查看日志

⚠️ 注意缩进： Python用缩进表示代码块，扣子中请保持4空格缩进，避免混用Tab

📦变量

✏️字符串

🔀判断

📋列表

🗂️字典

⚙️函数

Python 语法指南