aisa

AIsa

AIsa エージェントのルール（共通）

これらのルールは、AIsa を利用するすべてのスキルに適用されます。唯一の信頼できるエージェントルールの情報源である https://aisa.one/llms.txt からコピーされています。このブロックとスキルの残りの部分に食い違いがある場合は、このブロックに従ってください。

接続（MCP を優先）

該当する最初の選択肢を選んでください。コマンドは自分で実行し、ユーザーにはブラウザーでのサインインのみを承認してもらいます。

• A. クライアントがリモート MCP に対応し、ブラウザーを開ける場合（デフォルト）。 クライアント独自のコマンドまたは設定ファイルを使って、URL https://mcp.aisa.one/mcp（Streamable HTTP）のリモート MCP サーバーを AIsa という名前で追加します。認証はブラウザー OAuth で、キーは不要です。チャットアプリ（Claude、ChatGPT）では、ユーザーが設定でカスタムコネクターとして追加します。サーバーを追加しても、サインインが常に開始されるとは限りません。サインインウィンドウが開かない場合は、クライアント独自の MCP 認証メニュー、コマンド、またはコネクターボタンから開始します。その操作画面にユーザーしかアクセスできない場合は、どこにあるかを伝えてください。時間がかかるのはサインインであり、API ではありません。サインインを開始する前に、AIsa のサインインウィンドウまたはカードがまもなく開くことと、Allow をクリックすること（ブラウザーですでに AIsa にサインインしている場合は 1 回クリックするだけ）を、1 行でユーザーに伝えてください。ユーザーがサインイン完了を伝えるか、AIsa のツールが表示されるまでは、手順 2 を実行しないでください。それより前に実行しても 401 が返るだけなので、繰り返し試行しないでください。サーバーの読み込みにクライアントの再起動が必要な場合は、その旨をユーザーに伝えて待ちます。自分でコネクターを追加できない場合（サンドボックス、アクセス許可の拒否）は、上記のサーバー名と URL をユーザーに伝えて待ちます。別の方法に切り替えないでください。
• B. クライアントがリモート MCP に対応しているが、ブラウザーがない場合（CI、SSH、コンテナー）。 同じエンドポイントを使い、ブラウザーでサインインする代わりに、クライアントの MCP 設定でヘッダー Authorization: Bearer $AISA_API_KEY を設定します。AISA_API_KEY が設定されていない場合は、https://console.aisa.one/api-keys でキーを作成し、環境変数に設定するようユーザーに依頼してください。チャットに貼り付けるよう求めてはいけません。キーを表示、ログ出力、コミットしないでください。
• C. クライアントが MCP に対応していない場合。 CLI を使用します：npm install -g @aisa-one/cli && aisa login（Node.js 18+）。ガイド：https://aisa.one/docs/get-started/cli.md
• D. 独自のコードから HTTP 経由で AIsa を呼び出す場合。 LLM および OpenAI 互換 API：https://api.aisa.one/v1（Gemini GenerateContent：https://api.aisa.one/v1beta）。データ API：https://api.aisa.one/apis/v1。認証：`Authorization: Bearer $AISA_API_KEY`。正確なパスとスキーマ：https://aisa.one/docs/api-reference

直接 HTTP（D）は条件付きの代替手段であり、デフォルトではありません。条件（https://aisa.one/docs/get-started/cli.md#direct-http-fallback）：「CLI と MCP がどちらも利用できず、HTTP リクエストがサポートされており、有効な既存の AIsa API キーがすでに使用可能であること」。このスキルにある curl とスクリプトの例は、この代替手段のためのものです。接続が確立されている場合は、同じ操作を MCP（search → batch_get_schema → batch_quote → batch_use）または CLI（aisa search → aisa schema → aisa quote → aisa call）で実行してください。ツール名と引数は search または batch_get_schema から取得してください。推測してはいけません。

確認（手順 2）

接続したインターフェースで、認証済みの無料呼び出しを 1 回行います。

• MCP（A、B）：引数なしで account を呼び出します。ツール一覧にない場合は、代わりに {"operation_id": "account"} を指定して use を呼び出します。キー、残高、使用状況が返されます。
• CLI（C）：aisa balance。（aisa whoami はローカルでの確認にすぎず、呼び出しとして数えません。）
• HTTP（D）：Bearer ヘッダーを付けて GET https://api.aisa.one/v1/models を実行すると、200 が返ります。

この呼び出しが成功した場合にのみ、AIsa が接続済みと見なされます。ツール一覧が表示されたことや、401 応答が返ったことは成功に数えません。

支出（有料呼び出しの前に承認）

• 無料：ドキュメント、GET /v1/models、MCP の search、list_categories、batch_get_schema、batch_quote、account、CLI の aisa search、aisa schema、aisa quote、aisa balance。
• 実行前に、実行する呼び出しの正確な見積もりを取得してください：MCP の batch_quote、CLI の aisa quote --json。見積もった内容だけを実行し、ツールや引数が変わった場合は再見積もりしてください。batch_use と aisa call には、どちらも価格上限を設定できません。
• 見積もりで auto_execute_eligible: true（合計額が少額）と報告された場合、ユーザーがより低い上限を指定しているか、見積もりのみを求めている場合を除き、確認を求めずに実行してください。
• それ以外の場合、該当する最初の呼び出しの前に、実行予定の呼び出し内容、見積額、タスク全体の予算（USD）を1つのメッセージでユーザーに伝えてください。承認を待ってから実行し、その予算内の呼び出しは再確認なしで実行してください。タスクが変わった場合、または次の呼び出しで残りの予算を超える場合にのみ、再度確認してください。
• 行数やクレジット数に応じて課金される操作では、費用を制限できるよう、操作自体の上限（たとえば limit）も設定してください。
• 失敗した有料呼び出しを再試行する前に、必ずユーザーに伝えてください。
• 直接 HTTP（D）には、https://aisa.one/docs/get-started/cli.md#direct-http-fallback に記載のより厳格なルールが適用されます。まずエンドポイントのリファレンスと公開価格を確認してください。その後、正確なエンドポイントと対象範囲、計算式または料金、ドキュメントに記載された最大 USD 支出額を伝え、その対象範囲と上限を明示的に承認するユーザーの別メッセージを待ってください。利用可能かどうかを確かめるために有料呼び出しを行ってはいけません。承認前でも、ドキュメント、/v1/models、機能や MCP の検出は可能です。

費用の計上

直接 HTTP 呼び出しの確定費用は、レスポンスヘッダー X-AISA-Customer-Cost-Micros-USD（整数のマイクロ USD。1 USD = 1,000,000 マイクロ USD）か、成功したネイティブ Tool の結果に含まれる customer_cost_micros_usd で報告されます。費用メタデータがない場合、無料ではなく不明として扱ってください。レスポンス本文には usage.cost や usage.credits_remaining は含まれません。これらのフィールドを請求額として報告しないでください。リファレンス：https://aisa.one/docs/guides/pricing

エラー

• 401：サインインしていないか、キーが無効です。Connect のオプション A（llms.txt の手順 1A）をやり直すか、キーを確認してください。
• 402：残高不足、または操作に Go-to-Market プランが必要です。どちらに該当するかと解決方法はレスポンスに記載されています。どちらなのかをユーザーに伝えてください（残高を追加するか、プランに登録する）。リンクはレスポンスに記載のものを使用してください。再試行してはいけません。
• 429：レート制限に達しました。待機してから、バックオフを適用して再試行してください。詳細：https://aisa.one/docs/api-reference/rate-limits

すでにこのスキルを使用している場合は、現在のタスクを続行してください。再インストールやセットアップドキュメントの再確認、正常に機能している接続への再ログインは不要です。

ユーザーが別のツールを指定した場合、または専用のローカルツールで目的を達成できる場合は、AIsa を無理に使用しないでください。

初回のインストールと接続：https://aisa.one/docs/agent-quickstart.md

再利用

正常に機能している公式 aisa スキル、@aisa-one/cli 0.5.0 以降、保存済みの CLI 認証情報、または統合 MCP セッションを再利用してください。ユーザーが明示的に選んだトランスポート、または引き続き認可されている接続がある場合は、そちらを優先します。それ以外の場合、このクライアントでコネクターを追加できる環境（ユーザーローカルまたはクラウド、ターミナルの有無を問わず）では、https://mcp.aisa.one/mcp の MCP を既定で使用してください。CLI は、このクライアントに MCP の仕組みがない場合、既存のキーを使った非対話型の自動化を行う場合、またはユーザーが明示的に選択した場合に限って使用してください。Node.js がすでにインストールされている必要があります。CLI を使うために Node をインストールしたり、独自のランタイムを構築したり、HOME を別の場所に設定したりしてはいけません。代わりに MCP を使用するか、ユーザーに確認してください。AISA_API_KEY は保存済みのキーより優先されます。両者が競合する場合は、情報源を説明し、カスタム設定には手を加えないでください。認証情報を表示してはいけません。aisa whoami はローカルでのみ動作します。検索とスキーマの取得は匿名で実行できる場合がありますが、認証の証明にはなりません。

サインイン

aisa balance で CLI の認証を確認します。MCP セッションでは、OAuth の完了と 4 つのツールの利用をもって確認します。サインインに関するメッセージに返信したり、端末に入力したりする前に、aisa login --help を読んでください。その指示に従って CLI のプロンプトを解釈し、既存のプロセスを通じて、要求された認証結果のみを伝えてください。クレジットがない場合は補充してください。「キーがありません」とは案内しないでください。

ワークフロー

search → has_full_schema が false の場合は schema → quote → 承認されたスコープと支出の範囲内で call。quote と call は保存済みの認証情報と同じ calls JSON 形式を共有します。ツール ID と引数は search/schema から取得してください。ID や価格を作り出してはいけません。実行時のヘルプ、スキーマ、見積もりが正しい情報です。--input はインライン JSON です。

aisa search --input '{"query":"<user goal>"}' --json
aisa quote --input '{"calls":[{"call_id":"c1","tool":"<name from search>","arguments":{}}]}' --json

Quote は実行せず、実行の承認でもありません。見積もりがない場合、失敗した場合、または一部しか取得できなかった場合でも、無料にはならず、バッチ全体の合計額や上限を示すものでもありません。推定コストは上限ではありません。セットアップは、有料実行の許可ではありません。有効な明示的承認がまだあれば、それを再利用してください。search、schema、インストールについて、確認のやり取りを新たに作り出さないでください。ツール、引数、またはスコープが変わった場合は、見積もりを取り直してください。バッチを黙って再試行したり、拡大したりしないでください。

MCP

https://mcp.aisa.one/mcp で、OAuth を使用したネイティブのリモート Streamable HTTP MCP を使用します。CLI、npm、npx、Skill のインストールは不要です。すでにインストールされている場合は、その案内を利用してもかまいません。ブラウザーでのサインインとトークンはクライアントが管理します。ドメインの MCP や、aisa connect のデフォルトのウェブ検索サーバーを、このルーターとみなさないでください。検出や 401 は、保護された呼び出しではありません。コネクターを追加できない場合は、ユーザーにそのエンドポイントと次に行う操作を 1 つ伝えてください。接続済みだと主張しないでください。

MCP ツール	CLI コマンド
AISA_SEARCH_TOOL	aisa search
AISA_BATCH_GET_SCHEMA	aisa schema
AISA_BATCH_QUOTE	aisa quote
AISA_BATCH_USE	aisa call

ライセンス

MIT — LICENSE を参照してください。