Call API ノード

​

このノードを使用する場面

• サードパーティのツール、CRM、CMS システム、分析プラットフォームからデータを取得する
• 外部の自動化や Workflows をトリガーする
• 後続の LLM ステップで使用する構造化データを取得する
• 別の場所でホストされているカスタムのビジネスロジックで Workflow の実行を強化する
• Profound Workflows を社内の API やマイクロサービスと連携する

​

ノードの設定

​

Method (必須)

• GET – API エンドポイントからデータを取得します
• POST – エンドポイントにデータを送信します。リクエストボディを含めることができます

​

URL (必須)

• 静的な URL を貼り付ける
• / を使用して変数を動的に挿入し、入力や前の Workflow ステップを参照する

• https://api.example.com/users/{{user_id}}
• https://internal.mycompany.com/search?q={{topic}}

​

POST リクエストの追加設定

​

Request Body

{
  "userId": 1234
  "action": "create",
  "payload": {
    "firstName": "Jack",
    "email":"jack@example.com"
  }
}

​

Content Type (POST の場合は必須)

• None
• Application/Json

​

Output Label

• api_response
• user_record
• external_data

​

詳細設定

​

Authentication Type (必須)

• None – 認証なし
• Basic – ユーザー名とパスワード
• Bearer – Bearer トークン
• API Key – カスタムの API キーヘッダー

​

Basic 認証

• Username
• Password

​

Bearer 認証

• Bearer Token

​

API Key 認証

• Header Name
• API Key Value

• Header Name: X-API-Key
• API Key Value: <your_key_here>

​

出力

• 解析、抽出、要約を行う LLM ステップ
• ロジックや変換のノード
• 後続の API 呼び出し
• 構造化または半構造化された外部データを必要とするあらゆるステップ

​

使用例

​

1. ユーザープロフィールのデータを取得する

1. 次の設定で Call API ノードを追加します。
   • Method: GET
   • URL: https://api.example.com/users/{{user_id}}
   • Output Label: user_profile
2. 分析や変換のために、{{user_profile}} を LLM ステップに渡します。

​

2. Workflow のデータを外部サービスに送信する

1. 次の設定で Call API ノードを追加します。
   • Method: POST
   • URL: https://hooks.example.com/events
   • Content Type: Application/Json

Request Body:{
  "transcript": "{{video_transcript}}", 
  "summary": "{{summary}}"
}

• Output Label: event_response

​

3. 認証が必要な API を使用する

1. Advanced settings で、適切な認証タイプを選択します。
2. 認証情報 (Bearer Token や API Key など) を指定します。
3. 必要に応じて GET または POST を使用し、保護されたデータを取得します。

​

ベストプラクティス

• ノードを設定する前に、API が想定するメソッド、ヘッダー、ペイロードの構造、認証要件を必ず確認してください。
• 変数を使用して URL やリクエストボディを動的に構築すると、Workflows の柔軟性が高まります。
• JSON を送信する場合は、正しい形式になっていることを確認してください。不正な形式の JSON はリクエストの失敗につながります。
• 特に複数の API 呼び出しを連結する場合は、出力ラベルをわかりやすくしてください。

​

トラブルシューティング

​

API がエラーを返す

• URL が正しいか
• 必須のクエリパラメーター
• 認証情報
• JSON ボディの構造 (POST の場合)

​

レスポンスが空、または想定外の内容である

​

変数が解決されない