AstrBot

English

简体中文

English

简体中文

Toggle dark mode

Intro & DeployMessaging PlatformsAI IntegrationUsageDevelopment

Connect to Dify ​

Install Dify ​

If you haven't installed Dify yet, please refer to the Dify Installation Documentation to install it.

Configure Dify in AstrBot ​

In the WebUI, click "Model Provider" -> "Add Provider", select "Agent Runner", select "Dify", and enter the Dify configuration page.

image

In Dify, one API Key uniquely corresponds to one Dify application. Therefore, you can create multiple Providers to adapt to multiple Dify applications.

According to the current Dify project, there are three types:

  • chat
  • agent
  • workflow

TIP

Please ensure that the APP type you set in AstrBot matches the application type created in Dify. image

Chat and Agent Applications ​

Create your Dify Chat and Agent application keys as shown in the figure below:

image

image

Copy the key and paste it into the API Key field in the configuration, then click "Save".

Workflow Applications ​

Configure Input and Output Variable Names ​

Workflow applications receive input variables, execute the workflow, and output the results.

image

For Workflow applications, AstrBot will attach two variables with each request:

  • astrbot_text_query: Input variable name. This is the text content entered by the user.
  • astrbot_session_id: Session ID

You can customize the input variable name in the configuration, which is the "Prompt Input Variable Name" shown in the figure above.

You need to modify the input variable name of your Workflow to adapt to AstrBot's input.

Finally, the Workflow will output a result. You can customize the variable name of this result, which is the "Dify Workflow Output Variable Name" in the configuration above, with a default value of astrbot_wf_output. You need to configure this variable name in the output node of the Dify Workflow, otherwise AstrBot cannot parse it correctly.

Create API Key ​

Create your Dify Workflow application's API Key as shown in the figure below:

Click the Publish button in the upper right corner -> Access API -> click API Key in the upper right corner -> Create Key, then copy the API Key.

image

Copy the key and paste it into the API Key field in the configuration, then click "Save".

Select Agent Runner ​

Go to the Configuration page in the left sidebar, click "Agent Execution Method", select "Dify", then select the ID of the Dify Agent Runner you just created in the new configuration options that appear below, and click "Save" in the bottom right corner to complete the configuration.

Appendix: Dynamically Set Workflow Input Variables During Chat (Optional) ​

You can use the /set command to dynamically set input variables, as shown in the figure below:

alt text

After setting variables, AstrBot will attach the variables you set in the next request to Dify, flexibly adapting to your Workflow.

alt text

Of course, you can use the /unset command to cancel the variables you set.

Variables are permanently valid in the current session.

Deployed on Rainyun Logo