フィードバックAPI

Layer 4: Extend Framework

フィードバックAPIは、候補への提案、観測、フィードバック方針を公開します。 提案と観測の契約型は saealib.core.contracts の公開語彙に属し、ビルダーと方針は saealib.policies から利用します。

グラフネイティブ経路の契約

ProposalBatch、ObservationBatch、FeedbackBatch、FeedbackContractはグラフネイティブ経路の契約です。対象、提案関係、順序、状態、出所、完了の意味論、および利用側が宣言する順序と完了を扱います。

saealib.core.contracts.ProposalBatch	A candidate population plus its relations and feedback requirement.
saealib.core.contracts.ObservationBatch	A fixed-schema batch whose candidate IDs are derived from subjects.
saealib.core.contracts.FeedbackBatch	Observations delivered for one proposal.
saealib.core.contracts.FeedbackContract	Declare the feedback deliveries a component can consume.

方針・ビルダー

saealib.FeedbackBuilder	Build algorithm feedback from true and predicted values.
saealib.TrueOnlyFeedback	Return completed true objective rows.
saealib.PredictedFeedback	Return the objective prediction channel.
saealib.MixedFeedback	Prefer true rows and fill the remainder from objective predictions.
saealib.NoFeedback	Return an empty feedback batch.

Stage互換型

FeedbackResult はStage互換経路で使う密な互換データ型です。配列の行整合性と候補IDの一意性はこの型の境界に属します。

saealib.FeedbackResult

Validated values supplied to an algorithm tell operation.