人の承認を前提にしたサポートトリアージ向け、OpenAI互換プロバイダーでのCline利用

判断：トリアージを自動化し、顧客向けアクションは自動化しない

Clineは一般にコーディングエージェントとして説明されますが、構造化された入力を確認し、運用上の推奨事項を生成する必要がある場合にも、そのプロバイダーレイヤーを活用できます。顧客サポートで最初に導入するなら、トリアージと返信案作成のワークフローが安全です。

1. 新しいチケットと関連するアカウント情報を収集する。
2. 緊急度、トピック、考えられる次のステップをClineに分類させる。
3. 内部向けの根拠または要約と、返信案を生成する。
4. サポート担当者が推奨内容を承認、編集、または却下する。
5. その後に限り、既存のサポートシステムを通じてチケットを更新するか、返信を送信する。

Clineのドキュメントは、プロバイダーの認証情報、モデルID、ベースURL、ゲートウェイアクセス、メタデータ、利用状況の報告について説明しています。ネイティブなチケット管理連携や、組み込みの人による承認キューについては説明していません。承認レイヤーは、Clineを取り囲むアプリケーションコードとして扱ってください。

プロバイダー設定そのものについては、Clineのモデルプロバイダーに関するドキュメントを参照してください。

前提条件

連携を実装する前に、次の項目を確認してください。

• Clineの現在のセットアップ手順に従って、関連する@cline/agents、@cline/core、プロバイダーパッケージをインストールしたCline SDKプロジェクト。
• 使用するOpenAI互換サービスのAPIキー。
• そのサービスが提供する、文書化されたベースURLとモデルID。
• 不要な個人情報や機密情報を除外したサポートチケットのペイロード。
• レビューキュー、内部ダッシュボード、チケットステータスの遷移などの承認メカニズム。
• 特にセキュリティインシデント、返金、法的要請、アカウントアクセス、危害の脅迫に関する明確なエスカレーションポリシー。

OneMuxは、1つのOpenAI互換APIを通じて主要なAIモデルへのアクセスを提供し、モデルアクセス、ルーティング、キー、支出の可視化、クレジットの追加、従量課金での利用に重点を置いています。OneMuxのモデルカタログを確認したうえで、OneMuxのドキュメントで現在のエンドポイントとサポートされるパラメーターを確認してください。ここではOneMuxとの連携がテスト済みであるとは主張しません。互換性は、両サービスが文書化しているエンドポイントとパラメーターによって決まります。

ClineのOpenAI互換プロバイダーを設定する

Clineの文書化された設定では、providerId: "openai-compatible"、モデルID、APIキー、ベースURLを使用します。次の例では、デプロイメント固有の値をプレースホルダーのままにしています。

import { Agent } from "@cline/agents"

const agent = new Agent({
  providerId: "openai-compatible",
  modelId: process.env.SUPPORT_MODEL_ID,
  apiKey: process.env.PROVIDER_API_KEY,
  baseUrl: process.env.PROVIDER_BASE_URL,
})

PROVIDER_BASE_URLには、OpenAI互換サービスが文書化しているAPIのベースURLを設定してください。プロバイダーのマーケティング用WebサイトのURLを自動的に設定するものではありません。OneMuxを使用する場合は、想定したパスをコピーするのではなく、OneMuxクイックスタートまたは関連ドキュメントで現在のAPIエンドポイントとモデル識別子を確認してください。

Clineのソース概要では、プロバイダー設定に、コアまたはプロバイダー設定の型を通じてヘッダーやプロバイダー固有の設定を含められることも示されています。選択したエンドポイントがそれらをサポートし、Clineが想定どおりに引き渡すことを確認するまでは、カスタムヘッダーやリクエストパラメーターを追加しないでください。

モデルIDも同じく重要です。Clineの例にあるyour-model-nameはプレースホルダーです。プロバイダーのカタログに表示されるモデルが、APIエンドポイントでは異なるデプロイメントIDを使用する場合があります。IDが無効だと、サポートワークフローのロジックが実行される前にリクエストが失敗する可能性があります。

人の承認を伴うトリアージステップを構築する

最初のプロンプトでは、エージェントの出力を制約すると効果的です。機械可読な推奨事項を要求しつつ、最終アクションはモデル呼び出しの外部に置きます。

const ticket = {
  id: "ticket-123",
  subject: "Unable to access our workspace",
  message: "Our team is receiving an authorization error after signing in.",
  customerTier: "standard",
}

const result = await agent.run(`
Classify this support ticket for internal review.

Return JSON with these fields:
- category: one of access, billing, bug, how_to, security, or other
- urgency: low, medium, high, or critical
- summary: one short sentence
- suggestedNextStep: one concrete internal action
- replyDraft: a cautious draft for a support agent to edit
- requiresHumanEscalation: true or false

Never claim that an action was completed. Do not send a message, change account data,
or promise a refund. Escalate security, access-control, legal, and payment issues.

Ticket:
${JSON.stringify(ticket)}
`)

