docs: add send_message tool page (agent-facing proactive gateway delivery)#816
Conversation
Add docs/features/send-message-tool.mdx documenting the agent-facing proactive gateway delivery tool introduced in MervinPraison/PraisonAI#2188. - Hero mermaid diagram with standard colour scheme - Quick Start with 3 Steps: basic agent use, list targets, MEDIA: attachment - How It Works sequence diagram (Agent → send_message → Gateway → User) - Targets table covering all 4 forms: origin / platform / platform:chat_id[:thread_id] / alias - Decision mermaid graph for choosing the right target form - MEDIA: attachment documentation with multi-file example - Listing Targets section with sample JSON output - When It's Available table: gateway runtime vs CLI (graceful fallback string quoted) - User Interaction Flow narrative (Telegram push after long task) - Configuration Reference args table + action comparison table - Common Patterns: notify on completion / cross-channel handoff / list-then-send - Best Practices AccordionGroup (4 accordions) - Related CardGroup: Clarify Tool, Channels Gateway, Bot Gateway, Bot Routing - Added to docs.json under Features group next to clarify-tool Co-authored-by: Mervin Praison <MervinPraison@users.noreply.github.com>
Qodo reviews are paused for this user.Troubleshooting steps vary by plan Learn more → On a Teams plan? Using GitHub Enterprise Server, GitLab Self-Managed, or Bitbucket Data Center? |
|
Warning Review limit reached
More reviews will be available in 13 minutes and 32 seconds. Learn how PR review limits work. Your organization has used up its prepaid credits, and credit purchases are no longer available. Enable the review add-on in the billing tab to keep reviews running — you're only billed for reviews past your plan's rate limits ($0.25/file). ⌛ How to resolve this issue?After more reviews become available, a review can be triggered using the To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based credits. 🚦 How do rate limits work?CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan refill rate. For paid Pro and Pro+ PR reviews, CodeRabbit uses rolling per-developer review limits. Reviews become available again as older review attempts age out of the rolling limit window. Please see our Fair Usage Limits Policy for further information. ℹ️ Review info⚙️ Run configurationConfiguration used: defaults Review profile: CHILL Plan: Pro Run ID: 📒 Files selected for processing (2)
✨ Finishing Touches🧪 Generate unit tests (beta)
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
![gemini-code-assist[bot]](https://avatars.githubusercontent.com/in/956858?s=60&v=4){kind=small}
There was a problem hiding this comment.
Code Review
This pull request introduces documentation for the new 'Send Message Tool', which allows agents to proactively message users mid-task via platforms like Telegram, Slack, and Discord. The changes include adding the feature to the docs.json navigation structure and creating a comprehensive send-message-tool.mdx guide with quick start examples, flow diagrams, configuration references, and best practices. There are no review comments provided, and I have no additional feedback to offer.
Important
The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
1 participant
Summary
Adds the documentation page for the
send_messagebuilt-in tool introduced in MervinPraison/PraisonAI#2188.File created:
docs/features/send-message-tool.mdxdocs.json: Entry added under Features group next to
clarify-toolPage sections
action="list",MEDIA:attachmentMEDIA:<path>directive with multi-file exampleaction="list"+ sample JSONAll content cross-checked against SDK source:
src/praisonai-agents/praisonaiagents/tools/messaging_tools.pysrc/praisonai-agents/praisonaiagents/gateway/protocols.pysrc/praisonai-agents/praisonaiagents/session/context.pyFixes #811
Generated with Claude Code