helpdesk-automation

Rube MCP による HelpDesk の自動化

Rube MCP を介して、Composio の HelpDesk ツールキットを使用した HelpDesk のチケット管理業務を自動化します。

ツールキットのドキュメント：composio.dev/toolkits/helpdesk

前提条件

• Rube MCP に接続されている必要があります（RUBE_SEARCH_TOOLS が利用可能）
• RUBE_MANAGE_CONNECTIONS を通じて、ツールキット helpdesk のアクティブな HelpDesk 接続が必要です
• 最新のツールスキーマを取得するため、必ず最初に RUBE_SEARCH_TOOLS を呼び出してください

セットアップ

Rube MCP の取得：クライアントの設定で https://rube.app/mcp を MCP サーバーとして追加します。API キーは不要です。エンドポイントを追加するだけで動作します。

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	(なし)

---

Powered by Composio