开源软件名称：

开源软件地址：

开源软件介绍：

Rasa Python-SDK

Python SDK for the development of custom actions for Rasa.

Installation

To install the SDK run

pip install rasa-sdk

Compatibility

rasa-sdk package:

old rasa_core_sdk package:

Usage

Detailed instructions can be found in the Rasa Documentation aboutCustom Actions.

Docker

Usage

In order to start an action server using implemented custom actions,you can use the available Docker image rasa/rasa-sdk.

Before starting the action server ensure that the folder containingyour actions is handled as Python module and therefore has to containa file called __init__.py

Then start the action server using:

docker run -p 5055:5055 --mount type=bind,source=<ABSOLUTE_PATH_TO_YOUR_ACTIONS>,target=/app/actions \	rasa/rasa-sdk:<version>

The action server is then available at http://localhost:5055/webhook.

Custom Dependencies

To add custom dependencies you enhance the given Docker image, e.g.:

# Extend the official Rasa SDK imageFROM rasa/rasa-sdk:<version># Change back to root user to install dependenciesUSER root# To install system dependenciesRUN apt-get update -qq && \    apt-get install -y <NAME_OF_REQUIRED_PACKAGE> && \    apt-get clean && \    rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/*# To install packages from PyPIRUN pip install --no-cache-dir <A_REQUIRED_PACKAGE_ON_PYPI># Switch back to non-root to run codeUSER 1001

Building from source

Rasa SDK uses Poetry for packaging and dependency management. If you want to build it from source,you have to install Poetry first. This is how it can be done:

curl -sSL https://raw.githubusercontent.com/python-poetry/poetry/master/get-poetry.py | python3

There are several other ways to install Poetry. Please, followthe official guide to see all possible options.

To install dependencies and rasa-sdk itself in editable mode execute

make install

Code Style

To ensure a standardized code style we use the formatter black.If your code is not formatted properly, GitHub CI will fail to build.

If you want to automatically format your code on every commit, you can use pre-commit.Just install it via pip install pre-commit and execute pre-commit install.

To check and reformat files execute

make lint

Steps to release a new version

Releasing a new version is quite simple, as the packages are build and distributedby GitHub Actions.

Release steps:

1. Switch to the branch you want to cut the release from (main in case of amajor / minor, the current release branch for patch releases).
2. Run make release
3. Create a PR against main or the release branch (e.g. 1.2.x)
4. Once your PR is merged, tag a new release (this SHOULD always happen onmain or release branches), e.g. using

   git tag 1.2.0 -m "next release"git push origin 1.2.0
   GitHub Actions will build this tag and push a package topypi.
5. If this is a minor release, a new release branch should be createdpointing to the same commit as the tag to allow for future patch releases,e.g.

   git checkout -b 1.2.xgit push origin 1.2.x

License

Licensed under the Apache License, Version 2.0. Copyright 2021 RasaTechnologies GmbH. Copy of the license.

A list of the Licenses of the dependencies of the project can be found atthe bottom of theLibraries Summary.