OpenMax ハウツーガイド
要約:要約
  • AIチケット分類器 LLMを使ってサポートチケットの読み取り、分類、優先順位付け、ルーティングを行い、手動トリアージの代わりに対応します。
  • 一部のSaaSオプションはチケット数に応じてスケールします。Zylosで自作を構築することで、インフラコストを予測可能に保ちます。
  • 有用なプロトタイプは、分類構造、ルーティングルール、レビューループを証明すべきです。パイロットのタイミングは、チケットソース、統合範囲、許可、分類法の準備状況に依存します。
  • セルフホスティングはチームがデータ処理をよりコントロールできるようにしますが、モデルコール、ログ、バックアップ、管理者アクセス、コネクタ権限は明示的なレビューが必要です。
  • ZylosはMITライセンスを受けています。初版ではモデルトレーニングは不要です。Zylosは公式にClaudeコードおよびCodexランタイムをサポートしています。

AIチケット分類器とは何ですか?

AIチケット分類器 着い込むサポートリクエストを読み取り、次のような構造化フィールドを提案します。 カテゴリー, 優先順位, 感情, 影響を受けた地域、および ターゲットキュー.ワークフローはまた、送信元メッセージを保持し、提案されたルートを説明し、不確実または制限のあるケースを指定されたレビュアーに送信すべきです。

キーワードベースのルール(「チケットに『パスワード』が含まれている場合→ITへのルート」)とは異なり、現代のルールは 自動チケット分類器 文脈を理解しています。同じ単語「フリーズ」は、銀行チケット(「口座フリーズ」)とSaaSチケット(「ダッシュボードフリーズ」)では全く異なる意味を持ちます。LLMベースの分類は、パターンマッチキーワードだけでなく、チケットの説明全体を読むため、この曖昧さを処理します。

レイヤー設計は、明確なケースには決定論的ルール、繰り返されるパターンには類似性マッチング、曖昧なリクエストには言語モデルを組み合わせることができます。チームは各レイヤーを個別に測定し、低信頼度、機密性、または影響の大きいチケットについては人間によるレビュー境界を保持すべきです。

着信チケット ルール すぐに明白な事例がわかりました ~60% 自動車 埋め込み 類似性チェック ~25% 自動車 LLMエージェント 曖昧な場合 ~15% LLM オートルート 人間のレビュー境界 一番難しいものだけ ~15% チケットの LLMに到達する。 実際のチケットで測定 査読者の訂正も含まれます 全LLMルーティングのことです。
レイヤードAIチケット分類器アーキテクチャ:LLM→埋め込みのルール→。最も難しいチケットはLLMまたは人間のレビューにエスカレーションされます。

ビルドか購入:チケット分類展開モデルを選択する

マネージドおよびセルフホストのチケット分類オプションを、同じ運用上の課題、すなわち総コスト、データパス、統合作業、継続的なメンテナンス、レビューコントロール、障害回復と比較してください。

  1. コストは展開モデルに従います。 マネージドサービスはプラン料金、使用料金、サポート料金を組み合わせることがあります。セルフホスティングワークフローはインフラストラクチャ、モデル、エンジニアリング、監視、インシデント対応作業を追加します。実際のチケット数とレビュー量の両方を考慮してください。
  2. データパスは明示的でなければなりません。 チケット本体、添付ファイル、ログ、モデル入力、レビュアーノート、バックアップがどこに送られるか、どれくらいの期間保持されているか、そして誰がアクセスできるかを確認しましょう。
  3. 統合の質はワークフローごとに異なります。 認証、フィールドマッピング、識別、レート制限、再トライ、重複防止、書き込み権限、ロールバックを、必要なチケットの送信元と目的地ごとにテストします。

ZylosやHxA Connectは、分類ロジック、コネクタの動作、運用制御を所有したいチームに適しています。シャドウモードで1つのチケットソースから始め、チームがエンジニアリングの成果を測定し、より広範な展開を選択する前に努力をレビューできるようにします。

ZylosでAIチケット分類器を構築する方法

Zylosは、チケット分類ワークフローのために状態、ツール、ハンドオフを管理できるオープンエージェントランタイムです。本番環境の準備状況は、チームのタクソノミー、コネクタ権限、境界のレビュー、監視、復旧計画に依存します。以下のステップで、これらの責任を実用的なパイロットに変えます。

1
Zylosの設定
クローン、インストール、LLM認証情報の設定、エージェントの実行確認
2
分類ルールを定義する
カテゴリ、優先度ルール、審査閾値、承認キューを定義します
3
チャンネル接続
ワイヤーチケットソース+ルーティング用のHxA接続アダプターの設定
4
デプロイと反復
管理された環境で展開し、品質を監視し、修正内容を確認しましょう

ステップ1:ZYLOSBRANDトークンエージェントフレームワークの設定

最速のセットアップのために公式インストーラーから始めましょう。LinuxサーバーかMac、Node.js ≥20、そしてCodexランタイム用のClaude Codeセットアップトークン/APIキー、またはOpenAIのAPIキーが必要です。

# Recommended: install Zylos
coco-runtime setup --init

