⚡

Pylon工单支持工具集Skill pylon-support

Pylon工单支持工具集是一个通过命令行终端直接与Pylon工单系统REST API交互的技能包。它提供了一系列Python脚本，用于高效管理工单，包括：工单列表查询与过滤、个人队列查看与统计、批量分诊报告生成、工单状态与标签快速更新、添加内部备注或客户回复，以及执行任意API调用。核心功能围绕工单审计、状态跟踪和团队协作展开，旨在提升技术支持、客户成功和运维团队的工作效率，无需频繁切换至Web界面。关键词：Pylon API， 工单管理， 命令行工具， 技术支持自动化， DevOps， 客户支持， 工单分诊， REST API调用。

DevOps 0 次安装 0 次浏览 更新于 2/24/2026

name: pylon-support description: 通过REST API处理Pylon工单。当您需要列出或检查问题、添加内部备注/客户回复，或执行任何临时Pylon API调用时使用。 metadata: { “openclaw”: { “requires”: { “env”: [“PYLON_API_TOKEN”] }, “primaryEnv”: “PYLON_API_TOKEN”, }, }

Pylon支持操作

此技能捆绑了与Pylon REST API交互的轻量级工具，让您无需离开终端即可审核工单、跟踪后续事项或发布更新。

设置

  1. 创建具有所需权限（问题、消息、联系人等）的Pylon API令牌。
  2. 运行任何脚本前导出它：
    export PYLON_API_TOKEN="<token>"
  3. 可选：使用PYLON_API_BASE覆盖基础URL（用于暂存环境）。
  4. （可选）在~/.pylonrc创建配置文件以缓存您的用户ID或自定义默认值。使用pylon_env.py管理它。

有关端点摘要和示例负载，请参阅references/pylon_api.md。

脚本

scripts/pylon_list_issues.py

快速转储/issues并应用常见过滤器，以便您发现阻塞项。

python3 scripts/pylon_list_issues.py --state waiting_on_you --limit 25
python3 scripts/pylon_list_issues.py --team-id team_9

如果您希望脚本将响应过滤到单个负责人（因为API有时会忽略服务器端过滤器），请设置--assignee-id <user-id>。您可以通过以下方式发现您的用户ID：python3 scripts/pylon_request.py /users --param search=jordan。

脚本会打印API响应，并在适用时打印下一页的cursor。通过--page-cursor将该游标反馈回去以继续。

scripts/pylon_env.py

轻量级配置助手，用于在~/.pylonrc中缓存您的用户ID或首选默认值（可通过PYLON_CONFIG_FILE覆盖路径）。

# 发现并缓存您的/me用户ID
python3 scripts/pylon_env.py --refresh-user-id

# 设置默认窗口大小和视图摘要
env PYLON_CONFIG_FILE=~/.pylonrc python3 scripts/pylon_env.py --set-window-days 7
python3 scripts/pylon_env.py --show

scripts/pylon_my_queue.py

生成您队列的可读摘要：按状态计数以及每个工单的详细信息（标题、优先级、最后更新时间、链接）。

# 使用缓存的用户ID快速查看
python3 scripts/pylon_my_queue.py

# 覆盖负责人或窗口，限制API获取
python3 scripts/pylon_my_queue.py --assignee-id usr_123 --window-days 14 --limit 400

scripts/pylon_triage_report.py

更高级别的分诊报告：一次获取多个负责人，按状态分组，并显示每个状态中最后更新时间戳的前N个工单。

# 我的队列，30天窗口，每个状态前10个
python3 scripts/pylon_triage_report.py --top 10

# 多个负责人的团队视图，14天窗口
python3 scripts/pylon_triage_report.py \
  --assignee-id usr_kody --assignee-id usr_skyler --window-days 14 --top 5

scripts/pylon_update_issue.py

无需打开UI即可快速更新状态/标签/负责人/自定义字段。

# 将工单移至waiting_on_customer并标记
python3 scripts/pylon_update_issue.py iss_123 --state waiting_on_customer --tags followup pending_ops

# 设置优先级自定义字段
python3 scripts/pylon_update_issue.py iss_456 --priority high

scripts/pylon_add_note.py

添加内部备注或客户可见的回复。

# 从内联文本添加内部备注
python3 scripts/pylon_add_note.py iss_123 --text "正在联系工程团队查找根本原因" --private

# 从HTML片段添加客户回复
python3 scripts/pylon_add_note.py iss_123 --file reply.html --html

scripts/pylon_request.py

通用包装器，适用于任何Pylon端点。提供路径、方法和可选的参数/正文。

# 更新工单状态
python3 scripts/pylon_request.py /issues/iss_123 \
  --method PATCH \
  --data '{"state":"waiting_on_customer"}'

# 添加内部备注
python3 scripts/pylon_request.py /issues/iss_123/messages \
  --method POST \
  --data '{"message_html":"<p>正在联系产品团队...</p>","is_private":true}'

# 获取工单消息（GET是默认方法）
python3 scripts/pylon_request.py /issues/iss_123/messages

标志：

  • --param key=value（可重复）以添加查询参数。
  • --data '{...}'或--data-file payload.json用于请求正文。

scripts/pylon_client.py

共享助手，处理身份验证、基础URL和JSON解析。如果您添加更多特定任务的脚本，请导入它。

工作流提示

  1. 每天早上分诊：pylon_list_issues.py --state waiting_on_you为您提供团队需要回复的工单队列。
  2. 深入查看工单：使用pylon_request.py /issues/<id>拉取元数据，然后使用/issues/<id>/messages获取对话历史记录。
  3. 快速更新状态：通过--method PATCH调用修补工单状态或暂停窗口。
  4. 交接时添加上下文：在Slack中标记队友之前，使用is_private=true发布内部备注。

有关完整的有用端点列表（用户、联系人、标签等）以及当您需要此处未涵盖的字段时指向官方文档的链接，请参阅references/pylon_api.md。