Clarify は品目データから入力可能な回答を事前入力します。残りを確認または 修正してから確定します。
GraphQL
適用プログラムが分かったら( コンプライアンス要件の確認 を参照)、推奨フローは 3 つの呼び出しです。
complianceQuestionnaireInfer
questionnaireAnswersSubmit
questionnaireSessionAttest
すべての回答が既にある場合は、以下の 完全なレスポンスの送信 を参照して 1 回の呼び出しで完全なレスポンスを送信できます。
読み取りには COMPLIANCE_READ スコープが必要です。回答の送信には COMPLIANCE_WRITE が必要です。OAuth を参照してください。
COMPLIANCE_READ
COMPLIANCE_WRITE
すべての回答 value は JSON エンコード された文字列です。ブール値は "true"、 選択またはテキスト値は "\"cosmetic\"" のように引用符付き、 マルチセレクトは "[\"a\",\"b\"]"、数値は "42" です。
value
"true"
"\"cosmetic\""
"[\"a\",\"b\"]"
"42"
complianceQuestionnaireInfer は品目に適用されるプログラムを解決し、 セッション を開始し、品目データから質問に事前回答します。各事前入力回答には provenance: INFERRED と confidence スコアが付きます。
provenance: INFERRED
confidence
推論をガイドするために intendedUse を渡します — ストアフロントフローでは CONSUMER を送信してください。
intendedUse
CONSUMER
mutation InferQuestionnaire($input: ComplianceQuestionnaireInferInput!) {
complianceQuestionnaireInfer(input: $input) {
session {
id
status
lines {
programId
currentQuestion {
code
prompt
answerType
}
lineId
state
remainingRequiredCount
各ラインの state は次に何をすべきかを示します。
READY_TO_ATTEST
PARTIAL
currentQuestion
NOT_INFERRED
既存のレスポンスですでに満たされているプログラムはスキップされ、 alreadySatisfied に返されます(上記では省略)。
alreadySatisfied
セッションには 事前入力された回答 — 確定済みレスポンスではありません が 保持されます。各回答について、荷送人は次のいずれかを行います。
INFERRED
MANUAL
1 つの回答または複数を一度に送信できます。Clarify は currentQuestion を 次の残りの質問に進め、残りがなくなるとラインの レスポンス を確定します (responseId が設定されます)。
responseId
1 つの回答を修正しても、その回答だけが上書きされます。確定されたレスポンスには 完全な セットが保持されます — 承認された回答は INFERRED のまま、 修正は MANUAL — そのため、AI が提供した内容と人が変更した内容の記録が 常に残ります。
たとえば、荷送人は推論された intended_use を承認しますが contains_color_additives を修正するため、その 1 つの回答だけを送信します。
intended_use
contains_color_additives
mutation SubmitAnswers($input: QuestionnaireAnswersSubmitInput!) {
questionnaireAnswersSubmit(input: $input) {
answers {
questionCode
provenance
ラインが READY_TO_ATTEST — すべての必須回答が既に事前入力され、 荷送人が同意 — の場合、questionnaireSessionAttest で 1 回の呼び出しで 承認します。対象となるすべてのラインを確定するか、渡した lineIds のみを 確定します。
lineIds
mutation AttestSession($input: QuestionnaireSessionAttestInput!) {
questionnaireSessionAttest(input: $input) {
進行中のセッションを破棄するには、questionnaireSessionAbandon(id: ID!) を 呼び出します。
questionnaireSessionAbandon(id: ID!)
すべての回答が既にある場合 — たとえば CATALOG_ITEM の再利用可能な 回答セット — セッションをスキップして questionnaireResponseSubmit で 直接送信できます。同じ品目とプログラムの以前のレスポンスを置き換えます。
CATALOG_ITEM
questionnaireResponseSubmit
mutation SubmitResponse($input: QuestionnaireResponseSubmitInput!) {
questionnaireResponseSubmit(input: $input) {
completedAt
推論なしで回答しますか?questionnaireSessionStart で選択したプログラムの セッションを開始し、上記と同じ 確認と修正 および 証明 の呼び出しを 使用します。
questionnaireSessionStart
questionnaireResponse(id) で確定済みレコードを取得し、 containerComplianceReadiness でコンテナ全体の申告準備状況を確認できます — すべてのラインに完全なレスポンスがある場合にのみ ready は true です。
questionnaireResponse(id)
containerComplianceReadiness
ready
true
query ContainerReadiness($containerType: ContainerType!, $containerId: ID!) {
containerComplianceReadiness(
containerType: $containerType
containerId: $containerId
) {
totalLineCount
outstandingLineCount
ComplianceQuestionnaireInferInput QuestionnaireAnswersSubmitInput QuestionnaireResponseSubmitInput QuestionnaireSessionAttestInput
complianceQuestionnaireInfer questionnaireAnswersSubmit questionnaireResponseSubmit questionnaireSessionAttest
アンケートの完了
アンケートの完了
Clarify は品目データから入力可能な回答を事前入力します。残りを確認または 修正してから確定します。
GraphQL
適用プログラムが分かったら( コンプライアンス要件の確認 を参照)、推奨フローは 3 つの呼び出しです。
complianceQuestionnaireInferで品目データから事前入力された 回答付きのセッションを開始します。questionnaireAnswersSubmitで荷送人が同意しない回答を 変更し、残りに回答します。questionnaireSessionAttestで承認して確定します。すべての回答が既にある場合は、以下の 完全なレスポンスの送信 を参照して 1 回の呼び出しで完全なレスポンスを送信できます。
読み取りには
COMPLIANCE_READスコープが必要です。回答の送信にはCOMPLIANCE_WRITEが必要です。OAuth を参照してください。すべての回答
valueは JSON エンコード された文字列です。ブール値は"true"、 選択またはテキスト値は"\"cosmetic\""のように引用符付き、 マルチセレクトは"[\"a\",\"b\"]"、数値は"42"です。推論と事前入力
complianceQuestionnaireInferは品目に適用されるプログラムを解決し、 セッション を開始し、品目データから質問に事前回答します。各事前入力回答にはprovenance: INFERREDとconfidenceスコアが付きます。推論をガイドするために
intendedUseを渡します — ストアフロントフローではCONSUMERを送信してください。mutation InferQuestionnaire($input: ComplianceQuestionnaireInferInput!) {complianceQuestionnaireInfer(input: $input) {session {idstatuslines {idprogramIdstatuscurrentQuestion {codepromptanswerType}}}lines {lineIdstateremainingRequiredCount}}}各ラインの
stateは次に何をすべきかを示します。READY_TO_ATTEST— すべての必須質問に回答済み。以下の 証明 に進みます。PARTIAL— 一部の回答が事前入力されましたが、必須質問が残っています。currentQuestionで回答してください。NOT_INFERRED— 事前入力できませんでした。通常のアンケートとして回答します。既存のレスポンスですでに満たされているプログラムはスキップされ、
alreadySatisfiedに返されます(上記では省略)。確認と修正
セッションには 事前入力された回答 — 確定済みレスポンスではありません が 保持されます。各回答について、荷送人は次のいずれかを行います。
INFERREDのままにする、またはquestionnaireAnswersSubmitで新しい値を送信し、MANUALになります。1 つの回答または複数を一度に送信できます。Clarify は
currentQuestionを 次の残りの質問に進め、残りがなくなるとラインの レスポンス を確定します (responseIdが設定されます)。1 つの回答を修正しても、その回答だけが上書きされます。確定されたレスポンスには 完全な セットが保持されます — 承認された回答は
INFERREDのまま、 修正はMANUAL— そのため、AI が提供した内容と人が変更した内容の記録が 常に残ります。たとえば、荷送人は推論された
intended_useを承認しますがcontains_color_additivesを修正するため、その 1 つの回答だけを送信します。mutation SubmitAnswers($input: QuestionnaireAnswersSubmitInput!) {questionnaireAnswersSubmit(input: $input) {statuslines {idstatusresponseIdanswers {questionCodevalueprovenanceconfidence}}}}証明
ラインが
READY_TO_ATTEST— すべての必須回答が既に事前入力され、 荷送人が同意 — の場合、questionnaireSessionAttestで 1 回の呼び出しで 承認します。対象となるすべてのラインを確定するか、渡したlineIdsのみを 確定します。mutation AttestSession($input: QuestionnaireSessionAttestInput!) {questionnaireSessionAttest(input: $input) {idstatuslines {idstatusresponseId}}}進行中のセッションを破棄するには、
questionnaireSessionAbandon(id: ID!)を 呼び出します。完全なレスポンスの送信
すべての回答が既にある場合 — たとえば
CATALOG_ITEMの再利用可能な 回答セット — セッションをスキップしてquestionnaireResponseSubmitで 直接送信できます。同じ品目とプログラムの以前のレスポンスを置き換えます。mutation SubmitResponse($input: QuestionnaireResponseSubmitInput!) {questionnaireResponseSubmit(input: $input) {idstatuscompletedAtanswers {questionCodevalueprovenance}}}推論なしで回答しますか?
questionnaireSessionStartで選択したプログラムの セッションを開始し、上記と同じ 確認と修正 および 証明 の呼び出しを 使用します。レスポンスと準備状況の読み取り
questionnaireResponse(id)で確定済みレコードを取得し、containerComplianceReadinessでコンテナ全体の申告準備状況を確認できます — すべてのラインに完全なレスポンスがある場合にのみreadyはtrueです。query ContainerReadiness($containerType: ContainerType!, $containerId: ID!) {containerComplianceReadiness(containerType: $containerTypecontainerId: $containerId) {readytotalLineCountoutstandingLineCount}}次のステップ
ComplianceQuestionnaireInferInput QuestionnaireAnswersSubmitInput QuestionnaireResponseSubmitInput QuestionnaireSessionAttestInput
complianceQuestionnaireInfer questionnaireAnswersSubmit questionnaireResponseSubmit questionnaireSessionAttest
このページは役に立ちましたか?