-
Notifications
You must be signed in to change notification settings - Fork 103
Description
Proposed Content
I would like to propose adding strands-teams to the Community Packages documentation.
This is a production-ready Microsoft Teams integration tool for Strands Agents. It enables agents to send rich, interactive adaptive card notifications to Teams channels via webhooks. The tool provides:
- Adaptive Cards: Full adaptive card schema support with rich formatting
- Pre-built Templates: Ready-to-use notification, approval, and status update templates
- Interactive Elements: Action buttons, user input fields, and interactive components
- Rich Formatting: Markdown support, images, media, and custom styling
- Webhook Integration: Simple, secure channel integration via incoming webhooks
- Easy Integration: Drop-in tool for Strands agents with natural language interface
Package Information:
- PyPI: https://pypi.org/project/strands-teams/
- GitHub: https://github.com/eraykeskinmac/strands-teams
- Examples: https://github.com/eraykeskinmac/strands-tools-examples
Installation:
pip install strands-teams
pip install 'strands-agents[anthropic]'
Quick Usage Example:
from strands import Agent
from strands_teams import teams
agent = Agent(tools=[teams])
# Simple notification
agent("send a Teams notification: New lead from Acme Corp")
# Pre-built approval template
agent("send an approval request to Teams for Q4 budget of $50,000")
# Status update template
agent("send a status update to Teams: Website deployment is 75% complete")
# Custom adaptive card
agent("create a Teams card showing today's sales metrics with graphs")
Location
**Location:**valuable for the Strands Agents community because:
-
Enterprise Communication: Microsoft Teams is the primary communication platform for millions of organizations. This tool enables AI agents to notify, alert, and interact with teams in their native workspace.
-
Human-in-the-Loop Workflows: The approval card templates enable agents to request human confirmation for critical decisions, making AI agents more practical and trustworthy in production environments.
-
Rich Notifications: Goes beyond simple text messages with adaptive cards that include formatted data, images, buttons, and interactive elements - providing better context and actionability.
-
Complete Agent Workflows: Integrates seamlessly with other community tools to create end-to-end workflows like: transcribe call (strands-deepgram) → lookup customer (strands-hubspot) → send enriched summary to Teams (strands-teams).
-
Pre-built Templates: Saves significant development time with ready-to-use templates for common patterns (notifications, approvals, status updates) while still supporting custom adaptive cards.
-
Production Monitoring: Perfect for agent observability - send alerts, status updates, error notifications, and performance metrics to Teams channels for team visibility.
-
Follows Best Practices: Published on PyPI, follows strands-{thing} naming convention, includes comprehensive documentation, and demonstrates proper tool implementation patterns.
-
Community Benefit: Open-source with real-world examples showing how to build effective notification systems for AI agents in enterprise environments.
Rationale
Rationale:
Microsoft Teams integration for rich notifications and alerts
Key Features
- Adaptive card support (full schema)
- Pre-built templates (notification, approval, status)
- Interactive elements and action buttons
- Rich formatting (markdown, images, media)
- Webhook-based integration
- Natural language interface
Installation
pip install strands-teams
Configuration
Required environment variables (TEAMS_WEBHOOK_URL)
Pre-built Templates
- Notification cards: General alerts and updates
- Approval cards: Request human confirmation with buttons
- Status cards: Project/system status updates
- Simple messages: Basic text notifications
Usage Examples
- Simple notifications
- Approval requests with buttons
- Status updates with progress
- Custom adaptive cards
- Multi-section cards with data tables
Use Cases
- Agent Monitoring & Observability
- Human-in-the-Loop Approvals
- Workflow Notifications
- Alert & Error Reporting
- Team Collaboration
- Status Dashboards
Advanced Features
- Custom adaptive card JSON
- Multiple sections and columns
- Action buttons with URLs
- Image and media support
- Fact sets for structured data
Links
- PyPI package
- GitHub repository
- Example repository
- Adaptive Cards documentation
Content Outline (Optional)
Content Outline (Optional):
## strands-teams
### Overview
Microsoft Teams integration for rich notifications and alerts
### Key Features
- Adaptive card support (full schema)
- Pre-built templates (notification, approval, status)
- Interactive elements and action buttons
- Rich formatting (markdown, images, media)
- Webhook-based integration
- Natural language interface
### Installation
pip install strands-teams
### Configuration
Required environment variables (TEAMS_WEBHOOK_URL)
### Pre-built Templates
- Notification cards: General alerts and updates
- Approval cards: Request human confirmation with buttons
- Status cards: Project/system status updates
- Simple messages: Basic text notifications
### Usage Examples
- Simple notifications
- Approval requests with buttons
- Status updates with progress
- Custom adaptive cards
- Multi-section cards with data tables
### Use Cases
- Agent Monitoring & Observability
- Human-in-the-Loop Approvals
- Workflow Notifications
- Alert & Error Reporting
- Team Collaboration
- Status Dashboards
### Advanced Features
- Custom adaptive card JSON
- Multiple sections and columns
- Action buttons with URLs
- Image and media support
- Fact sets for structured data
### Links
- PyPI package
- GitHub repository
- Example repository
- Adaptive Cards documentation
### References
- **PyPI Package**: https://pypi.org/project/strands-teams/
- **GitHub Repository**: https://github.com/eraykeskinmac/strands-teams
- **Examples Repository**: https://github.com/eraykeskinmac/strands-tools-examples
- **Microsoft Adaptive Cards**: https://adaptivecards.io/
- **Teams Webhooks Documentation**: https://learn.microsoft.com/en-us/microsoftteams/platform/webhooks-and-connectors/
- **Strands Community Package Guidelines**: https://strandsagents.com/latest/documentation/docs/community/community-packages/