Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 8 additions & 8 deletions docs/content/tutorial/ai-chatbot.md
Original file line number Diff line number Diff line change
Expand Up @@ -100,19 +100,19 @@ Navigate to the Bolty **App Home** and select a provider from the drop-down menu

If you don't see Bolty listed under **Apps** in your workspace right away, never fear! You can mention **@Bolty** in a public channel to add the app, then navigate to your **App Home**.

![Choose your AI provider](/img/ai-chatbot/6.png)
![Choose your AI provider](/img/tutorials/ai-chatbot/6.png)

## Setting up your workflow {#workflow}

Within your development workspace, open Workflow Builder by clicking on your workspace name and then **Tools > Workflow Builder**. Select **New Workflow** > **Build Workflow**.

Click **Untitled Workflow** at the top to rename your workflow. For this tutorial, we'll call the workflow **Welcome to the channel**. Enter a description, such as _Summarizes channels for new members_, and click **Save**.

![Setting up a new workflow](/img/ai-chatbot/1.png)
![Setting up a new workflow](/img/tutorials/ai-chatbot/1.png)

Select **Choose an event** under **Start the workflow...**, and then choose **When a person joins a channel**. Select the channel name from the drop-down menu and click **Save**.

![Start the workflow](/img/ai-chatbot/2.png)
![Start the workflow](/img/tutorials/ai-chatbot/2.png)

Under **Then, do these things**, click **Add steps** and complete the following:

Expand All @@ -121,20 +121,20 @@ Under **Then, do these things**, click **Add steps** and complete the following:
3. Under **Add a message**, enter a short message, such as _Hi! Welcome to `{}The channel that the user joined`. Would you like a summary of the recent conversation?_ Note that the _`{}The channel that the user joined`_ is a variable; you can insert it by selecting **{}Insert a variable** at the bottom of the message text box.
4. Select the **Add Button** button, and name the button _Yes, give me a summary_. Click **Done**.

![Send a message](/img/ai-chatbot/3.png)
![Send a message](/img/tutorials/ai-chatbot/3.png)

We'll add two more steps under the **Then, do these things** section.

First, scroll to the bottom of the list of steps and choose **Custom**, then choose **Bolty** and **Bolty Custom Function**. In the **Channel** drop-down menu, select **Channel that the user joined**. Click **Save**.

![Bolty custom function](/img/ai-chatbot/4.png)
![Bolty custom function](/img/tutorials/ai-chatbot/4.png)

For the final step, complete the following:

1. Choose **Messages** and then **Send a message to a person**. Under **Select a member**, choose **Person who clicked the button** from the drop-down menu.
2. Under **Add a message**, click **Insert a variable** and choose **`{}Summary`** under the **Bolty Custom Function** section in the list that appears. Click **Save**.

![Summary](/img/ai-chatbot/5.png)
![Summary](/img/tutorials/ai-chatbot/5.png)

When finished, click **Finish Up**, then click **Publish** to make the workflow available in your workspace.

Expand All @@ -149,7 +149,7 @@ In order for Bolty to provide summaries of recent conversation in a channel, Bol

To test this, leave the channel you just invited Bolty to and rejoin it. This will kick off your workflow and you'll receive a direct message from **Welcome to the channel**. Click the **Yes, give me a summary** button, and Bolty will summarize the recent conversations in the channel you joined.

![Channel summary](/img/ai-chatbot/7.png)
![Channel summary](/img/tutorials/ai-chatbot/7.png)

The central part of this functionality is shown in the following code snippet. Note the use of the [`user_context`](https://api.slack.com/automation/types#usercontext) object, a Slack type that represents the user who is interacting with our workflow, as well as the `history` of the channel that will be summarized, which includes the ten most recent messages.

Expand Down Expand Up @@ -191,7 +191,7 @@ To ask Bolty a question, you can chat with Bolty in any channel the app is in. U

You can also navigate to **Bolty** in your **Apps** list and select the **Messages** tab to chat with Bolty directly.

![Ask Bolty](/img/ai-chatbot/8.png)
![Ask Bolty](/img/tutorials/ai-chatbot/8.png)

## Next steps {#next-steps}

Expand Down
14 changes: 7 additions & 7 deletions docs/content/tutorial/custom-steps-for-jira.md
Original file line number Diff line number Diff line change
Expand Up @@ -127,21 +127,21 @@ If your app is up and running, you'll see a message noting that the app is start
2. Select **New Workflow** > **Build Workflow**.
3. Click **Untitled Workflow** at the top of the pane to rename your workflow. We'll call it **Create Issue**. For the description, enter _Creates a new issue_, then click **Save**.

![Workflow details](/img/custom-steps-jira/1.png)
![Workflow details](/img/tutorials/custom-steps-jira/1.png)

4. Select **Choose an event** under **Start the workflow...**, and then select **From a link in Slack**. Click **Continue**.

![Start the workflow](/img/custom-steps-jira/2.png)
![Start the workflow](/img/tutorials/custom-steps-jira/2.png)

5. Under **Then, do these things** click **Add steps** to add the custom step. Your custom step will be the function defined in the [`create_issue.py`](https://github.com/slack-samples/bolt-python-jira-functions/blob/main/listeners/functions/create_issue.py) file.

Scroll down to the bottom of the list on the right-hand pane and select **Custom**, then **BoltPy Jira Functions** > **Create an issue**. Enter the project details, issue type (optional), summary (optional), and description (optional). Click **Save**.

![Custom function](/img/custom-steps-jira/3.png)
![Custom function](/img/tutorials/custom-steps-jira/3.png)

6. Add another step and select **Messages** > **Send a message to a channel**. Select **Channel where the workflow was used** from the drop-down list and then select **Insert a variable** and **Issue url**. Click **Save**.

![Insert variable for issue URL](/img/custom-steps-jira/4.png)
![Insert variable for issue URL](/img/tutorials/custom-steps-jira/4.png)

7. Click **Publish** to make the workflow available to your workspace.

Expand All @@ -150,16 +150,16 @@ If your app is up and running, you'll see a message noting that the app is start
1. Copy your workflow link.
2. Navigate to your app's home tab and click **Connect an Account** to connect your JIRA account to the app.

![Connect account](/img/custom-steps-jira/5.png)
![Connect account](/img/tutorials/custom-steps-jira/5.png)

3. Click **Allow** on the screen that appears.

![Allow connection](/img/custom-steps-jira/6.png)
![Allow connection](/img/tutorials/custom-steps-jira/6.png)

4. In any channel, post the workflow link you copied.
5. Click **Start Workflow** and observe as the link to a new JIRA ticket is posted in the channel. Click the link to be directed to the newly-created issue within your JIRA project.

![JIRA issue](/img/custom-steps-jira/7.png)
![JIRA issue](/img/tutorials/custom-steps-jira/7.png)

When finished, you can click the **Disconnect Account** button in the home tab to disconnect your app from your JIRA account.

Expand Down
Loading
Loading