リファレンス

トラブルシューティング

よくある問題と、その原因、解決方法です。

アプリが何度もログインを求める

アプリのアクセス権が取り消されたか有効期限が切れ、SPREVAが401を返しています。アプリからSPREVAを削除し、URLで追加し直してログインし、「許可」をクリックしてください。それでも繰り返す場合は、SPREVAのログインウィンドウがブロックされていないか確認してください。ポップアップブロッカーや厳しいプライバシー拡張機能がブロックすることがあります。

「このアクセストークンは、もう一方のSPREVAコネクタ用に発行されたものです」

SPREVA PublishingのURLでログインし、アプリが現在SPREVAのURLを呼び出しています。Publishingでのログインは、Publishingだけに有効です。SPREVAのURLでSPREVAを追加し直してください。2つのコネクタを参照してください。

「このエージェントを接続した人は、もうこのワークスペースのメンバーではありません」

接続は、それを許可した人の代理として動作します。その人がワークスペースを離れた場合は、現在もメンバーである人がアプリを接続し直す必要があります。

「APIキーが無効です」

キーが取り消されたか、入力が間違っています。キーはspreva_sk_で始まります。「開発者」、「APIキー」の順に開いて新しいキーを作成し、Authorization: Bearerの後にキーを続けて送ってください。

プランと上限

「このワークスペースには有効なプランがないため、読み取りはできますが変更はできません」

プランがなくても、エージェントはワークスペースを読み取り、投稿を削除できますが、それ以外の変更はできません。オーナーまたは管理者が、SPREVAの「設定」、「請求」の順に開いてプランを選べます。プランを参照してください。

AIクレジットが足りないとエージェントが言う

動画へのナレーションと画像の作成にはAIクレジットを使い、プレビューにはそのたびに残りのクレジットが表示されます。プランのクレジットは毎月更新され、パックで追加することもできます。

「呼び出しが多すぎます。このワークスペースでは、すべてのエージェントを合わせて1分間に120回まで呼び出せます」

1つのワークスペースで呼び出せるのは1分間に120回までで、接続したすべてのエージェントで共有します。それを超えると何も実行されず、応答に待つべき秒数が示されます。ほとんどのエージェントは自動で待ってから再試行します。同じ呼び出しを繰り返し続けるエージェントには、たいていもっと明確な依頼が必要です。

エージェントが動画を作成・編集できない

Studioのツールは、SPREVA PublishingではなくSPREVAコネクタにしかなく、Studioを含むプランが必要です。追加したURLとプランを確認してください。

探す

エージェントが投稿、ファイル、アカウントを見つけられない

まず検索するよう頼んでください。検索は寛容ですが、何かを変更するツールには正確な名前、@ユーザーネーム、またはリンクが必要です。SPREVAからリンクを貼り付ければ必ず見つかります。削除された投稿や連携を解除したアカウントは表示されず、接続からは自身のワークスペースしか見えません。

エージェントが、どれのことかを何度も聞いてくる

2つのInstagramアカウントや似た名前の2枚の写真など、名前が複数の対象に一致したため、SPREVAは推測せずに何も保存しませんでした。@ユーザーネームか正確なファイル名で答えてください。

「この投稿は、読み込んだ後に変更されました」

エージェントの作業中に、誰かが投稿を編集しました。何も保存されておらず、応答に現在のバージョンが含まれているので、エージェントはその上に変更を適用し直せます。

日時とタイムゾーン

投稿が間違った時刻に予約された

SPREVAは、「設定」、「一般」で設定したワークスペースのタイムゾーンで予約します。エージェントは「明日の9時」を、overviewから得た現在時刻をもとに解釈します。別のタイムゾーンのつもりなら、「ニューヨーク時間の午前9時」のようにそう伝えてください。どの応答もワークスペースの表現で時刻を繰り返すので、読み違いがあれば公開される前にわかります。

時刻に「オフセットがない」とエージェントに伝えられる

時刻には2026-11-02T09:00:00+00:00のようにオフセットが必要です。同じ時計の時刻でも、夏時間の切り替えの前後では別の瞬間になるためです。応答に修正した時刻が示されるので、エージェントはそれで再試行できます。

確認

公開する前に、エージェントが毎回確認してくる

これはリスクが高い操作の初期設定です。オーナーまたは管理者は、「エージェント連携」、「ポリシー」の順に開いて変更できます。「許可」にするとエージェントは確認せずに公開でき、「承認が必要」にすると代わりにアプリ内の人に依頼が送られます。

確認が使えなくなった

確認は10分以内に1回だけ使えます。もう一度頼むと、エージェントは新しいプレビューを受け取ります。

それでも解決しない場合

使っているアプリ、依頼した内容、エージェントの応答を添えて、info@spreva.aiまでご連絡ください。