WolframAlpha API 使い方:AI Flowi Workflowでの連携

WolframAlpha APIの使い方では、AI Flowi Workflowの連携でWolframAlpha APIコンポーネントを使い、計算用データ、事実、計算を扱います。必須のapp_idを指定し、input_valueにクエリテキストを入力して、Table出力を確認します。これは認証情報を使う外部クエリのインターフェースであり、カタログの基本的なCalculatorとは異なります。

WolframAlphaコンポーネントはカタログに記載されていますが、Ai Flowiによる本番環境でのテストは行われていません。以下のフィールドとポートの詳細は、2026年10月9日付のAI Flowi Workflow 1.9.2のエクスポートに基づきます。クエリの例は設定の演習であり、観測されたプロバイダーの回答ではありません。

執筆:Ai Flowi · 公開日

WolframAlpha APIのカタログ上の対象範囲

狭い画面ではWolframAlphaの仕様表をスクロールして、アプリケーション認証情報とクエリの列を確認してください。

コンポーネント一覧と対象範囲
コンポーネント / 識別子カタログの説明文このインターフェースの用途
WolframAlpha API
wolframalpha.WolframAlphaAPI
さまざまなトピックの計算用データ、事実、計算についてWolframAlphaに問い合わせ、構造化された応答を返します。計算や事実に関する情報を要求し、構造化された結果を確認します。

項目はwolframalpha.WolframAlphaAPIとして、カタログで識別します。説明文には複数のクエリの種類が挙げられていますが、すべてのトピックへの対応、数値精度、特定のデータソース、任意の要求への回答成功を示すものではありません。

関連情報:Yahoo Finance API 使い方:AI Flowi Workflowでのデータ連携。

認証情報と質問を分ける2つの入力

WolframAlpha API:入力仕様の全項目
入力型 / 必須接続可能な型 / 選択肢設定の意味
app_idstr / はい明示された空のリストプロバイダーのアプリケーション認証情報で、必須です。型はstrで、接続の型の一覧は明示的に空です。
input_valuestr / いいえMessage任意のクエリテキストです。型はstrで、接続可能な型としてMessageが記載されています。

アプリケーション認証情報は、質問ではなくapp_idに指定します。エクスポートには、保存済みアカウントの選択、代替の認証情報フィールド、自動検索のルールはありません。

input_valueは任意とされていますが、再現可能なクエリの試行には明示的なテキストが必要です。数量、単位、要求する操作が重要な場合は、そのテキストに記載します。この時点の情報では、単位、精度、前提条件の個別入力はありません。これらの要件は質問に明記し、実際の応答で確認する必要があります。

回答スキーマの記載がないTable

コンポーネント識別子別の出力ポート
コンポーネント識別子表示ラベルポート名型
wolframalpha.WolframAlphaAPITabledataframeTable

結果ポートはdataframeで、表示名と型はTableです。カタログには、回答列、単位列、ポッドの構造、状態フィールドはありません。値を取り出す前に、実際の結果を確認してください。構造化された応答に情報があっても、必要な回答が含まれるとは限りません。空でないTableをすべて成功と扱わず、意味を評価します。

計算の試行では、観測結果と返された解釈があれば、それらと並べてクエリを保存してください。プロバイダーが意図した数量を理解したか、表現に単位が保たれているかを確認します。詳細が公開されていない場合は、クエリの文言から推測した解釈を補わず、不確かさを記録してください。

WolframAlphaクエリと基本的なCalculatorの式

文書に記載されたコンポーネントの仕様で選ぶ
要件WolframAlpha APICalculator, utilities.CalculatorComponent
入力形式app_idと、input_valueに入力するクエリテキスト。expressionに入力する基本的な算術式。
カタログ上の用途さまざまなトピックの計算用データ、事実、計算。指定された式に対して基本的な算術演算を行います。
出力dataframeのTable。resultのJSON。
境界プロバイダーの解釈と応答スキーマの確認が必要です。対応する式の構文とJSON結果スキーマも確認が必要です。

このページはWolframAlphaの認証情報、クエリ、Tableの出力仕様を扱います。Calculatorを事実検索のサービスへ拡張するものでも、同じ文言に対して両方のインターフェースが同じ回答を返すと断定するものでもありません。

計算クエリを確認するフロー

アプリケーション認証情報、求める処理内容を別途把握できているクエリ、応答を確認する場所を用意します。認証情報の仕組みは接続ガイドに記載されています。認証情報を共有するワークフローのメモに埋め込まず、このコンポーネントが対応する設定を確認してください。

設定例であり、記録されたテストではありません

  1. WolframAlpha APIを、識別子wolframalpha.WolframAlphaAPIで追加します。必須のapp_idにご自身の認証情報を指定します。
  2. input_valueを例示の質問Convert 3 metres to centimetresに設定します。これは数量と両方の単位を指定するもので、観測された回答を断定してはいません。
  3. Chat Outputを追加し、WolframAlphaのdataframeを、Tableを受け付ける必須入力input_valueに接続します。
  4. 利用可能な解釈、単位、回答欠落の表示があれば、それらも含めて実際の応答を確認します。値を選ぶ前に、意図した質問と返された意味を比較してください。
  5. 観測したスキーマと、後の段階で必要となる正確なフィールドを記録します。対応関係が分かるまでは表示だけの試行にとどめます。ここでは、回答やポッドの列を想定して使ってはいません。

Chat Outputリファレンスは、確認する計算応答の表示設定を説明しています。

回答がない場合を明示的に扱う

意図した質問への使える回答、別の解釈に答える情報、処理は完了したが使える回答がない応答、実行エラーの4つの状態を分けて確認してください。各状態によって、後続へ適切に渡せるものが変わります。計算応答がない、または不明瞭だという理由だけで、モデルが生成した値に置き換えないでください。

確認の演習では、回答がなければそこで止め、明確にすべき入力や前提条件を記録します。後からこの判断を自動化する場合は、観測した実際の返却表現に基づいて分岐させます。このカタログには、フローへコピーできる回答欠落のフラグ名、エラーペイロード、自動復旧の分岐はありません。

単位が曖昧な試行は、単位が明確な試行とは別に繰り返します。数値らしい値が出るかだけを評価せず、解釈を確認してください。別の数量を正しく計算しても、ユーザーの質問への回答にはなりません。流暢な説明でも、観測していないプロバイダーの解釈は確定できません。

WolframAlpha以外のシステムを使うべき場合はいつですか?

この2つの入力には、タイムアウト、再試行、言語、精度、日付に関する出典、結果件数の設定はありません。出力スキーマにも、複数の返却項目から1つの回答を選ぶルールの記載がありません。無人で動く計算サービスとして扱う前に、作業に必要な詳細を確認してください。

精度と決定論的システムの適用範囲は、数値推論ガイドで扱っています。

数値以外も含めて単位換算を確認する

提案したメートルからセンチメートルへの質問では、応答の3つの部分、つまり解釈された数量、行われた操作、回答に付いた単位を別々に確認します。解釈が得られた場合は、その元の数量と単位を、記載どおりの要求と比較します。数値だけが見える場合は、回答の単位はまだ確認できていません。質問から単位を借りて、不完全な応答を十分に指定されたものに見せないでください。

2つ目の質問案として、変換先の単位を意図的に省いたConvert 3 metresを使うと役立ちます。目的は、利用環境のラッパーが不完全な要求をどう表現するかを確認することです。この演習には予測した回答はありません。解釈、確認要求、その他の返却情報を探し、作業の要件を満たすか判断してください。プロバイダーは実行を完了しても、ユーザーが求めた特定の換算結果を返さないことがあります。そのため、このインターフェースでは処理の完了と回答の十分さを別々に観測する必要があります。

次に、長さ、面積、体積に関する要求案を考えます。換算を採用する前に、単位名だけでなく数量の種類も読んでください。どちらもメートルに言及していても、面積についての応答は長さの質問への回答ではありません。複数の返却項目が見える場合は、要求した数量に答える項目と、追加情報である項目を識別します。Tableポートには回答を選ぶルールの記載がないため、最初の数値らしいフィールドを取る整形処理では、違う項目を選ぶ可能性があります。

表示画面に回答がないというだけで、回答が得られないと推測しないでください。元のノード結果を確認し、表示された表現と比較します。元の結果に使える回答があり、表示で単位や解釈が失われている場合は、表示処理を調べます。どちらにも必要な情報がなければ、回答なしという結果を保存します。実行が失敗した場合は、両方の状態とは別にエラーを保存してください。この区別によって、書式の問題を計算の失敗と説明することを避けられます。

換算ではなく事実に関する質問の場合は、値を選ぶ前に、返された出典や該当する時点の情報を確認します。別の期間の数値は、使えるプロバイダーのデータでも、要求した質問に答えないことがあります。その文脈が得られない場合は、適用できるかを未解決のままにしてください。次の段階は不足した詳細によって決まります。数量が曖昧なら質問を明確にし、情報が失われたなら表示を確認し、応答で必要な根拠を確定できなければ別の文書化された参照元を選びます。

計算クエリの利用量

ノードを1回実行するごとに1 Flowi Tokenを使用します。毎月の付与トークン数は、Goが5,000、Plusが10,000、Pro 100が50,000、Pro 200が100,000、Pro 500が250,000です。

ほかの外部参照元の仕様は、連携一覧で確認できます。