-
Notifications
You must be signed in to change notification settings - Fork 119
docs: add 5 community tools to docs/community/tools/ #320
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: main
Are you sure you want to change the base?
docs: add 5 community tools to docs/community/tools/ #320
Conversation
Add comprehensive documentation for community-contributed tools: - strands-hubspot: READ-ONLY HubSpot CRM integration with safe data access - strands-teams: Microsoft Teams notifications with Adaptive Cards - strands-telegram: Complete Telegram Bot API with 60+ methods - strands-telegram-listener: Real-time message processing with AI auto-replies - strands-deepgram: Speech & audio processing with 30+ language support Each tool follows the community contribution format with: - Installation instructions - Usage examples - Key features - Configuration requirements - Resource links All tools are production-ready with comprehensive error handling, type safety, and detailed documentation for community adoption.
zastrowm
left a comment
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thanks for these, looking pretty good and almost ready to merge.
I've left a couple of comments - could we update the entries to:
- Have some yaml frontmatter (not blocking, but helpful)
- Update the links in the entry paragraph (per comments)
- (nit - align Requried/Optional comments)
|
|
||
| {{ community_contribution_banner }} | ||
|
|
||
| [strands-deepgram](https://pypi.org/project/strands-deepgram/) is a production-ready speech and audio processing tool for [Strands Agents SDK](https://github.com/strands-agents/sdk-python), powered by Deepgram's AI platform with 30+ language support. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Can we remove the links to Strands-Agent SDK? Given that we're on the docs, I don't think we need them.
Let's also have the first link be to the github project - I feel like most developers are going to be judging packages based on GitHub
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Should we link to Deepgram here too?
| @@ -0,0 +1,53 @@ | |||
| # strands-deepgram | |||
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Could we have front-matter content on each of these packages?
Maybe:
project:
pypi: https://pypi.org/project/strands-deepgram/
github: https://github.com/eraykeskinmac/strands-deepgram
maintainer: eraykeskinmac
service:
name: deepgram
link: https://console.deepgram.com/
I know none of the other pages have this content, but I think going forward it would be beneficial
| DEEPGRAM_API_KEY=your_deepgram_api_key # Required | ||
| DEEPGRAM_DEFAULT_MODEL=nova-3 # Optional | ||
| DEEPGRAM_DEFAULT_LANGUAGE=en # Optional |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
| DEEPGRAM_API_KEY=your_deepgram_api_key # Required | |
| DEEPGRAM_DEFAULT_MODEL=nova-3 # Optional | |
| DEEPGRAM_DEFAULT_LANGUAGE=en # Optional | |
| DEEPGRAM_API_KEY=your_deepgram_api_key # Required | |
| DEEPGRAM_DEFAULT_MODEL=nova-3 # Optional | |
| DEEPGRAM_DEFAULT_LANGUAGE=en # Optional |
| HUBSPOT_API_KEY=your_hubspot_api_key # Required | ||
| HUBSPOT_DEFAULT_LIMIT=100 # Optional |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
| HUBSPOT_API_KEY=your_hubspot_api_key # Required | |
| HUBSPOT_DEFAULT_LIMIT=100 # Optional | |
| HUBSPOT_API_KEY=your_hubspot_api_key # Required | |
| HUBSPOT_DEFAULT_LIMIT=100 # Optional |
| HUBSPOT_DEFAULT_LIMIT=100 # Optional | ||
| ``` | ||
|
|
||
| Get your API key at: [app.hubspot.com/private-apps](https://app.hubspot.com/private-apps) |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The build is flagging this as not existing and it doesn't resolve for me - Is there a different page that we can link to?
|
Are any of these replaced by https://github.com/eraykeskinmac/strands-tools-community? And/or did you want to call out https://github.com/eraykeskinmac/strands-tools-community in any of these pages? |
Proposed Content
I would like to propose adding 5 community tools to the Community Tools documentation, each as separate files following the utcp.md format.
Added Tools:
1. strands-hubspot
2. strands-teams
3. strands-telegram
4. strands-telegram-listener
5. strands-deepgram
Format Compliance
Each tool file follows the established pattern from utcp.md:
{{ community_contribution_banner }}includedCommunity Value
These tools fill critical gaps in the Strands ecosystem: