rasa/rasa-sdk

Rasa Python-SDK Docker镜像文档

镜像概述

Rasa Python-SDK是Rasa对话系统的官方Python开发工具包，专注于自定义动作开发。其Docker镜像rasa/rasa-sdk提供了便捷的动作服务器运行环境，支持快速部署包含自定义业务逻辑的后端服务，与Rasa核心系统无缝集成。

核心功能与特性

• 自定义动作开发：提供API支持开发Rasa对话系统所需的自定义业务逻辑动作
• 版本兼容性：严格匹配Rasa核心版本，确保系统稳定运行
• Docker化部署：通过容器化方式简化动作服务器启动与管理流程
• 依赖扩展性：支持通过Dockerfile扩展系统依赖和Python包依赖
• 标准化接口：提供符合Rasa规范的Webhook接口，便于与Rasa核心系统通信

兼容性说明

rasa-sdk包版本兼容表

旧rasa_core_sdk包版本兼容表

使用场景

适用于需要为Rasa对话系统扩展自定义业务逻辑的场景，包括：

• 调用外部API获取实时数据（如天气、订单状态查询）
• 执行数据库操作（用户信息存储、业务数据查询）
• 实现复杂业务流程控制（多步骤任务处理、条件分支逻辑）
• 集成第三方服务（支付系统、通知服务、CRM系统）

使用方法

前置要求

• 自定义动作代码目录必须作为Python模块，需包含__init__.py文件（可为空文件）
• 本地已安装Docker环境

Docker运行命令

启动动作服务器并挂载自定义动作目录：

bash
docker run -p 5055:5055 --mount type=bind,source=<本地动作目录绝对路径>,target=/app/actions \
  rasa/rasa-sdk:<版本号>

参数说明

• -p 5055:5055：端口映射，将容器内5055端口映射到本地5055端口
• --mount：挂载本地动作目录到容器内/app/actions路径，需将<本地动作目录绝对路径>替换为实际目录的绝对路径
• <版本号>：指定SDK版本标签，需根据兼容性表选择与Rasa版本匹配的SDK版本

访问地址

动作服务器启动后可通过http://localhost:5055/webhook地址访问。

自定义依赖配置

如需添加系统依赖或Python包，可通过以下Dockerfile扩展基础镜像：

dockerfile
# 基于官方Rasa SDK镜像构建
FROM rasa/rasa-sdk:<版本号>

# 切换至root用户以安装依赖
USER root

# 安装系统依赖（示例：安装curl）
RUN apt-get update -qq && \
    apt-get install -y curl && \
    apt-get clean && \
    rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/*

# 安装Python依赖（示例：安装requests库）
RUN pip install --no-cache-dir requests

# 切换回非root用户运行服务
USER 1001

构建并使用自定义镜像：

bash
docker build -t my-custom-rasa-sdk .
docker run -p 5055:5055 --mount type=bind,source=<本地动作目录绝对路径>,target=/app/actions my-custom-rasa-sdk

许可证

基于Apache License 2.0许可协议，版权所有2021 Rasa Technologies GmbH。完整许可文本见项目LICENSE文件。