"""
Research Assistant
==================
An agent that combines Slack message search with web search to answer
research questions. Searches internal Slack history first, then gathers
external context from the web.
Key concepts:
- ``SlackTools`` search supports Slack query syntax
(``from:@user``, ``in:#channel``, ``has:link``, ``before:/after:``).
- ``WebSearchTools`` provides external web search.
- The agent synthesizes internal and external findings into one summary.
Slack scopes: app_mentions:read, assistant:write, chat:write, im:history,
search:read, channels:history, users:read
Environment variables:
SLACK_TOKEN Bot token (xoxb-) for standard Slack APIs
SLACK_USER_TOKEN User token (xoxp-) required for search_messages
"""
from agno.agent import Agent
from agno.db.sqlite import SqliteDb
from agno.models.openai import OpenAIChat
from agno.os.app import AgentOS
from agno.os.interfaces.slack import Slack
from agno.tools.slack import SlackTools
from agno.tools.websearch import WebSearchTools
# ---------------------------------------------------------------------------
# Create Example
# ---------------------------------------------------------------------------
agent_db = SqliteDb(session_table="agent_sessions", db_file="tmp/research_assistant.db")
research_assistant = Agent(
name="Research Assistant",
model=OpenAIChat(id="gpt-4o"),
db=agent_db,
tools=[
SlackTools(
enable_search_messages=True,
enable_get_thread=True,
enable_list_users=True,
enable_get_user_info=True,
),
WebSearchTools(),
],
instructions=[
"You are a research assistant that helps find information.",
"You can search Slack messages using: from:@user, in:#channel, has:link, before:/after:date",
"You can also search the web for current information.",
"When asked to research something:",
"1. Search Slack for internal discussions",
"2. Search the web for external context",
"3. Synthesize findings into a clear summary",
"Identify relevant experts by looking at who contributed to discussions.",
],
add_history_to_context=True,
num_history_runs=3,
add_datetime_to_context=True,
markdown=True,
)
agent_os = AgentOS(
agents=[research_assistant],
interfaces=[
Slack(
agent=research_assistant,
reply_to_mentions_only=True,
)
],
)
app = agent_os.get_app()
# ---------------------------------------------------------------------------
# Run Example
# ---------------------------------------------------------------------------
if __name__ == "__main__":
agent_os.serve(app="research_assistant:app", reload=True)