# Optional: install from GitHub without cloning the repo
npm install -g coco-agent-runtime
zylos init

# Check services after setup
zylos status
# Web console is available on local console after initialization

テストメッセージを送信し、チケットデータやコネクタ権限を追加する前に、ランタイム、ログ、エラー経路を確認しましょう。

ステップ2:チケット分類構造を定義する

分類構造は、ワークフローが返す可能性のあるフィールドとその背後にあるビジネスルールを定義します。カテゴリ名は曖昧さを持たず、各カテゴリを承認されたキューにマッピングし、どのケースが必ずレビュアーに送られるべきかを文書化してください。以下の例は出発点であり、普遍的な分類法ではありません。

{
  "classification_rules": {
    "categories": [
      "bug_report",
      "feature_request",
      "account_issue",
      "billing_question",
      "integration_help",
      "performance_degradation",
      "security_incident",
      "general_inquiry"
    ],
    "priorities": ["critical", "high", "medium", "low"],
    "routing": {
      "bug_report":        { "target": "engineering-bot" },
      "security_incident": { "target": "security-bot" },
      "billing_question":  { "target": "billing-bot" },
      "feature_request":   { "target": "product-bot" },
      "account_issue":     { "target": "account-ops-bot" },
      "default":           { "target": "support-review-bot" }
    },
    "confidence_threshold": 0.85
  }
}

confidence_threshold はルーティング制御であり、普遍的なデフォルトではありません。レビュー済みのチケットでキャリブレーションを行い、提案、支援ルーティング、自動割り当てに異なる閾値を適用してください。機密性や影響の大きいカテゴリは、信頼度に関わらず人間のレビューが必要になることがあります。

ステップ3:チケットソースを接続し、チャンネルへルーティングする

チケットが来る場所に配線を設置しましょう 出典 そして彼らがどこへ行くのか から.HxA Connect — OpenMaxのボット間メッセージングサーバー — はハンドオフを担当しますので、 AIチケット分類器 構造化チケットの要約を正しい登録ボットやコネクターに送信できます。

// In the Zylos agent's skill configuration:
import { HxaConnectClient } from '@coco-xyz/hxa-connect-sdk';

const router = new HxaConnectClient({
  url: 'configured HxA endpoint',
  token: process.env.HXA_BOT_TOKEN,
  orgId: process.env.HXA_ORG_ID,
});

await router.connect();

// Register ticket intake sources
agent.on('ticket.received', async (ticket) => {
  // 1. Classify
  const classification = await agent.classify(ticket, rules);

  // 2. Route based on classification
  if (classification.confidence >= rules.confidence_threshold) {
    await router.send(classification.target, formatTicket(ticket, classification));
    console.log(`Routed ticket #${ticket.id} → ${classification.category}`);
  } else {
    await router.send('human-review-queue', formatTicket(ticket, classification));
    console.log(`Flagged ticket #${ticket.id} for human review (confidence: ${classification.confidence})`);
  }
});

分類出力がエージェント、チーム、コネクターボット間で移動する必要がある場合はHxA Connectをご利用ください。問題の作成、アラートの投稿、ヘルプデスクの更新など、プラットフォーム固有の操作は受信コネクターボット内に収まるべきです。

プロのコツ:まず1チャンネルから始めて、徐々に展開します

  • シャドウモード:チケットを分類し、ライブ割り当てを変更しずに結果をレビュアーに送ります。
  • アシストルーティング:レビュアーが高信頼度の課題を承認し、すべての修正を記録できるようにします。
  • 制御された自動化:テスト済みカテゴリのみ割り当てを有効にし、フォールバックキューと名前付けの所有者を用います。

この段階的な展開により、チームはチケット分類器を検証し、生産ルーティングを変更する前に確認できます。

ステップ4:展開、監視、反復

権限、ログ、秘密、キュー制限、ロールバックをテストできる環境でランタイムと分類器を展開し、ライブルーティングを有効にする前に:

# Run Zylos with the official container image
docker run -d --name zylos \\
  -p 3456:3456 \\
  -v zylos-data:/home/zylos/zylos \\
  -e OPENAI_API_KEY=$OPENAI_API_KEY \\
  ghcr.io/zylos-ai/zylos-core:latest

分類受理、訂正、再割り当て、エスカレーションの見逃し、レビュアーの労力、コネクターの故障、回復時間を監視します。カテゴリや言語ごとに結果をレビューし、強い平均値でも弱いまたは高リスクのルートを隠さないようにしましょう。

AIチケット分類器の比較:BuildとSaaSの比較

