共通リクエスト
HTTP、Webhook、コードのいずれかのアクションで次の設定を使います。Zapier
Webhooks by Zapier → Custom Requestを使います。POSTを選択します。https://api.phaseo.app/v1/responsesを入力します。- Bearer認証とcontent-typeのヘッダーを追加します。
- 前のZapステップのフィールドを
inputに割り当てます。 - 機密情報を含まないデータでZapをテストします。
n8n
Bearer認証とJSONボディを設定したHTTP Requestノードを使います。構造化ワークフローデータを扱う場合は、n8n式で前段の項目をinputフィールドに割り当てます。
将来、n8nの公式コミュニティノードで、HTTPを手動設定せずにGenerate Response、List Models、Get Model Pricing、Create Embeddingなどを実行できるようになる可能性があります。
Pipedream
HTTPリクエストまたはNode.jsコードのステップを使います。PHASEO_API_KEYはPipedreamのシークレットとして保存し、ステップの環境から読み込みます。
本番環境での推奨事項
- 自動化ごとに使用するGateway APIキーに支出上限を設定します。
- 使用専用キーを自動化ごとに発行し、使用状況と失効を個別に管理します。
- 後続ステップが機械可読なフィールドを必要とする場合は、構造化出力を使います。
429や再試行可能な5xx応答に対するリトライ処理を追加します。- モデルステップが再試行されたという理由だけで、冪等でない外部アクションを再実行しないでください。