releases.shpreview
Slack/Python SDK

Python SDK

Mon
Wed
Fri
JunJulAugSepOctNovDecJanFebMarAprMay
Less
More
Releases2Avg0/wkVersionsv3.40.1 to v3.41.0
All Releases

v3.42.0

↗
<!-- Release notes generated using configuration in .github/release.yml at main -->

What's Changed

🚀 Enhancements
🐛 Bug Fixes
📚 Documentation
📦 Other changes

New Contributors

Full Changelog: https://github.com/slackapi/python-slack-sdk/compare/v3.41.0...v3.42.0 Milestone: https://github.com/slackapi/python-slack-sdk/milestone/118?closed=1

v3.41.0

↗
<!-- Release notes generated using configuration in .github/release.yml at main -->

What's Changed

🚀 Enhancements
📦 Other changes

Full Changelog: https://github.com/slackapi/python-slack-sdk/compare/v3.40.1...v3.41.0 Milestone: https://github.com/slackapi/python-slack-sdk/milestone/117?closed=1

v3.40.1

↗
<!-- Release notes generated using configuration in .github/release.yml at main -->

What's Changed

🐛 Bug Fixes
📦 Other changes

Full Changelog: https://github.com/slackapi/python-slack-sdk/compare/v3.40.0...v3.40.1 Milestone: https://github.com/slackapi/python-slack-sdk/milestone/116?closed=1

v3.40.0

↗
<!-- Release notes generated using configuration in .github/release.yml at main -->

Agent Thinking Steps: Display Tasks/Tools, Plans, and Markdown Text

🍿 Preview: Display as Plan

https://github.com/user-attachments/assets/85219072-66ac-4d86-a18b-dd92689036ea

🍿 Preview: Display as Timeline

https://github.com/user-attachments/assets/4cb0bb5f-c70f-4304-b875-4dc262640a67

📺 Chat Stream with 2 Display Mode
  • Plan Display Mode
  • Timeline Display Mode
👾 Chat Stream Structured Content

Now, you can display a mixture of structured content called "chunks":

  • 🔠 Markdown Text Block to format your text with standard markdown
  • ☑️ Task Card Block to display a single task, representing an AI Tool Call or general action
  • 🗒️ Plan Block to display a collection of related tasks
  • 📚 URL Sources Element to display references within a task card block

Available in:

  • 🔌 API Methods: chat_startStream, chat_appendStream, and chat_stopStream
  • 🛟 Chat Stream Helper: streamer = client.chat_stream(...), streamer.append(...)
📖 Documentation
🍿 Getting Started
$ slack create

# → AI Agent App
#     Bolt for JavaScript
#   → Bolt for Python
🕹️ Example
streamer = client.chat_stream(
    channel=channel_id,
    recipient_team_id=team_id,
    recipient_user_id=user_id,
    thread_ts=thread_ts,
    task_display_mode="plan",
)

streamer.append(
    chunks=[
        MarkdownTextChunk(
            text="Hello.\nI have received the task. ",
        ),
        MarkdownTextChunk(
            text="This task appears manageable.\nThat is good.",
        ),
        TaskUpdateChunk(
            id="001",
            title="Understanding the task...",
            status="in_progress",
            details="- Identifying the goal\n- Identifying constraints",
        ),
        TaskUpdateChunk(
            id="002",
            title="Performing acrobatics...",
            status="pending",
        ),
    ],
)

time.sleep(4)

streamer.append(
    chunks=[
        PlanUpdateChunk(
            title="Adding the final pieces...",
        ),
        TaskUpdateChunk(
            id="001",
            title="Understanding the task...",
            status="complete",
            details="\n- Pretending this was obvious",
            output="We'll continue to ramble now",
        ),
        TaskUpdateChunk(
            id="002",
            title="Performing acrobatics...",
            status="in_progress",
        ),
    ],
)

time.sleep(4)

streamer.stop(
    chunks=[
        PlanUpdateChunk(
            title="Decided to put on a show",
        ),
        TaskUpdateChunk(
            id="002",
            title="Performing acrobatics...",
            status="complete",
            details="- Jumped atop ropes\n- Juggled bowling pins\n- Rode a single wheel too",
        ),
        MarkdownTextChunk(
            text="The crowd appears to be astounded and applauds :popcorn:"
        ),
    ],
    blocks=create_feedback_block(),
)

What's Changed

