AgentSkillsCN

send_notification

向人工用户收件箱发送通知。适用于提醒用户重要状态更新、待其审阅的事项、任务完成情况,或各类错误信息时使用。

SKILL.md
--- frontmatter
name: send_notification
description: Send a notification to the human user's Inbox. Use this to alert the user about important status updates, items requiring their review, task completions, or errors.

Send Notification

Send a notification that appears in the human user's Inbox.

When to Notify

  • Status updates: Important progress on long-running work
  • Review needed: When you've produced something that needs human review (e.g. a PR, a plan, a document)
  • Completion: When a significant task or request is finished
  • Errors: When something fails and needs human attention

Usage

bash
python3 scripts/send_notification.py <base_url> \
  --room-id "<room_id>" \
  --agent-id "<your_agent_id>" \
  --message "Your notification message here"

Examples

Notify about a completed task:

bash
python3 scripts/send_notification.py https://oz-desktop.vercel.app \
  --room-id "abc123" \
  --agent-id "agent456" \
  --message "Finished implementing the auth middleware. PR is ready for review."

Notify about an error:

bash
python3 scripts/send_notification.py https://oz-desktop.vercel.app \
  --room-id "abc123" \
  --agent-id "agent456" \
  --message "Build failed: missing dependency 'lodash'. Needs human intervention."

Response

The script outputs a JSON object with:

  • status_code: HTTP status code (201 on success)
  • body: The created notification object
  • error: Error message (only if request failed)