Dify实战指南：如何高效测试和优化Skill性能

3次阅读

没有评论

共计 2681 个字符，预计需要花费 7 分钟才能阅读完成。

在 Dify 平台上开发 Skill（技能）时，测试环节往往会遇到几个典型难题：

异步事件模拟困难 ：Dify Skill 经常需要处理异步回调（如第三方 API 响应），手动模拟这类事件耗时且容易遗漏边界条件
上下文依赖复杂 ：多轮对话的 Skill 需要维护会话状态（Session），测试时难以准确还原真实用户的上下文跳转场景
性能瓶颈隐蔽 ：混合使用同步 / 异步调用时，响应延迟问题往往在流量突增时才暴露

聚焦单个函数 / 模块的原子性验证，适合：

核心业务逻辑（如 NLU 解析结果校验）
工具类方法（如日期格式化）

验证模块间交互，典型场景包括：

Skill 与 Dify 平台的事件总线通信
数据库 / 缓存读写一致性检查
第三方 API 的熔断机制测试

全链路真实场景测试，重点关注：

多轮对话状态机跳转
异常流量下的降级策略
用户授权流程完整性

# test_weather_skill.py
import pytest
from unittest.mock import patch
from skill.weather import handle_weather_query  # 被测函数

# 模拟 Dify 平台的事件结构
def mock_event(location: str):
    return {
        "type": "user_message",
        "query": f"{location} 天气怎么样",
        "session": {"user_id": "test_123"}
    }

# 使用 patch 模拟第三方 API
@patch('skill.weather.requests.get')
def test_handle_weather_query(mock_get):
    # 配置 Mock 响应
    mock_get.return_value.status_code = 200
    mock_get.return_value.json.return_value = {"temp": 25, "condition": "晴"}

    # 执行测试
    event = mock_event("北京")
    resp = handle_weather_query(event)

    # 验证结果
    assert "北京当前天气" in resp["reply"]
    assert "25℃" in resp["reply"]
    mock_get.assert_called_once_with(
        "https://api.weather.com/v1",
        params={"city": "北京"}
    )

# 运行所有测试
$ dify test run --skill weather --tags smoke

# 生成覆盖率报告
$ dify test coverage --output=lcov

# 查看实时测试日志
$ dify test monitor --session-id test_123

P99 响应时间 < 800ms
错误率 < 0.5%
最大并发数 ≥ 50 QPS

<!-- jmeter_test.jmx -->
<ThreadGroup guiclass="ThreadGroupGui" testclass="ThreadGroup" testname="Dify Skill 压测">
  <intProp name="ThreadGroup.num_threads">50</intProp>
  <intProp name="ThreadGroup.ramp_time">30</intProp>
  <boolProp name="ThreadGroup.scheduler">true</boolProp>
  <stringProp name="ThreadGroup.on_sample_error">continue</stringProp>

  <HTTPSamplerProxy guiclass="HttpTestSampleGui" testclass="HTTPSamplerProxy" testname="/skill-api">
    <elementProp name="HTTPsampler.Arguments" elementType="Arguments">
      <collectionProp name="Arguments.arguments">
        <elementProp name="query" elementType="HTTPArgument">
          <stringProp name="Argument.value"> 北京天气 </stringProp>
        </elementProp>
      </collectionProp>
    </elementProp>
    <stringProp name="HTTPSampler.domain">api.dify.ai</stringProp>
    <stringProp name="HTTPSampler.port">443</stringProp>
    <stringProp name="HTTPSampler.protocol">https</stringProp>
    <stringProp name="HTTPSampler.path">/v1/skill/weather</stringProp>
  </HTTPSamplerProxy>
</ThreadGroup>

现象：用户 A 的对话数据出现在用户 B 的会话中
解决方案 ：