Skip to main content
以下はよくある質問の図解入り説明です。必要に応じてスクロールしてご覧ください。お探しの質問が一覧にない場合は、本ハンドブック内の該当機能の詳しい説明をご確認ください。
それでも解決しない場合は？ team@soloent.ai までメールで、以下の情報をお知らせください：
  1. ログインに使用しているアカウント（メールアドレス）
  2. ご利用のクライアントのバージョン番号
  3. 詳しい操作手順
  4. 必要な画面のスクリーンショット

​
ログイン時に起動確認のダイアログが表示されない

認可に成功すると、通常はブラウザが SoloEnt を開くかどうかを尋ね、ページ下部にも予備のボタンが表示されます：
  • ポップアップで Open SoloEnt を選び、デスクトップアプリの起動を許可します
  • ポップアップが出ない場合は、ページ上の Click here to open SoloEnt をクリックして手動で起動します
認可成功ページ：ブラウザが SoloEnt を開くか尋ねる様子と、ページ上の Click here to open SoloEnt 予備ボタン それでも反応がない場合、ほとんどはブラウザがポップアップをブロックしています。Chrome を例にすると：設定 → プライバシーとセキュリティ → サイトの設定（サイトによる位置情報・カメラ・ポップアップ などの使用を制御）に入り、account.soloent.ai に対してポップアップとリダイレクトを許可します。 Chrome の設定：プライバシーとセキュリティおよびサイトの設定の入り口 サイトの設定 で ポップアップとリダイレクト を開き、SoloEnt 関連のサイトを許可に設定してから、もう一度ログインを試してください。 サイトの設定内の「ポップアップとリダイレクト」オプション。サイトがポップアップを送信しリダイレクトを使用することを許可に設定

​
チャージ／アップグレードの入り口が見つからない

サブスクリプションコンソールへは、2 つの入り口から入れます：
  • 入り口 1：アカウントのアバターをクリックしてメニューを開き、Dashboard を選択すると account.soloent.ai/en/dashboard に移動します
アカウントのアバターメニューから Dashboard を選んでコンソールに入る
  • 入り口 2（v0.3.5 から）：右上の Agent 設定 → API 設定 をクリックすると、無料モデルリストの上に VIP へのアップグレードの案内と入り口があります。
設定で API Configuration を開き、無料モデルリストの下にある Upgrade subscription ボタン Web コンソール（Dashboard）に入ったら、Subscription Plan タブに切り替え、プラン（Lite、Pro、Max）と請求サイクル（月払いまたは年払い）を選択します。 コンソールの Subscription Plan タブでプランと請求サイクルを選択

​
サブスクリプションは返金できる？使い切ったらどうする？

コンソールでは、現在有効なプランのボタンが サブスクリプションをキャンセル と表示され、クリックして確認するとサブスクリプションがキャンセルされます。
  • キャンセル後、当期の会員費は 返金されません。特典は期末まで継続し、以降は自動更新されません
  • サブスクリプションの額度を使い切った場合は、上位プランにアップグレードできるほか、追加の額度を単体で購入 することもできます（注意：会員未加入の場合、額度を直接チャージすることはできません）
Web コンソールのサブスクリプションプランページ：Lite プランの Cancel subscription（キャンセル）と Buy add-on quota（額度の追加購入）の入り口
追加購入した額度は当月のサブスクリプション期間内のみ有効です。翌月の更新時、またはサブスクリプションの変更（アップ／ダウングレード、サイクル切替）時にはプランの基本額度に戻り、チャージ分は繰り越されません。
サブスクリプション管理の詳細は サブスクリプションの管理 と 支払いを完了する をご覧ください。

​
第三者の API Key はどう設定する？

SoloEnt は BYOK を無料で利用できます。 API 設定 ページで BYOK を選び、ドロップダウンリストから API サービスプロバイダーを選択するだけです。 API 設定で BYOK を選び、API Provider ドロップダウンでプロバイダーを選択 ほとんどの第三者プロバイダーの Key は OpenAI Compatible で設定する必要があります。 3 つのフィールドをすべて入力する必要があり、どれか一つでも欠けてはいけません：
  • Base URL
  • API Key
  • Model ID
BYOK 下で API Provider を OpenAI Compatible にし、Base URL・API Key・Model ID の 3 項目を入力 設定後に正常に使えない場合は、まずこの 3 項目が正しく入力されているか確認してください。購入前にはプロバイダーに確認を。一部の第三者サービスは不安定な場合があります。 ほとんどの公式プロバイダーの API も、入力する Base URL が正しければ OpenAI Compatible で設定できます。
第三者の API を使用する場合、API 呼び出しのエラーに関する問題の解決はサポートできません。エラーが出たときは、より安定した API に切り替えてご利用ください。
詳しくは API 設定 をご覧ください。

​
右側の Agent パネルが希望する言語で表示されない