🚀 Enhancements
🐛 Bug Fixes
📚 Documentation
📦 Dependencies
🧰 Maintenance

Full Changelog: https://github.com/slackapi/python-slack-sdk/compare/v3.39.0...v3.40.0 Milestone: https://github.com/slackapi/python-slack-sdk/milestone/115

v3.40.0.dev0

↗
<!-- Release notes generated using configuration in .github/release.yml at feat-ai-apps-thinking-steps -->

What's Changed

🚀 Enhancements
🐛 Bug Fixes
📦 Other changes

Full Changelog: https://github.com/slackapi/python-slack-sdk/compare/v3.39.0...v3.40.0.dev0

v3.39.0

↗

What's Changed

🚀 Enhancements
📦 Other changes

New Contributors

Full Changelog: https://github.com/slackapi/python-slack-sdk/compare/v3.38.0...v3.39.0 Milestone: https://github.com/slackapi/python-slack-sdk/milestone/114?closed=1

v3.38.0

↗
<!-- Release notes generated using configuration in .github/release.yml at main -->

What's Changed

🚀 Enhancements
🐛 Bug Fixes
📚 Documentation
📦 Other changes

New Contributors

Full Changelog: https://github.com/slackapi/python-slack-sdk/compare/v3.37.0...v3.38.0 Milestone: https://github.com/slackapi/python-slack-sdk/milestone/113?closed=1

v3.37.0

↗

AI-Enabled Features: Loading States, Text Streaming, and Feedback Buttons

🍿 Preview

https://github.com/user-attachments/assets/bc16597b-1632-46bb-b7aa-fe22330daf84

📚 Changelog
⚡ Getting Started

Try the AI Agent Sample app to explore the AI-enabled features and existing Assistant helper:

# Create a new AI Agent app
$ slack create slack-ai-agent-app --template slack-samples/bolt-python-assistant-template
$ cd slack-ai-agent-app/

# Initialize Python Virtual Environment
$ python3 -m venv .venv
$ source .venv/bin/activate
$ pip install -r requirements.txt

# Add your OPENAI_API_KEY
$ export OPENAI_API_KEY=sk-proj-ahM...

# Run the local dev server
$ slack run

After the app starts, send a message to the "slack-ai-agent-app" bot for a unique response.

⌛ Loading States

Loading states allows you to not only set the status (e.g. "My app is typing...") but also sprinkle some personality by cycling through a collection of loading messages:

@app.message()
def handle_message(message, client):
    client.assistant_threads_setStatus(
        channel_id=channel_id,
        thread_ts=thread_ts,
        status="thinking...",
        loading_messages=[
            "Teaching the hamsters to type faster…",
            "Untangling the internet cables…",
            "Consulting the office goldfish…",
            "Polishing up the response just for you…",
            "Convincing the AI to stop overthinking…",
        ],
    )

    # Start a new message stream
🔮 Text Streaming Helper

The chat_stream() helper utility can be used to streamline calling the 3 text streaming methods:

# Start a new message stream
streamer = client.chat_stream(
    channel=channel_id,
    recipient_team_id=team_id,
    recipient_user_id=user_id,
    thread_ts=thread_ts,
)

# Loop over OpenAI response stream
# https://platform.openai.com/docs/api-reference/responses/create
for event in returned_message:
    if event.type == "response.output_text.delta":
        streamer.append(markdown_text=f"{event.delta}")
    else:
        continue

feedback_block = create_feedback_block()
streamer.stop(blocks=feedback_block)
🔠 Text Streaming Methods

Alternative to the Text Streaming Helper is to call the individual methods.

1) client.chat_startStream

First, start a chat text stream to stream a response to any message:

@app.message()
def handle_message(client, context, event, messsage):
    # Start a new message stream
    stream_response = client.chat_startStream(
        channel=channel_id,
        recipient_team_id=team_id,
        recipient_user_id=user_id,
        thread_ts=thread_ts,
    )
    stream_ts = stream_response["ts"]
2) client.chat_appendStream

After starting a chat text stream, you can then append text to it in chunks (often from your favourite LLM SDK) to convey a streaming effect:

for event in returned_message:
    if event.type == "response.output_text.delta":
        client.chat_appendStream(
            channel=channel_id, 
            ts=stream_ts, 
            markdown_text=f"{event.delta}"
        )
    else:
        continue
3) client.chat_stopStream

Lastly, you can stop the chat text stream to finalize your message:

