Remember Slack Users Across Threads

Resolve a Slack member to an email-backed user ID when available, then use a MemoryManager to retain stable preferences across otherwise separate threads.

user_memory.py
"""
Remember Slack Users Across Threads
===================================

Resolve a Slack member to an email-backed user ID when available, then use a
MemoryManager to retain stable preferences across otherwise separate threads.

Prerequisites: SLACK_TOKEN, SLACK_SIGNING_SECRET, OPENAI_API_KEY
Run: .venvs/demo/bin/python cookbook/05_agent_os/17_slack/user_memory.py
Try in Slack: Share a preference in one thread, then ask about it in a new thread
Slack scopes: app_mentions:read, assistant:write, chat:write, im:history, users:read, users:read.email
"""

from agno.agent import Agent
from agno.db.sqlite import SqliteDb
from agno.memory import MemoryManager
from agno.models.openai import OpenAIResponses
from agno.os import AgentOS
from agno.os.interfaces.slack import Slack

# ---------------------------------------------------------------------------
# Create Memory-enabled Slack AgentOS
# ---------------------------------------------------------------------------

db = SqliteDb(
    id="slack-memory-db",
    db_file="tmp/slack_memory.db",
)

memory_manager = MemoryManager(
    id="slack-user-memory-manager",
    model=OpenAIResponses(id="gpt-5.5"),
    db=db,
    memory_capture_instructions=(
        "Capture the user's name, role, communication preferences, current "
        "projects, and durable likes or dislikes."
    ),
)

personal_assistant = Agent(
    id="slack-personal-assistant",
    name="Slack Personal Assistant",
    model=OpenAIResponses(id="gpt-5.5"),
    db=db,
    memory_manager=memory_manager,
    update_memory_on_run=True,
    instructions=[
        "Use saved user memories when they are relevant.",
        "Do not invent personal details that are not in the conversation or memory.",
        "Keep responses concise for Slack.",
    ],
    add_history_to_context=True,
    num_history_runs=3,
    markdown=True,
)

agent_os = AgentOS(
    id="slack-memory-os",
    description="AgentOS with email-resolved Slack user memory.",
    agents=[personal_assistant],
    interfaces=[
        Slack(
            agent=personal_assistant,
            resolve_user_identity=True,
        )
    ],
)
app = agent_os.get_app()

# ---------------------------------------------------------------------------
# Run Memory-enabled Slack AgentOS
# ---------------------------------------------------------------------------

if __name__ == "__main__":
    agent_os.serve(app=app)

Run the Example

Set up your virtual environment

uv venv --python 3.12
source .venv/bin/activate

Prepare the Slack app

Follow Slack setup to create and install the app, obtain its bot token and signing secret, and configure its current agent experience. Add the bot scopes listed in this example's source docstring and reinstall after changing scopes. Subscribe to app_mention and message.im; configure interactivity for buttons and forms.

Install ngrok and run ngrok http 7777 in another terminal. Keep the tunnel running. After starting this example's server, use the callback paths listed on this page under your public HTTPS URL and complete Slack's verification challenge. Configure each app separately for a multi-app example.

Streaming requires the corresponding Slack app capability. The current Agno adapter initializes suggested prompts on the legacy assistant_thread_started event; the setup guide explains the new-app limitation. Keep only one standalone example on port 7777 at a time.

Install dependencies

uv pip install -U "agno[os,slack]" openai

Export environment variables

export OPENAI_API_KEY="your_openai_api_key_here"
export SLACK_SIGNING_SECRET="your_slack_signing_secret_here"
export SLACK_TOKEN="your_slack_token_here"

Run the example

Save the code above as user_memory.py, then run:

python user_memory.py

Connect Slack to the running server

Keep Python and ngrok running. In each app's Slack settings, prepend your public HTTPS origin to these paths:

AppEvent subscriptionsInteractivity
Slack app/slack/events/slack/interactions

Complete URL verification, then send a DM or invite the app to a channel and @mention it. Ordinary channel replies require an @mention with the default configuration.

Full source: cookbook/05_agent_os/17_slack/user_memory.py