console.log(result)

アプリケーションでは、返された構造をレビュー担当者に表示する前に検証してください。人が、元のチケット、分類、根拠または要約、返信案を1か所で確認できるようにします。承認アクションは明示的にし、承認、編集して承認、却下、エスカレーションを選べるようにしてください。

requiresHumanEscalation: falseを自動送信の許可として解釈しないでください。これはモデルによる推奨にすぎません。モデルの出力にかかわらず、高リスクのカテゴリに対する独自のポリシーをアプリケーションで適用してください。

利用状況の可視化と運用上のガードレールを追加する

Clineのソースでは、エージェント結果に含まれる利用情報として、入力トークン、出力トークン、合計トークン、合計コストが説明されています。簡単な診断によって、プロンプトが想定外に大きくなっていないかを確認できます。

console.log({
  inputTokens: result.usage?.inputTokens,
  outputTokens: result.usage?.outputTokens,
  totalCost: result.usage?.totalCost,
})

利用可能な項目と正確なフィールドは、インストールしたClineのバージョンに照らして確認してください。チケットのコンテキストは簡潔に保ち、秘密情報をマスキングし、短い要約で足りる場合に会話履歴全体を繰り返し添付しないでください。現在のOneMuxの利用状況と料金情報については、OneMuxの料金ページを参照してください。価格が記載されていないことや、キャッシュ階層がサポートされていないことを、無料または利用可能であるとみなさないでください。

有用な制御には次のようなものがあります。

• チケット履歴の入力長に対する上限。
• 承認アクションを重複させないタイムアウトおよびリトライポリシー。
• プロンプト、モデルID、プロバイダールート、結果、レビュー担当者の判断、タイムスタンプの記録。
• 返金、アカウント変更、認証情報のリセット、セキュリティインシデントに対する自動実行のブロック。
• プロバイダーがパラメーターを拒否した場合や、形式が不正な出力を返した場合のフォールバックキュー。

OpenAI互換設定のトラブルシューティング

認証エラー

APIキーがプロセスから利用でき、設定したプロバイダーに属していることを確認してください。キーをログに記録しないでください。プロバイダーがカスタム認証ヘッダーを必要とする場合は、Clineのサポート対象プロバイダー設定がそのヘッダー形式を受け入れることを確認してください。提供されたドキュメントでは、ヘッダーが設定可能な領域であることは確認できますが、すべてのプロバイダーの要件を定義しているわけではありません。

404またはモデルが見つからないという応答

完全なベースURLとモデルIDを確認してください。有効なプロバイダー名であっても、選択したエンドポイントで特定のモデルIDが利用できるとは限りません。プロバイダーの最新のモデルドキュメントを使用し、必要に応じて、listProviders()やモデルカタログヘルパーなど、Clineのゲートウェイ検出メソッドを利用してください。

サポートされていないパラメーターのエラー

OpenAI互換であっても、同一仕様とは限りません。プロバイダーによって、サポートされるパラメーター、レスポンス形式、コンテキスト上限、ツールの動作が異なる場合があります。まずオプションのパラメーターを削除し、サポートを確認してから1つずつ追加してください。提供されたClineのソースでは、コンテキストウィンドウ、最大トークン数、料金、機能などのモデルメタデータが説明されていますが、プロバイダー間で機能の対応範囲が同一であるとは示されていません。

トリアージの出力が信頼できない、または不完全

これはプロバイダーの不具合の証拠ではなく、ワークフローの問題として扱ってください。出力スキーマを厳密にし、代表的な例を提示し、関係のないコンテキストを減らし、不確実なケースを人に回します。自社で承認したサポートデータを使った測定済みの評価なしに、精度、レイテンシ、コストが改善したと主張しないでください。

まとめ

Clineのopenai-compatibleプロバイダーを文書化された互換エンドポイントに向ければ、実用的なサポートトリアージワークフローのエージェントレイヤーとして利用できます。OneMuxはOpenAI互換APIを提供しているため、アクセス経路の候補になりますが、エンドポイント、モデル、認証、パラメーターの互換性は、前提とせず確認する必要があります。

持続的に運用できる設計は、意図的に範囲を限定します。Clineがチケットを分類して返信案を作成し、アプリケーションが結果を検証し、サポート担当者が次のアクションを承認します。この境界により、検証されていないモデルの推奨を監督なしで顧客向けの確定対応に変えることなく、運用担当者に有用な自動化手段を提供できます。

出典

• Cline: Model Providers — プロバイダー設定、OpenAI互換設定、ゲートウェイアクセス、モデルメタデータ、利用状況の報告。
• OneMux — 製品概要とOpenAI互換APIの位置付け。
• OneMuxドキュメント — 現在のエンドポイント、認証、モデル、パラメーターの詳細を確認するための資料。