モデルアプリやエージェントにキーや設定が必要
症状
Riff Home › モデルのカードに Needs an API key(API キーが必要)、Key not accepted(キーが受け付けられません)、Needs one setting(設定が1つ必要) と表示される。または、返信、投稿、チャットが、キー、設定、思考に関するメッセージで止まる。
別のパソコンのモデルアプリやエージェントが接続できない、または応答しない方へ。このパソコンの LM Studio や Ollama については LM Studio や Ollama に接続できない も参照してください。
カードの表示
| カードの表示 | 対処法 |
|---|---|
| Needs an API key(API キーが必要) | アプリがキーを求めています。カードに入力欄が表示されるので、キーを貼り付けて Save key(キーを保存) をクリックします。LM Studio のキーは Developer › Server settings › API tokens にあります。Hermes の場合は、エージェントの .env にある API_SERVER_KEY です |
| Key not accepted(キーが受け付けられません) | キーが間違っているか、アプリ側で変更されています。正しいキーを貼り付けて Save key(キーを保存) をクリックします |
| Needs one setting(設定が1つ必要) | アプリやエージェントは応答していますが、Riff を拒否しています。下記を参照してください |
| Not found(見つかりません) | Riff がアドレスに届きません。カードに確認すべき点が表示されます。アプリが起動しているか、ネットワークで待ち受けているか、トンネルが動いているか(ネットワーク上や https アドレスのモデルアプリ) |
設定が1つ必要
- LM Studio:サーバーの Enable CORS オプションをオンにして、Connect(接続) をクリックします。
- Ollama:
OLLAMA_ORIGINSで Riff を許可します。カードにコマンドが表示されます(LM Studio や Ollama に接続できない)。 - Hermes エージェント:Hermes は、ID が許可されるまでこの Riff を拒否します。カードに表示された行を
~/.hermes/.envに追加し(すでにその行がある場合はカンマの後に)、hermes gateway restartを実行してから Connect(接続) をクリックします(Hermes エージェントを接続する)。 - その他(OpenAI 互換):API キーと、ブラウザ拡張機能からのリクエストを受け付ける設定(CORS)になっているかを確認します。
返信の代わりにメッセージが出る
| メッセージ | 対処法 |
|---|---|
| LM Studio wants an API key. Add it in Home › Models.(LM Studio が API キーを求めています。Home › モデルで追加してください。) | 上の Needs an API key(API キーが必要) と同じです |
| … refused Riff. Check its API key and settings in Home › Models.(… が Riff を拒否しました。Home › モデルで API キーと設定を確認してください。) | 上の Key not accepted(キーが受け付けられません) か Needs one setting(設定が1つ必要) と同じです |
| … isn't answering. Is it running?(… が応答しません。起動していますか?) | アプリやトンネルを起動して、もう一度試します |
| … used its whole answer on thinking and wrote nothing.(… は回答をすべて思考に使い、何も書きませんでした。) | 次のセクションを参照してください |
| Hermes refuses this copy of Riff …(Hermes はこの Riff を拒否しています…) | 表示された拡張機能 ID の行を、上と同じ方法で追加します |
| Hermes can't use that session from here …(Hermes はここからそのセッションを使えません…) | そのセッションは Hermes の CLI かメッセージアプリで始まったものです。新しいチャットを始めます(エージェントとチャットする) |
| Hermes is busy with other runs.(Hermes は別の作業中です。) | 少し待ってから、もう一度送信します |
「回答をすべて思考に使った」
一部のモデル(Qwen など)は回答の前に思考し、その思考が書ける量をすべて使い切ってしまうことがあります。Riff はすでに、返信、投稿、投稿の読み取りを思考なしで依頼しており、チャットでも思考なしでもう一度試します。それでもメッセージが出る場合:
- モデルアプリで、そのモデルの思考をオフにするか、先に思考しないモデルを選びます。
- もう一度試します。
投稿の読み取りが Some models answer the "read the post" step with thinking or tool calls instead.(一部のモデルは「投稿を読む」ステップに、思考やツール呼び出しで応答します。) で失敗する場合も、同じ方法で解決できます。または、モデルで返信用に別のモデルを選びます。
エージェントでまだ解決しない場合は? 失敗した回答の下の Copy agent log(エージェントログをコピー) で、Riff とエージェントのやりとりを、キーを含めずにコピーできます。不具合の報告に添えてください。