helpdesk-automation

Rube MCP による HelpDesk の自動化

Rube MCP 経由で Composio の HelpDesk ツールキットを利用し、HelpDesk のチケット操作を自動化します。

前提条件

• Rube MCP が接続されていること（RUBE_SEARCH_TOOLS が利用可能）
• RUBE_MANAGE_CONNECTIONS を通じて HelpDesk への接続が有効であること（ツールキットは helpdesk）
• 最新のツールスキーマを取得するため、必ず最初に RUBE_SEARCH_TOOLS を呼び出すこと

セットアップ

Rube MCP の取得：クライアントの設定で https://rube.app/mcp を MCP サーバーとして追加します。クライアントの現在の MCP 認証フローとアカウント権限を確認してください。エンドポイントを追加するだけでは、認証済みの HelpDesk 接続は確立されません。

1. RUBE_SEARCH_TOOLS が応答することを確認し、Rube MCP が利用可能であることを確かめます
2. ツールキット helpdesk を指定して RUBE_MANAGE_CONNECTIONS を呼び出します
3. 接続が ACTIVE でない場合は、返された認証リンクに従って HelpDesk の認証を完了します
4. ワークフローを実行する前に、接続ステータスが ACTIVE であることを確認します

主なワークフロー

1. チケットの一覧表示と閲覧

使用する場面：サポートチケットの取得、閲覧、またはページ送りを行いたい場合

ツールの実行順序：

1. HELPDESK_LIST_TICKETS - 並べ替えとページネーションを指定してチケットを一覧表示します［必須］

主なパラメーター：

• silo：チケットフォルダー。'tickets'、'archive'、'trash'、または 'spam'（デフォルト：'tickets'）
• sortBy：並べ替えフィールド。'createdAt'、'updatedAt'、または 'lastMessageAt'（デフォルト：'createdAt'）
• order：並べ替え順。'asc' または 'desc'（デフォルト：'desc'）
• pageSize：1 ページあたりの結果数。1～100（デフォルト：20）
• next.value：前方ページネーション用のタイムスタンプカーソル
• next.ID：前方ページネーション用の ID カーソル
• prev.value：後方ページネーション用のタイムスタンプカーソル
• prev.ID：後方ページネーション用の ID カーソル

注意点：

• ページネーションには、タイムスタンプと ID のペアを使うカーソル方式を使用します
• 前方ページネーションには、前回の応答に含まれる next.value と next.ID の両方が必要です
• 後方ページネーションには、prev.value と prev.ID の両方が必要です
• silo で一覧表示するフォルダーを指定します。デフォルトはアクティブなチケットです
• pageSize の上限は 100、デフォルトは 20 です
• アーカイブ済みチケットとゴミ箱内のチケットは、別々のフォルダーにあります

2. チケットビューの管理

使用する場面：チケットを整理するために保存されたエージェントビューを確認したい場合

ツールの実行順序：

1. HELPDESK_LIST_VIEWS - すべてのエージェントビューを一覧表示します［必須］

主なパラメーター：（必須項目なし）

注意点：

• ビューは、HelpDesk UI でエージェントが設定した、あらかじめ定義済みの保存フィルターです
• ビューの定義には、チケットの整理方法を理解するのに役立つフィルター条件が含まれます
• API からビューを作成または変更することはできません。HelpDesk UI で管理します

3. 定型返信の使用

使用する場面：チケットに使用できる定型（テンプレート）返信を一覧表示したい場合

ツールの実行順序：

1. HELPDESK_LIST_CANNED_RESPONSES - あらかじめ定義された返信テンプレートをすべて取得します［必須］

主なパラメーター：（必須項目なし）

注意点：

• 定型返信は、よくある返信用のあらかじめ定義されたテンプレートです
• 入力が必要なプレースホルダー変数が含まれている場合があります
• 定型返信は HelpDesk UI で管理します
• 返信内容には HTML 形式が含まれる場合があります

4. カスタムフィールドの確認

使用する場面：アカウントのカスタムフィールド定義を確認したい場合

ツールの実行順序：

1. HELPDESK_LIST_CUSTOM_FIELDS - すべてのカスタムフィールド定義を一覧表示します［必須］

主なパラメーター：（必須項目なし）

注意点：

• カスタムフィールドは、組織固有のデータを使ってデフォルトのチケットスキーマを拡張します
• フィールド定義には、フィールドの型、名前、検証ルールが含まれます
• カスタムフィールドは HelpDesk の管理パネルで設定します
• 値が入力されているフィールドは、チケット上に表示されます

よくあるパターン

チケット閲覧パターン

1. Call HELPDESK_LIST_TICKETS with desired silo and sortBy
2. Process the returned page of tickets
3. Extract next.value and next.ID from the response
4. Call HELPDESK_LIST_TICKETS with those cursor values for next page
5. Continue until no more cursor values are returned

チケットフォルダーの移動

Active tickets:  silo='tickets'
Archived:        silo='archive'
Trashed:         silo='trash'
Spam:            silo='spam'

カーソル方式のページネーション

Forward pagination:
  - Use next.value (timestamp) and next.ID from response
  - Pass as next.value and next.ID parameters in next call

Backward pagination:
  - Use prev.value (timestamp) and prev.ID from response
  - Pass as prev.value and prev.ID parameters in next call

既知の落とし穴

カーソルページネーション:

• カーソルナビゲーションにはタイムスタンプと ID の両方が必要です
• カーソルの値は ISO 8601 日時形式のタイムスタンプです
• 同じリクエストで前方カーソルと後方カーソルを混在させるのは未定義の動作です

サイロフィルタリング:

• チケットはサイロ(フォルダ)に物理的に分離されています
• サイロ間のチケット移動は HelpDesk UI で行います
• 各サイロのクエリは独立しており、サイロをまたぐ検索はありません

読み取り専用操作:

• 現在の Composio ツールキットは一覧表示/読み取り操作を提供します
• チケットの作成、更新、返信操作には追加のツールが必要になる場合があります
• 新しく利用可能になったツールがないか RUBE_SEARCH_TOOLS を確認してください

レート制限:

• HelpDesk API にはアカウントごとのレート制限があります
• 429 レスポンスに対してバックオフを実装してください
• タイムアウトを避けるため、ページサイズを適切に保ってください

レスポンスの解析:

• レスポンスデータは data または data.data の下にネストされている場合があります
• フォールバックパターンを用いて防御的に解析してください
• チケット ID は文字列です

クイックリファレンス

タスク	ツールスラッグ	主要パラメータ
チケットの一覧表示	HELPDESK_LIST_TICKETS	silo, sortBy, order, pageSize
ビューの一覧表示	HELPDESK_LIST_VIEWS	(なし)
定型文の一覧表示	HELPDESK_LIST_CANNED_RESPONSES	(なし)
カスタムフィールドの一覧表示	HELPDESK_LIST_CUSTOM_FIELDS	(なし)

使用する場合

このスキルは、概要で説明されているワークフローまたはアクションを実行する場合に適用されます。

制限事項

• このスキルは、タスクが上記で説明されている範囲に明確に一致する場合にのみ使用してください。
• 出力を、環境固有の検証、テスト、または専門家によるレビューの代替物として扱わないでください。
• 必要な入力、権限、安全上の境界、または成功基準が欠けている場合は、停止して確認を求めてください。