SoloEnt は国際版です。ウェルカムページでインターフェース言語をある言語に変更しても、変わるのはメインウィンドウの一部の表示のみです。右側の Agent の言語は別途設定する必要があります。 ウェルカムページ／メイン画面の右上にある Language と Theme のオプション Agent パネル右上の設定アイコンをクリックし、一般設定で以下を構成します：
  • Preferred Language：AI が返信に使う言語、つまり Agent との対話で受け取る返信の言語を制御します
  • Interface Language：Agent パネルの表示言語（メニュー、ボタンなど）を制御します。简体中文、English、日本語、한국어、Español に対応
Agent パネルの一般設定にある Preferred Language と Interface Language の 2 項目

​
Agent がファイルを生成しない／保存しない／毎回手動保存を求められる

以下の 2 つの設定を順に確認してください。 1. 自動承認
Agent ウィンドウ右下の 自動承認 設定で 自動編集 を許可すると、Agent はあなたの承認なしにプロジェクトファイルへ書き込めるようになります。 有効になっていない場合、ファイルへの書き込みのたびに確認が必要です。詳しくは 自動承認 をご覧ください。 自動承認設定にあるプロジェクトファイルの読み取り・編集などの権限スイッチ 2. バックグラウンド編集（Background Edit） Agent 設定 → ツール設定（左側の 2 番目）の 編集 ブロックにある バックグラウンド編集 は、エディタのフォーカスを奪わずに バックグラウンドでファイルを変更してよいかを制御します。 原稿を直す前に必ず自分で確認したい場合は、ここをオフのままにしてください。そうしないと、気づかないうちに Agent がファイルを変更する可能性があります。 Feature Settings の Editor ブロックにある Background Edit スイッチ

​
Git のインストールを促される（checkpoints について）

Windows ユーザーが初めて SoloEnt を使うとき、図のような案内が表示されることがあります。これは Git がインストールされていないためですが、通常の利用には影響しません。 Git は対話中に状態のチェックポイント（checkpoint）を保存するために使われ、あるチェックポイントに戻ってやり直せるようにします。Mac には通常 Git がプリインストールされていますが、Windows では手動インストールが必要な場合がほとんどです。チェックポイント復元機能が不要なら、この案内はいったん無視して構いません。必要になったら git-scm.com からダウンロードしてインストールしてください。 SoloEnt パネル内の Git と checkpoints に関する案内バナー（Git must be installed to use checkpoints）

​
コンテキストウィンドウとは？いつ新しいウィンドウを開くべき？

各セッションウィンドウにはコンテキスト長の上限があります。 チャットボックスの上部で、現在のウィンドウのセッション上限と使用済みのコンテキスト量を確認できます。例えば下図の 30.2k / 300.0k——左が消費済みの token 数、右が現在のセッションのコンテキスト上限です。 SoloEnt チャットボックス上部のコンテキスト進捗バー。使用済み 30.2k、上限 300.0k を表示 コンテキストの消費が多くなると、モデルは初期の内容の記憶が曖昧になり、長いタスクでは方向がずれやすくなります。しかも 上限は大きいほど良いわけではありません——大きすぎるウィンドウはかえってモデルの注意を分散させ、コストを押し上げます。セッション上限は 200K–300K に抑えることをおすすめします。 次のような場合に新しいウィンドウを開くことをおすすめします：
  • 現在のタスクが完了し、次の独立したタスクを始めるとき
  • 単一ウィンドウで約 100–150K まで使ったとき（200K を超えて使い続けると、コストが急増する可能性もあります）
  • 現在の話題と無関係な新しい方向に切り替えるとき
目安として、単一ウィンドウが 100k を超えたら新しいウィンドウを開くことを検討しましょう。
新しいウィンドウを開く前に、/compact で現在のセッションを短い概要に圧縮したり、Agent に要点をまとめて SOLOENT.md に書き込ませたりできます。こうすれば、新しいウィンドウはゼロから token を積み上げることなく素早くコンテキストを復元できます。 詳しくは コンテキストウィンドウを賢く使う と SOLOENT.md ガイド をご覧ください。

​
なぜプロジェクトで SOLOENT.md が自動生成されなくなったの？

v0.2.0 以降、SOLOENT.md は 自動生成されなくなりました。プロジェクトのどの段階でも /init コマンドで手動作成できます。短い内容の場合や、セッションをまたぐコンテキスト追跡が不要な場合は、使わないという選択もできます。

​
なぜファイルが途中で失敗したり、繰り返し再生成されたりするの？

よくある原因は次のとおりです：
  • 書き込み中に手作業で割り込んだ：Agent がファイルを編集しているときに、自分で同じファイルを編集する、Agent の編集ボックスを閉じる、モデルの思考中に内容を変更するといった操作は、重複や切り詰めの原因になります
  • BYOK モデルの出力が切り詰められた：第三者接続モデルは最大出力長が制限されている場合があり、出力が切り詰められるとファイル書き込みのツール呼び出しが失敗します
  • クライアントのバージョンが古い：古いクライアントは新しいモデルへの対応が弱いため、現在のバージョンを確認し、最新に保ってください
  • 単一ウィンドウのコンテキストが長すぎる：コンテキストが長すぎると、モデルが返すツール呼び出しの形式が誤りやすくなります。SOLOENT.md メモリファイルを整理したうえで新しいセッションに移り、同じセッション内でずっと操作し続けないようにしましょう