Question 1

OpenAIのより安価なモデルを使用してTelegramの音声メッセージを文字起こしする際の 'Unsupported file format oga' エラーを修正する方法

Accepted Answer

Telegramの音声メッセージはLiveHelperChatによって.ogaファイルとして保存されますが、OpenAIの'gpt-4o-mini-transcribe'モデルは.oggのみを受け付けます。回避策：(1) .ogaを受け付ける古い'whisper-1'モデルを使用する（ただしコストが高い）。(2) 文字起こし前にカスタムREST APIステップを追加してファイル名を.ogaから.oggに変更するか、サーバーサイドスクリプトで拡張子を変更する。恒久的な修正として、Telegramの音声ファイル名を正規化することが議論されています。

Question 2

LiveHelperChatでfile_searchとfunction callingの両方を使用する際に、Geminiからテキストが抽出されない問題を修正する方法は？

Accepted Answer

LiveHelperChatを最新バージョンに更新してください。次に、新しい構文を使用して、parts配列内の任意の要素をテキストに対してチェックします。`candidates:0:content:parts:0:text` を `candidates:0:content:parts:__exist__:text` に置き換えて、任意のパーツからテキストを抽出します。ドキュメントを参照してください: https://doc.livehelperchat.com/docs/bot/rest-api#candidates0contentpartstext__exist__text-checks-that-array-item-has-key-text および https://doc.livehelperchat.com/docs/bot/gemini-integration

Question 3

Live Helper Chatの同一のGeminiボットリクエストで、知識ベース検索（file_search）とカスタム関数呼び出しの両方を使用する方法は？

Accepted Answer

Google Geminiは、ネイティブのfile_searchとカスタム関数宣言を1つのリクエストで組み合わせることを許可していません。回避策は、それらを別々のREST API呼び出しに分割することです。1つの呼び出しではfile_searchのみを使用してナレッジベースを検索し、もう1つの呼び出しでは人間のオペレーターへの転送などのアクションにのみ関数宣言を使用します。これらはボットトリガーを介して連鎖させることができます。別の方法として、LHCでカスタム関数を実装し、その関数が内部でGeminiのfile_searchを呼び出し、結果をメインのGemini呼び出しにフィードバックします。これにより、カスタム関数のみを使用して制限を回避します。パターンについては、Meilisearch-as-RAGガイドを参照してください：https://doc.livehelperchat.com/docs/bot/meilisearch-as-rag。これは、REST APIを使用してナレッジベースを検索し、結果をGeminiにテキストとして返す方法を示しています。

Question 4

Live Helper Chatで「TypeError: Argument 2 passed to erLhcoreClassCacheStorage::store() must be of the type array, int given」を修正する方法

Accepted Answer

これは、`$this->cacheTemplates` が配列ではなく整数になってしまう、破損/無効なテンプレートキャッシュデータが原因で発生します。

1. UIが利用できない場合は、破損したキャッシュファイルを手動で削除します：
```bash
find /opt/livehelperchat/lhc_web -type d -name cacheconfig -exec rm -f {}/*.cache.php \;
```
2. ログイン後、**Settings -> System -> Clean Cache** に移動します。
3. それでもエラーが解消されない場合は、`lhc_web/lib/core/lhtpl/tpl.php` を編集し、`cacheTemplates` を使用する前に配列ガードを追加します：
```php
if ($this->cacheEnabled == true
    && isset($this->cacheTemplates)
    && is_array($this->cacheTemplates)
    && key_exists(md5($fileTemplate.$instance->WWWDirLang.$instance->Language.$port), $this->cacheTemplates))
```
また、書き込みを行う前にも：
```php
if (isset($this->cacheTemplates) && is_array($this->cacheTemplates)) {
    $this->cacheTemplates[md5($fileTemplate.$instance->WWWDirLang.$instance->Language.$port)] = $file;
    $this->storeCache();
}
```
4. メンテナーによるキャッシュ修正が含まれる最新リリースに Live Helper Chat をアップグレードします。

`cacheconfig` ディレクトリ内の `*.cache.php` ファイルを削除することで、他の環境でも問題が解決した事例があります。

Question 5

Live Helper ChatでAuto bot introがREST APIアクションを持つGeneric Botトリガーをプレビューする際に、widgetrestapi/onlinesettingsからの503エラーを修正するにはどうすればよいですか？

Accepted Answer

503は、チャットレコードが存在する前に`processTriggerPreview()`がボットのイントロを実行することが原因で発生します。その後、REST APIアクションが永続化されていない`erLhcoreClassModelChat`に対して`updateThis()`を呼び出し、「The object of type erLhcoreClassModelChat is not persistent.」という例外をスローします。

直ちに適用できる回避策:
1. ウィジェットテーマで、**Auto bot intro**を無効にします。
2. または、Generic Botのイントロ/開始トリガーを編集し、チャットを更新するREST APIアクションを削除します。そのアクションを、実際のチャットが作成された後に実行されるトリガーに移動してください。
3. 対照として、そのボットを使用する部署では自動イントロを設定しないままにするか、イントロトリガーがREST APIを呼び出さないボットを割り当ててください。

恒久的なコード修正: `lib/core/lhgenericbot/actionTypes/lhgenericbotactionrestapi.php`で、1475行目付近の`updateThis()`呼び出しの前に、プレビュー/非永続チャットのコンテキストを検出し、チャットの更新をスキップするか安全にモックします。同様に、保存済みのチャットを必要とするREST APIアクションを`processTriggerPreview()`でスキップするようにします。以下で検証してください:

```http
POST /index.php/rus/widgetrestapi/onlinesettings
Content-Type: application/json

{"online":1,"theme":10,"mode":"widget","department":["1"]}
```

このエンドポイントは、503ではなくHTTP 200でウィジェット設定のJSONを返す必要があります。

Live Helper Chat

主な機能

できないこと

使用例

タグ

はじめ方

類似プロジェクト