環境チェックと確認
機能説明
SERVICEME プラットフォームのデプロイ完了後、管理者は環境チェックと確認作業を行い、モデル構成、システム依存関係、認証が有効な状態であることを確保する必要があります。
このステップは、システム機能(ドキュメント認識、音声認識、翻訳、RAG など)が安定して稼働するための重要なプロセスです。
チェック範囲
環境チェックは主に以下のモジュールを含みます:
| チェック項目 | 説明 | 必須かどうか |
|---|---|---|
| Model Set(モデルセット) | 標準サポート範囲内のモデル(GPT、Embedding、OCR、STT など)が含まれているかを確認します。 | はい |
| Model Group(モデルグループ) | 各モデルグループが正しく構成され、利用可能かを確認します。 | はい |
| Default Model Setting(デフォルトモデル設定) | デフォルトモデルとシナリオの紐付けが正しいかを確認します。 | はい |
| System / ENV 環境変数 | 主要なシステム変数およびモデル接続状態(OCR、Whisper、Embedding モデルの利用可否など)を確認します。 | はい |
チェック手順
モデル管理を開く
管理 > モデル管理 に入り、以下の内容を順に確認します:
モデルセット
- 以下の標準モデルが存在するかを確認します:
- LLM
- Embedding
- 不足している場合は、システム管理者に連絡してモデルセットを再インポートしてください。
モデルグループ
- 業務シナリオに応じてモデルグループが構成されているかを確認します。例:
- Chat / RAG / Translation / PDF Parsing / OCR など。
- 各モデルグループで参照されているモデルが、実際のサポート範囲と一致しているかを確認します。
デフォルトモデル設定
- 「デフォルトモデル設定」ページに入り、デフォルトで紐付けられているモデルを項目ごとに確認します(以下例):
- translate →
gpt-4.1-mini - gallery rednote →
gpt-4.1-mini - recommend config →
gpt-4.1-mini - gallery chat lead →
gpt-4.1 - optimize prompt →
gpt-4.1 - rag →
gpt-4.1 - i18n translation →
gpt-4.1-mini - gallery mindmap →
gpt-4.1-mini
- translate →
ヒント:計算量が多い、または推論能力が高く求められるタスク(知識検索、複雑な問題分析、Prompt 最適化など)には、より高性能なモデルを優先して選択してください。
ヒント:軽量なシナリオ(テキスト翻訳、要約生成、日常文書処理など)には、応答速度が速く、コストが低いモデルを選択し、パフォーマンスと効率のバランスを取ることができます。
よくある問題と対処
| 問題 | 考えられる原因 | 解決方法 |
|---|---|---|
| OCR 呼び出し失敗 | API Key が無効または正しく設定されていない | 環境変数でキーを再設定してください |
| Whisper 応答なし | モデルが有効化されていない、またはサーバー側でデプロイされていない | モデルグループの構成とデプロイ状況を確認してください |
| デフォルトモデル設定が空 | ライセンスが不完全またはインポート失敗 | ライセンスファイルと認証範囲を確認してください |
| 呼び出し遅延が大きい | 外部 API へのネットワークが不安定 | デプロイ地域と同じエリアのモデルサービス利用を推奨します |