オペレーション
オペレーションは、Fóirを通じて呼び出される自分のロジックです。HTTPエンドポイントをホストしてそのURLを登録すると、Fóirが署名付きペイロードをPOSTし、失敗時にはリトライし、結果を記録します。
起動のしかた
オペレーションは、コンソールのボタン、レコードエディターのフィールド、ライフサイクルフック、スケジュール、または公開APIの呼び出しから実行されます。それぞれに、入力と出力のスキーマから生成される専用の型付きGraphQLミューテーションが用意されます。たとえば、キーがai-summarizeのオペレーションは、executeAiSummarizeというミューテーションになります。前提条件と使用量クォータが、誰がどのくらいの頻度で実行できるかを決めます。
同期とバックグラウンド
同期モードでは、呼び出し元が待機し、レスポンスボディが結果になります。タイムアウトは既定で30秒で、最大5分まで設定できます。非同期モードでは、エンドポイントが202を返し、あとからコールバックトークンを通じて、進捗、完了、失敗、キャンセルを報告します。コールバックまでの猶予は既定で24時間で、それを過ぎると実行はタイムアウトとして扱われます。
リトライとデッドレターキュー
失敗した呼び出しはリトライされ、既定では3回です。サーキットブレーカーは5回の失敗で開き、60秒間呼び出しを拒否します。リトライを使い切ったキュー内の実行はデッドレターキューに入り、確認、リトライ、破棄ができます。呼び出しにべき等キーを付けると、リトライは最初の試行の実行を引き継ぐため、作業が二重に行われることはありません。
実行記録
すべての実行は、ステータス、所要時間、結果またはエラー、トリガー、リトライ回数、進捗とともに記録されます。
サードパーティAPIの呼び出し
パススルー書き込みには、自分のサービスは介在しません。FóirがリクエストテンプレートからサードパーティAPIを直接呼び出し、認証情報はシークレットから取得します。リゾルバーオペレーションは、サードパーティAPIをGraphQLのクエリまたはモデルのフィールドとして提供し、キャッシュとバッチ処理を備えます。
詳細を読む
オペレーションのガイドで、エンドポイントの登録、受け取るペイロード、2つのモードと実行履歴を説明しています。