client.chat_stopStream(
    channel=channel_id, 
    ts=stream_ts,
    blocks=feedback_block
)
👍🏻 Feedback Buttons

Add feedback buttons to the bottom of a message, after stopping a text stream, to gather user feedback:

def create_feedback_block() -> List[Block]:
    blocks: List[Block] = [
        ContextActionsBlock(
            elements=[
                FeedbackButtonsElement(
                    action_id="feedback",
                    positive_button=FeedbackButtonObject(
                        text="Good Response",
                        accessibility_label="Submit positive feedback on this response",
                        value="good-feedback",
                    ),
                    negative_button=FeedbackButtonObject(
                        text="Bad Response",
                        accessibility_label="Submit negative feedback on this response",
                        value="bad-feedback",
                    ),
                )
            ]
        )
    ]
    return blocks

@app.message()
def handle_message(client, context, event, message):
    # ... previous streaming code ...
    
    # Stop the stream and add feedback buttons
    feedback_block = create_feedback_block()
    client.chat_stopStream(
        channel=channel_id, 
        ts=stream_ts, 
        blocks=feedback_block
    )

Ⓜ️ Markdown Text Support

chat_postMessage supports markdown_text
response = client.chat_postMessage(
    channel="C111",
    markdown_text=markdown_content,
)

Learn more in https://github.com/slackapi/python-slack-sdk/pull/1718

🧩 Markdown Block

📚 https://docs.slack.dev/reference/block-kit/blocks/markdown-block/

from slack_sdk.models.blocks import MarkdownBlock
...

@app.message("hello")
def message_hello(say):
    say(
        blocks=[
            MarkdownBlock(text="**lets's go!**"),
        ],
        text="let's go!",
    )

Learn more in https://github.com/slackapi/python-slack-sdk/pull/1748

🎞️ Workflows Featured Methods

Add support for the workflows.featured.{add|list|remove|set} methods:

app.client.workflows_featured_add(channel_id="C0123456789", trigger_ids=["Ft0123456789"])
app.client.workflows_featured_list(channel_ids="C0123456789")
app.client.workflows_featured_remove(channel_id="C0123456789", trigger_ids=["Ft0123456789"])
app.client.workflows_featured_set(channel_id="C0123456789", trigger_ids=["Ft0123456789"])

Learn more in https://github.com/slackapi/python-slack-sdk/pull/1712

What's Changed

👾 Enhancements
🐛 Bug fixes
📚 Documentation
🤖 Dependencies
🧰 Maintenance

New Contributors 🎉

Milestone: https://github.com/slackapi/python-slack-sdk/milestone/112 Full Changelog: https://github.com/slackapi/python-slack-sdk/compare/v3.36.0...v3.37.0 Package: https://pypi.org/project/slack-sdk/3.37.0/

v3.36.0

↗

What's changed

👾 Enhancements
🧪 Tests
📚 Documentation
🤖 Dependencies
🧰 Maintenance

Milestone: https://github.com/slackapi/python-slack-sdk/milestone/111 Full Changelog: https://github.com/slackapi/python-slack-sdk/compare/v3.35.0...v3.36.0

version 3.35.0

↗
v3.35.0

What's Changed

➕ features
🐛 fixes
📚 docs
🏗️ maintenance
:dependabot: dependabot

New Contributors

version 3.34.0

↗
v3.34.0

Changes

Dependabot

version 3.33.5

↗
v3.33.5

Changes

  • #1594 #1598 #1541 Improve WebClient's slack.com url overwriting experience - Thanks @HTSagara @WilliamBergamin
  • #1609 SocketModeClient expose asyncio event loop param - Thanks @jantman
  • #1602 Improve unit tests' mock server implementation - Thanks @WilliamBergamin
  • #1608 "channel_id" instead of "channel" in "files_upload_v2" code example - Thanks @wefi-nick

version 3.32.0

↗
v3.32.0

What's Changed

Features and Fixes
Documentation
Misc
Dependabot

New Contributors

version 3.31.0

↗
v3.31.0

What's Changed

version 3.30.0

↗
v3.30.0

Changes

All issues/pull requests: https://github.com/slackapi/python-slack-sdk/milestone/99?closed=1 Full Changelog: https://github.com/slackapi/python-slack-sdk/compare/v3.29.0...v3.30.0

Last Checked
11h ago
Latest
v3.42.0
Source
@slackapi/python-slack-sdk4k
Tracking since Oct 22, 2020
.json·.md·.atom