Skip to content

[NEW CONTENT] Add strands-teams to Community Packages - Microsoft Teams Notifications Tool #289

@eraykeskinmac

Description

@eraykeskinmac

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:

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:

  1. 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.

  2. 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.

  3. Rich Notifications: Goes beyond simple text messages with adaptive cards that include formatted data, images, buttons, and interactive elements - providing better context and actionability.

  4. 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).

  5. 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.

  6. Production Monitoring: Perfect for agent observability - send alerts, status updates, error notifications, and performance metrics to Teams channels for team visibility.

  7. Follows Best Practices: Published on PyPI, follows strands-{thing} naming convention, includes comprehensive documentation, and demonstrates proper tool implementation patterns.

  8. 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/

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationenhancementNew feature or request

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions