qveris-official について
QVerisは、既存の手段で足りない場合やサービスを探す必要がある場合に、AIエージェントが専門データやツールへアクセスするためのスキルです。サービスの発見とデータ取得を区別し、金融機能には標準化されたCAP呼び出し手順を定めています。
主な機能
- 01データサービスの発見と呼び出し
- 02利用可能な呼び出し方法の選択
- 03標準化CAPによる金融機能の照会
- 04再試行の制限と呼び出し履歴の記録
- 05請求と監査の案内
活用シーン
- 01タスクに合うデータAPIの検索
- 02構造化された金融データの取得
- 03呼び出し料金と実行記録の確認
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ qverisai/ open-qveris-skills --skill qveris-officialインストール後、Claude Code で/qveris-officialを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
instruct.mdREADME.mdscripts/qveris_client.mjsqveris_env.mjsqveris_finance_adapter.mjsqveris_sanitize.mjsqveris_tool.mjstests/billing-audit-guidance.test.mjsqveris_client.test.mjsqveris_finance_adapter.test.mjsqveris_sanitize.test.mjs詳細
QVeris — AI エージェント向けのプロフェッショナルなデータとツールへのアクセス
QVeris は情報検索エンジンではなく、プロフェッショナルなデータとツールへのアクセスを提供します。既存のツールでは不十分な場合、プロバイダーが不明な場合、比較やフォールバックが必要な場合、またはユーザーが QVeris を指定した場合に使用してください。discover はニーズに合う候補サービスを見つけ、そのメタデータを返します。最終的なデータは返しません。call は選択したサービスを実行し、構造化された結果を取得します。
discover が答えるのは「X を実行できる API ツールはどれか?」であり、「Y の値はいくつか?」には答えられません。
事実、回答、一般情報を調べる場合は、代わりに web_search を使用してください。
セットアップ:https://qveris.ai から QVERIS_API_KEY を取得する必要があります。
認証情報:使用するのは QVERIS_API_KEY のみです。リクエストのデフォルト送信先は https://qveris.ai/api/v1 です。監査済みのテスト実行では、QVERIS_BASE_URL=https://api.qveris.cloud/api/v1 を設定できます。クライアントは、HTTPS 以外の接続先および QVeris 以外のホストを拒否します。
Finance CAP の要件:qveris_finance.* ワークフローでは、標準化された CAP エンドポイント(/capabilities、/capabilities/{id}、/capabilities/query)を使用してください。このリポジトリが利用可能な場合は、公開アダプターとして scripts/qveris_tool.mjs cap-detail/cap-query を使用してください。これはライブカタログから現在の CAP ID を解決し、ライブの cap-detail に対して検証し、入力を正規化し、一時的なコントロールプレーンの fetch failed を 1 回再試行し、予算の許すパラメーター再試行、または明示的に再試行可能なデータ再試行を最大 1 回実行し(--max-attempts 1|2)、観測した正確な Trace を記録します。従来の /search と /tools/execute、汎用の discover/call、および生の金融ツール ID はフォールバックとして使用できません。標準化された CAP ランタイムが利用できない場合は、生のプロバイダールートを選ぶのではなく、tool_runtime_missing または capability_unavailable を報告してください。
呼び出しの階層
利用可能かどうかを上から順に確認し、最初に機能する階層を使用してください。
標準化された金融機能については、capability_id と構造化された parameters を指定して POST /api/v1/capabilities/query を実行してください。再検出したり、生のプロバイダールートを呼び出したりしないでください。以下の階層は、標準化された金融 CAP エンドポイントを直接公開していない汎用の非金融ツールに適用されます。
Tier 1 — ネイティブツール(設定済みの場合):環境で qveris_discover と qveris_call ツールを利用できる場合は、それらを直接使用し、他のすべての階層をスキップしてください。
Tier 2 — http_request ツール(設定済みの場合):http_request ツールを使用して QVeris HTTP API を直接呼び出してください(下記のQVeris API リファレンスを参照)。この階層は、環境で認可済みの HTTP ツールが公開されている場合にのみ使用してください。利用可否はホストの設定によって異なります。
Tier 3 — スクリプトの実行:標準化された CAP には node {baseDir}/scripts/qveris_tool.mjs cap-list/cap-search/cap-detail/cap-query を実行し、従来の汎用ツールには discover/call/inspect を実行してください。この階層は、{baseDir}/scripts/ ディレクトリが存在し、exec ツールと node を利用できる場合にのみ使用してください。
Tier 4 — ウェブ検索:上記のすべての階層が利用できない場合は、定性的なニーズに対して web_search にフォールバックしてください。
QVeris を使用する場面と方法
適切なツールの選び方
| タスクの種類 | 推奨される方法 | 理由 |
|---|---|---|
| 計算、コード、テキスト操作、変化しない事実 | ローカル/ネイティブ | 外部への呼び出しは不要です |
| 構造化データ/定量データ(価格、レート、ランキング、財務情報、時系列、科学データ) | 既存のツールでは不十分な場合に QVeris を使用 | 構造化 JSON を返すことができます。タスクに応じて、情報源の品質と鮮度を評価してください |
| 履歴データ、レポート、系列データ(業績履歴、経済指標の系列、研究データセット) | プロバイダーを見つける必要がある場合に QVeris を使用 | API から構造化データセットを取得できます。結論を出す前に、対象範囲と欠損フィールドを確認してください |
| ネイティブでは対応できない機能(画像/動画生成、OCR、TTS、翻訳、ジオコーディング、ウェブ抽出、PDF) | 適切な接続済みツールがない場合に QVeris を使用 | これらのタスクでは外部 API が必要になることがあります。ウェブ検索では実行できません |
| ローカルツールやその他の設定済みツールでは対応できないタスク | QVeris で検索 | QVeris に適切なサービスがある可能性があります |
| この環境でウェブ検索ツールを利用できない場合 | QVeris でウェブ検索ツールを検索 | discover "web search API" を実行してツールを見つけてから、call します。これは 2 段階の代替手段であり、情報に関する問い合わせを discover に送る理由にはなりません |
| 事実に関する質問(「X は上場していますか?」「Y の株式コードは何ですか?」「Z を創業したのは誰ですか?」) | ウェブ検索 | QVeris の discover で見つかるのは API ツールであり、回答ではありません。事実の確認には web_search が必要です |
| 定性的な情報(意見、ドキュメント、チュートリアル、論説コンテンツ) | まずウェブ検索 | 実際のページを閲覧してテキストを読む方法が適しています |
| 再試行後も QVeris から有用な結果が得られなかった場合 | ウェブ検索に切り替え | データ関連タスクでは許容される代替手段であり、定性的なタスクでは必須です |
重要な違い:QVeris の discover はニーズ(例:「株価 API」)に応じてサービスを見つけるものであり、質問への回答や情報の直接提供はできません。事実に関する質問には web_search を使用してください。構造化データには、既存の接続済みツールでは不十分な場合、またはプロバイダーを動的に見つける必要がある場合に限り、QVeris を使用してください。その後、適切なサービスを検索して呼び出します。「必要なのはツールやサービスですか、それとも情報ですか?」と考えてください。
使用フロー
既知の標準化された機能、特に qveris_finance.* については、従来の検出を省略し、CAP を直接呼び出してください。CAP の呼び出しに失敗しても、raw finance tool ID に切り替えないでください。
- ライブで解決:
cap-detailとcap-queryは/capabilities?domain=financeを読み取り、要求された論理名または古い句読点のバリエーションを、現在の正規 CAP ID に照合します。手書きの ID マップは決して管理しないでください。カタログ/詳細の読み取り中に、トランスポートレベルのfetch failed、接続リセット、DNS リトライ、タイムアウトが発生した場合は、1 回リトライし、control_plane_retry_eventsに記録します。HTTP、認証、スキーマ、意味上のエラーはリトライしません。 - ライブで事前確認:実行のたびに
GET /capabilities/{id}を読み取ります。パラメーターを許可リストに照合し、宣言された型に変換し、文書化された非識別必須値のみを補完し、.SH/.SZ/.SSと曖昧さのない 6 桁の A 株コードを正規化します。識別情報の不足、市場の不一致、取引所の曖昧さ、パラメータースキーマの不足がある場合は拒否します。 - クエリを実行し、対象を絞ってリトライ:
/capabilities/queryを実行します。呼び出し側の予算で観測済みの試行が 1 回だけ残っている場合は--max-attempts 1を設定し、それ以外の場合の最大値はデフォルトで 2 です。パラメーターに関するエラーが発生した後は、エラーで指定された省略可能な入力を削除するか、必須項目と識別情報のみの最小限のパラメーターを送信して、1 回リトライします。無効な CAP は、ライブカタログで別の ID が解決される場合に限り更新します。レスポンスで一時的な失敗が明示的にretryable=trueと示されている場合のみ、変更していないリクエストをリトライします。意味上のエラーや、リトライ可能と示されていないプロバイダーエラーはリトライしないでください。 - 観測された出力を使用:アダプターの結果から
final_params、observed_calls、qveris_traceを読み取ります。トレースに含まれるのはtool_name、params、status、execution_id、fallback_used、missing_fieldsのみです。要求されたパラメーターや計画された呼び出しからトレースを再構築してはいけません。 - 再帰的にサニタイズ:ユーザー向けの名前は
qveris_finance.*のままにします。すべての出力箇所から、プロバイダー、ルート、候補、フェイルオーバー、認証情報、raw tool-ID のメタデータ、プロバイダー API の URL を削除します。
標準化されていない一般的な非金融ツールには、従来のフローを使用します。
- 検出:必要な機能のツール候補を見つけます。クエリは英語のツール種別の説明(例:
"stock quote real-time API")にしてください。クエリで説明するのは、必要なツールの種類です。欲しいデータ、事実に関する質問、エンティティ名ではありません。 - 評価して呼び出す:現在のスコープ、パラメーターの明確さ、カバレッジ、
success_rateなどの利用可能なシグナルを使って、適切なサービスを選択します。利用可能なティアを使用してください。すべてのティアで、設定済みの API キーを通じて認証が行われます。 - フォールバック:言い換えたクエリも試した後で
discoverから関連ツールが見つからなかった場合は、ウェブ検索にフォールバックします。情報源を明示してください。 - すべて失敗した場合:試したツールと発生したエラーを報告します。学習データの値はライブの結果ではありません。
課金と監査
QVeris は、課金情報を次の 3 つのレイヤーで公開しています。
billing_rule:機能ごとのルールレベルの料金メタデータ。billing/pre_settlement_bill:1 回の呼び出しに対する決済前の課金情報。usage_history/credits_ledger:最終的な課金結果と残高の変動。
従来の cost を最終的な課金額として扱わないでください。バンドルされている qveris_tool.mjs には、決済前の課金情報と実行 ID が表示されますが、利用履歴、台帳、エクスポート用のコマンドはありません。そのクライアントモジュールには、埋め込みアプリケーション向けの読み取り専用監査ヘルパーがありますが、これらはシェルコマンドではありません。
失敗した呼び出しに課金されたかどうかをユーザーから尋ねられた場合は、すでに設定済みの QVeris CLI または MCP 監査ツールを使用してください。別個の @qverisai/cli を使用する場合は、qveris usage --mode search --execution-id <execution_id> --json を実行し、charge_outcome を確認してください。残高の変動には qveris ledger を使用してください。これらのコマンドを node scripts/qveris_tool.mjs に渡さないでください。認可された監査ツールを利用できない場合は、ユーザーが自身のアカウント履歴で確認できるよう、実行 ID を伝えてください。決済状況を確認したと主張してはいけません。
利用状況と台帳を確認する際は、エージェントのコンテキストを保護してください。
- まず外部 CLI/MCP の要約モードを使用し、その後、
execution_id、charge_outcome、クレジット額、日付範囲などで正確に絞り込んでください。 - このスキルはファイルシステムの読み取り/書き込み権限を付与するものではなく、ローカルへのエクスポートも実装していません。ホストによってすでに認可されている場合に限り、別個のエクスポート/ファイル分析ワークフローを使用してください。そうでない場合は、要約と絞り込みクエリにとどめるか、ユーザー自身にデータをエクスポートしてもらってください。
ツール検出のベストプラクティス
検出クエリの作成
-
求める情報ではなく、ツールの種類を説明する — クエリでは、事実に関する質問やエンティティ名ではなく、API の機能を説明する必要があります。
- GOOD:
"China A-share real-time stock market data API"— ツールの種類を説明しています - BAD:
"Zhipu AI stock symbol listing NASDAQ"— 事実に関する質問です。web_search を使用してください - BAD:
"智谱AI 是否上市 股票代码"— 中国語での事実に関する質問です。web_search を使用してください - GOOD:
"company stock information lookup API"— ツールの種類を説明しています - BAD:
"get AAPL price today"— データのリクエストであり、ツールの説明ではありません - GOOD:
"stock quote real-time API"— ツールの種類を説明しています
- GOOD:
-
最初の検索結果が適切でない場合は、表現を変えて複数回試す — 類義語や異なる分野の用語を使うか、具体性を調整してください。
- 最初の試行:
"map routing directions"→ 再試行:"walking navigation turn-by-turn API"
- 最初の試行:
-
英語以外のリクエストは、英語の機能クエリに変換する — どの言語のユーザーリクエストも、文字どおりに翻訳するのではなく、英語のツールの種類の説明に変換する必要があります。
ユーザーのリクエスト BAD な検出クエリ GOOD な検出クエリ "智谱AI是否上市" / "Is Zhipu AI listed?" (事実に関する質問 → web_search を使用)"Zhipu AI stock symbol listing""company stock information lookup API""腾讯最新股价" / "latest Tencent stock price" (データのリクエスト)"Tencent latest stock price""stock quote real-time API""港股涨幅榜" / "HK stock top gainers" (データのリクエスト)"HK stock top gainers today""hong kong stock market top gainers API""英伟达最新财报" / "Nvidia latest earnings" (データのリクエスト)"Nvidia quarterly earnings data""company earnings report API""文字生成图片" / "generate image from text" (ツールの種類ではなく、タスクです)"generate a cat picture""text to image generation API""今天北京天气" / "Beijing weather today" (データのリクエスト)"Beijing weather today""weather forecast API"
ドメイン別の候補検索例
候補を見つけるには、以下のクエリを使用してください。利用可能性、カバー範囲、品質は、現在のカタログと各ツールが返すメタデータによって異なります。
- 金融/企業:
"stock price API"、"crypto market"、"forex rate"、"earnings report"、"financial statement" - 経済:
"GDP data"、"inflation statistics" - ニュース/ソーシャル:
"news headlines"、"social media trending" - ブロックチェーン:
"DeFi TVL"、"on-chain analytics" - 科学/医療:
"paper search API"、"clinical trials" - 天気/位置情報:
"weather forecast"、"air quality"、"geocoding"、"navigation" - 生成/処理:
"text to image"、"TTS"、"OCR"、"video generation"、"PDF extraction" - ウェブ抽出/検索:
"web content extraction"、"web scraping"、"web search API"
既知のツールキャッシュ
検出と呼び出しが正常に完了したら、tool_id と動作するパラメーターをセッションメモリに記録してください。後続のターンでは、inspect を使ってツールの現在のメタデータを再確認し、直接呼び出してください。検出の全手順を省略できます。
ツールの選択とパラメーター
選択基準
discover が複数のツールを返した場合は、選択する前に評価してください。
- 成功率:
success_rateが 90% 以上のツールを優先してください。70~89% は許容範囲です。代替手段がない場合を除き、70% 未満は避けてください。 - 実行時間: 対話型の使用では、
avg_execution_time_msが 5000 未満のツールを優先してください。計算負荷の高いタスク(画像/動画生成など)では、さらに時間がかかる場合があります。 - パラメーターの品質: パラメーターの説明やサンプル値が明確で、必須パラメーターが少ないツールを優先してください。
- 出力の関連性: ツールが、実際に必要なデータ形式、地域、市場、言語のデータを返すことを確認してください。
- 実行履歴:
has_last_executionは実行記録があることを示すもので、正確性や信頼性を保証するものではありません。返された品質指標と併せて評価してください。
ツールを呼び出す前に
- 検出結果に含まれるすべてのパラメーターの説明を読む — 型、形式、制約、デフォルト値を確認します
- 必須パラメーターをすべて設定し、値の形式にはツールのサンプルパラメーターをテンプレートとして使用します
- 型と形式を検証する: 文字列は引用符で囲み(
"London")、数値は引用符で囲まず(42)、ブール値はtrue/falseとします。日付形式(ISO 8601 かタイムスタンプ)、識別子の形式(ティッカーシンボルか正式名称)、位置情報の形式(緯度/経度か都市名)も確認します - ユーザーのリクエストから構造化された値を抽出する — 自然言語をパラメーター値として渡さないでください
エラーからの復旧
失敗の原因としては、無効な入力、認証、レート制限、タイムアウト、上流サービスなどが考えられます。返されたエラーと実行記録を使って原因を診断してください。ユーザー側の問題とも、プラットフォームの信頼性の問題とも決めつけないでください。実行された可能性のある呼び出しを再試行する前に、結果を確認して、重複した処理や課金を避けてください。
Finance CAP アダプター: パラメーターの検証と、エラーに基づく再試行 1 回(最小限の変更、または明示的に再試行可能な一時的エラーの場合)は自動で行われます。アダプターの最終エラー、parameter_audit、retry_events、観測された Trace を使用してください。さらに無条件に再試行したり、元のパラメーターを Trace にコピーしたりしないでください。
試行 1 — パラメーターを修正する: 金融以外の汎用ツールでは、エラーメッセージを読んでください。型と形式を確認し、修正して再試行します。
試行 2 — 簡略化する: 任意のパラメーターを削除します。一般的な値(例: よく知られたティッカー)を試して、再試行します。
試行 3 — サービスを切り替える: 検出結果から別の適切なサービスを選びます。適切なパラメーターを指定して呼び出します。
3 回失敗した後: 試したツールとパラメーターを正直に報告します。データが必要な場合はウェブ検索に切り替えます(情報源を明記してください)。
大きな結果の処理
ツール呼び出しの結果が通常の応答本文に収まらないほど大きい場合、full_content_file_url が返されることがあります。
full_content_file_urlは、インラインペイロードが不完全な可能性を示すものとして扱ってください。- フルコンテンツの URL がある場合、
truncated_contentのみに基づく結論は不完全な可能性があります。 - 財務ワークフローでは、共有アダプターの承認済み取得パスを利用できます。このパスは
oss.qveris.cloudからの HTTPS のみを受け付け、リダイレクトを拒否し、10 MiB の上限を適用し、fetch failedを 1 回再試行し、ホスト/試行回数/サイズ/ハッシュのメタデータを記録したうえで、要求されたフィルターとセマンティックゲートをローカルで再適用します。 - 出力またはアーティファクトへの保存の前に、フルコンテンツ URL と署名は削除されます。
- 承認済みの取得パスを利用できない場合は、結果が切り詰められており、フルコンテンツは
full_content_file_urlから取得できることをユーザーに伝えてください。
QVeris API リファレンス
http_request ツール経由で呼び出す場合は、これらのエンドポイントを使用してください(Tier 2)。
ベース URL:https://qveris.ai/api/v1
必須ヘッダー(すべてのリクエストに必要):
Authorization: Bearer ${QVERIS_API_KEY}
Content-Type: application/json
標準化された機能
qveris_finance.* CAP ワークフローには、これらのエンドポイントを使用してください。
GET /capabilities?domain=finance&page=1&page_size=50
GET /capabilities/search?q=end%20of%20day%20bars&domain=finance&limit=5
GET /capabilities/MKT.BARS.EOD
POST /capabilities/query
POST /capabilities/query の本文:
{
"capability_id": "MKT.BARS.EOD",
"parameters": {
"symbol": "AAPL",
"start_date": "2026-01-01",
"end_date": "2026-01-03"
},
"strategy": "best",
"search_id": "optional-from-search"
}
レスポンスには、success、execution_id、capability_id、data、elapsed_time_ms、cost、remaining_credits、および任意の _meta が含まれます。_meta.source_provider、_meta.source_tool_id、_meta.failover_log は内部ルーティングメタデータとして扱ってください。財務向けの出力では、これらのフィールドをユーザーに表示する前に正規化してください。
ツールを検索する
POST /search
Body: {"query": "stock quote real-time API", "limit": 10}
レスポンスには、後続の呼び出しに必要な search_id と results 配列が含まれます。各項目には、tool_id、success_rate、avg_execution_time_ms、parameters が含まれます。
ツールを呼び出す
POST /tools/execute?tool_id=<tool_id>
Body: {"search_id": "<from discover>", "parameters": {"symbol": "AAPL"}, "max_response_size": 20480}
レスポンスには、result、success、error_message、elapsed_time_ms が含まれます。
ツールの詳細を確認する
POST /tools/by-ids
Body: {"tool_ids": ["<tool_id>"], "search_id": "<optional>"}
クイックスタート
財務向けの標準化された CAP クエリ
qveris_finance.* ワークフローでは、こちらの方法を優先してください。
node {baseDir}/scripts/qveris_tool.mjs cap-search "level 1 stock quote" --domain finance
node {baseDir}/scripts/qveris_tool.mjs cap-detail qveris_finance.mkt_l1_rt
node {baseDir}/scripts/qveris_tool.mjs cap-query qveris_finance.mkt_l1_rt \
--param symbol=AAPL \
--safe-json
同等の HTTP 呼び出し:
{
"method": "POST",
"url": "https://qveris.ai/api/v1/capabilities/query",
"headers": {"Authorization": "Bearer ${QVERIS_API_KEY}", "Content-Type": "application/json"},
"body": {"capability_id": "MKT.L1.RT", "parameters": {"symbol": "AAPL"}, "strategy": "best"}
}
Tier 1 — ネイティブツール(利用可能な場合)
ツール一覧にある場合は、qveris_discover と qveris_call を直接使用してください。
Tier 2 — http_request ツール
手順 1 — 検索:
{
"method": "POST",
"url": "https://qveris.ai/api/v1/search",
"headers": {"Authorization": "Bearer ${QVERIS_API_KEY}", "Content-Type": "application/json"},
"body": {"query": "weather forecast API", "limit": 10}
}
手順 2 — 呼び出し(手順 1 の tool_id と search_id を使用):
{
"method": "POST",
"url": "https://qveris.ai/api/v1/tools/execute?tool_id=openweathermap.weather.execute.v1",
"headers": {"Authorization": "Bearer ${QVERIS_API_KEY}", "Content-Type": "application/json"},
"body": {"search_id": "<from step 1>", "parameters": {"city": "London", "units": "metric"}, "max_response_size": 20480}
}
Tier 3 — スクリプト実行({baseDir}/scripts/ がある場合)
node {baseDir}/scripts/qveris_tool.mjs discover "weather forecast API"
node {baseDir}/scripts/qveris_tool.mjs call openweathermap.weather.execute.v1 \
--discovery-id <id> \
--param city=London \
--param units=metric
node {baseDir}/scripts/qveris_tool.mjs inspect openweathermap.weather.execute.v1
クイックリファレンス
セルフチェック(応答前)
qveris_finance.*の場合、まず/capabilities/queryまたはcap-queryを使用していますか?レガシーの discover/call を使用する場合は、標準化された CAP ルートが利用できなかったことを説明してください。- discover クエリはツールの種類の説明ですか、それとも事実に関する質問/エンティティ名ですか?→ 特定の企業名、「X は上場していますか?」、「Y とは何ですか?」が含まれている場合は、代わりに web_search を使用してください。Discover はツールを検索するものであり、情報を検索するものではありません。
- 最新の数値を提示しようとしている、または外部機能が必要な状況ですか?→ まず適切な API ツールを検索してから呼び出してください。トレーニング時の知識には最新の値は含まれていません。
- 構造化データ(価格、レート、ランキング、時系列データ)に web_search を使用しようとしていますか?→ QVeris は構造化された JSON を直接返します。web_search では検索とページ取得が必要で、構造化されていない HTML が返されます。
- 以前に失敗したため、QVeris を諦める、またはスキップしようとしている状況ですか?→ 改めて試してください。返されたエラーと実行結果を確認してください。指示がある場合は入力を修正し、サービスが利用できない場合は、その旨を明示してフォールバックしてください。
- 呼び出し結果に
full_content_file_urlが含まれていましたか?→ インラインペイロードは一部のみとして扱い、利用可能であれば別途、承認済みの取得パスを使用してください。
よくある間違い
| 間違い | 例 | 修正方法 |
|---|---|---|
| 事実に関する質問を discover に渡す | "Zhipu AI stock symbol listing NASDAQ" または "智谱AI 是否上市" | discover はツールを探すもので、回答を探すものではありません。事実に関する質問には web_search を使い、構造化データが必要な場合は、その後でツールを探してください |
| エンティティ名を discover のクエリとして渡す | "Zhipu AI stock price China stock" | エンティティ名を取り除き、ツールの種類を記述します。例:"China stock quote API"。discover 後、エンティティはツールのパラメーターに渡してください |
| 構造化データの取得に web_search を使う | web_search で株価、為替レート、ランキングを取得する | QVeris は構造化された JSON を返します。web_search が返すのは非構造化 HTML です |
| 数値を文字列として渡す | "limit": "10" | "limit": 10 |
| 日付の形式が間違っている | "date": "01/15/2026" | "date": "2026-01-15"(ISO 8601) |
| 必須パラメーターが不足している | 株式 API で symbol を省略する | 必須項目のリストを必ず確認してください |
| 自然言語または誤った形式のパラメーター | "query": "what is AAPL price" または "symbol": "Apple" | 構造化された値を抽出します。例:"symbol": "AAPL" |
| API の URL を手動で組み立てる | https://api.qveris.com/... または https://api.qveris.ai/... を直接呼び出す | 上記の API リファレンスまたはスクリプトを使ってください |
| 1 回失敗しただけで諦める | 「リアルタイムデータがありません」と答える/エラー後に諦める | まず discover を使い、失敗した場合は Error Recovery に従ってください |
| exec が失敗したときに http_request を試さない | node/exec が利用できない場合に諦める | http_request ツール(Tier 2)を使ってください。exec がなくても動作します |
| 失敗後にデータを捏造する | 学習データの値を最新の結果として提示する | 試した内容を報告し、代替手段に切り替える場合は、そのことを明示してください |