寸法 ビルド(Zylos + HxA Connect) Buy(SaaSクラシファイア)
コストモデル 予測可能なホスティング+LLMの使用 多くの場合、サブスクリプションや使用量ベースです
データパス チームが管理するデータパス;外部モデルおよびサービスコールは依然としてレビューが必要です データパスはプロバイダーのアーキテクチャや契約によって異なります
積分広さ HxA Connect + コネクタボットを通じたボット間ルーティング 利用可能なコネクタやAPIによります
カスタマイズ 分類構造、ルーティングルール、レビュー閾値の完全な制御 構成および拡張オプションはプロバイダーによって異なります
準備時間 分類、統合、権限、レビュー準備状況によります コネクタの構成、データ品質、チューニングによります
ランタイムの選択 Claude Code または Codex ランタイム 通常はベンダー管理のモデル選択です
コンプライアンス(SOC2、HIPAA、GDPR) チームは必要なコントロールを構築し検証します 提供者はコントロールを提供するかもしれませんが、顧客は依然として自らの義務を検証しています
ロックインリスク 移植可能なコードと設定;移行の取り組みは依然として統合やデータフォーマットに依存しています 移植性はエクスポートオプション、API、契約条件に依存します
作業適合度で選ぶ: マネージドサービスはインフラ作業を削減できる一方で、セルフホスト型ワークフローはより大きな実装管理と運用責任を提供します。同じチケットセット、権限、障害テスト、レビュアーの容量、総コストの前提と比較してみてください。

オープンランタイムがチケットワークフローに適合する場合

オープンランタイムは、チームが分類ロジック、コネクタコード、展開タイミング、証拠収集を直接制御する必要がある場合に役立ちます。このコントロールにより、チームは安全な設定、アップグレード、監視、復旧の責任も担います。

  • 事業ごとに分類されます。 カテゴリ、優先順位、エスカレーションルールを定義し、すべてのリクエストを一般的なテンプレートに押し付けるのではなく、サポート組織に合った境界を見直しましょう。
  • 監査可能性。 入力、分類バージョン、モデルまたはルール結果、信頼度、最終割り当て、査読者の訂正を記録し、誤ったルートを調査・再現できるようにします。
  • コントロールされたハンドオフ。 構造化された結果を承認されたキューやコネクターボットにルーティングし、受け取ったシステムにプラットフォーム固有の権限やアクションを強制させます。
  • 作戦指揮。 オープンスタックでは、チームはバージョンや展開タイミングを管理でき、アップグレード、セキュリティ、監視、復旧はチーム自身が担当します。

自動ルーティング前にチケット分類の検証を行う

シャドウモードで代表的な非特定チケットセットを使用し、カテゴリ、優先度、アサイン先、信頼度、エスカレーションを現在のサポートプロセスと比較してください。

分類

バージョンカテゴリの定義、例、除外事項、所有者、変更履歴を記載し、レビュアーがどのルールが適用されたかを把握できるようにします。

自信

カテゴリごとに閾値を設定し、不確実、新規、または競合するチケットを名前付きのレビューキューに送信します。

許可

提案、割り当て、優先度変更、フィールド更新、顧客返信権限は別々に行われます。

敏感なケース

セキュリティ、請求の紛争、法的脅迫、アカウント閉鎖、VIP、安全面の問題は人間の視点で確認してください。

分類精度、ルーティング精度、再割り当て率、エスカレーションリコール、SLAパフォーマンスが合意されたテスト期間内に安定してからのみ拡張してください。

よくある質問

AIチケット分類器とは何ですか?
AIチケット分類器 サポートリクエストを読み、カテゴリ、優先度、影響地域、ターゲットキューなどのフィールドを提案します。本番のワークフローは証拠を保存し、提案ルートを説明し、不確実で敏感、または影響の大きいケースについては人間のレビューを行わなければなりません。
なぜSaaSを買わずにチケット分類器を作るのでしょうか?
セルフホスティングは分類ロジック、コネクター、展開の制御をより強化できますが、インフラ、モデルコール、セキュリティ、監視、復旧の責任も加わります。同じチケットセット、データパス要件、レビュー負荷、運用コストの仮定を用いるマネージドサービスと比較してください。
チケット分類の品質はどのように測定すべきでしょうか?
同じ審査済みチケットセットで品質を測定します。受理された分類、訂正、再割り当て、エスカレーションの見逃し、レビュー担当者の作業量、コネクターの故障、回復をカテゴリや言語ごとに追跡し、ルーティング範囲を広げます。
既存のヘルプデスクにAIチケット分類器を統合できますか?
はい、ただし一行のアダプター請求ではなくワークフロー設計として扱ってください。チケットはウェブフック、APIポーリング、コネクターボットを通じて入力できます。分類器はカテゴリ、優先度、ターゲットチームなどの構造化されたフィールドを返します。HxA Connectは、その結果を適切な登録ボットやコネクターに渡し、問題の作成やヘルプデスクレコードの更新などプラットフォーム固有の操作を行います。
構築と展開にはどれくらい時間がかかりますか?
普遍的な展開期間はありません。プロトタイプは1つのチケットソースと小さな分類で検証できます。本番パイロットはコネクタのテスト、権限、フォールバックルーティング、監視、レビュアー準備も必要です。合意された受理基準が満たされた時点で稼働を開始し、固定された日数で稼働しないでください。

自分だけのAIチケット分類器を作る準備はできていますか?

ZylosはMITライセンスを受けており、無料で使用できます。最初のバージョンではモデルトレーニングは不要です。ランタイムは自社のインフラにデプロイしてください。

GitHubでZylosを入手してください

その他もご覧いただけます: HxA コネクト マルチチャネルルーティング用・ OpenMax Labs ドキュメントとガイドのために