Utilizzo di un blueprint alternativo durante l'utilizzo dei progetti

Quando si utilizza un output personalizzato con più blueprint, BDA tenta di abbinare ciascun documento al blueprint più appropriato. Se nessun blueprint corrisponde a un documento, BDA normalmente restituisce un valore customOutputStatus of NO_MATCH e non viene generato alcun output personalizzato per quel documento. Un blueprint alternativo consente di specificare un blueprint da utilizzare quando nessun altro blueprint corrisponde, in modo da ricevere comunque un output personalizzato per ogni documento.

Come funzionano i blueprint alternativi

Quando BDA elabora un documento e non può abbinarlo a nessuno dei blueprint del progetto, si verifica quanto segue:

• Senza un progetto alternativo, BDA restituisce customOutputStatus: NO_MATCH e nessun output personalizzato per quel documento.

• Con un blueprint di riserva: se il risultato èNO_MATCH, BDA utilizza il blueprint di riserva per estrarre output e resi personalizzati. customOutputStatus: FALLBACK

Ciò è utile quando si dispone di blueprint specializzati per tipi di documenti noti ma si desidera comunque un output strutturato per documenti imprevisti o vari.

Comportamento corrispondente con diverse configurazioni di blueprint

Il comportamento corrispondente e i punteggi di affidabilità dipendono dal numero di blueprint presenti nel progetto e dalla configurazione di un blueprint alternativo:

Configurazione	Comportamento corrispondente	Punteggio di attendibilità
Un progetto, nessun ripiego	BDA impone una corrispondenza con il singolo progetto senza eseguire il matcher.	Sempre 1.0
Un progetto, con riserva	BDA esegue il matcher in base al singolo progetto. Se il documento non corrisponde, BDA utilizza il blueprint di riserva.	Punteggio vero o 0 se viene utilizzato il fallback
Progetti multipli, nessun fallback	BDA esegue il matcher su tutti i progetti e seleziona la corrispondenza migliore. Se nessun progetto corrisponde, restituisce. NO_MATCH	Punteggio vero o nessun output personalizzato in caso di mancata corrispondenza
Progetti multipli, con riserva	BDA esegue il matcher su tutti i progetti e seleziona la corrispondenza migliore. Se nessun blueprint corrisponde, BDA utilizza il blueprint di riserva.	Punteggio vero o 0 se viene utilizzato il fallback

L'aggiunta di un blueprint di riserva consente l'effettivo calcolo del punteggio di confidenza delle partite in tutte le configurazioni. Nel caso di un progetto singolo senza riserva, BDA salta completamente il matcher e impone sempre una corrispondenza. Con una configurazione alternativa, BDA esegue il matcher e consente di verificare in che misura i documenti corrispondono effettivamente ai progetti.

Configurazione di un blueprint alternativo

Si configura un blueprint di riserva in customOutputConfiguration durante la creazione o l'aggiornamento di un progetto. Il blueprint di riserva è specificato document nel campo e accetta un singolo blueprint.

L'esempio seguente crea un progetto con due blueprint regolari e un blueprint di riserva. Per ulteriori informazioni sulla configurazione del blueprint di riserva, consulta DocumentCustomOutputConfiguration l'API Reference.

Python SDK

response = client.create_data_automation_project(
    projectName=project_name,
    projectDescription="Provide a project description",
    projectStage='LIVE',
    standardOutputConfiguration=output_config,
    customOutputConfiguration={
        'blueprints': [
            {
                'blueprintArn': Blueprint ARN,
                'blueprintStage': 'LIVE'
            },
            ...
        ],
        'document': {
            'fallbackBlueprints': [
                {
                    'blueprintArn': Fallback Blueprint ARN,
                    'blueprintStage': 'LIVE'
                }
            ]
        }
    }
)
  

AWS CLI

aws bedrock-data-automation create-data-automation-project \
    --project-name project_name \
    --project-stage LIVE \
    --standard-output-configuration '{"document":{}}' \
    --custom-output-configuration '{
        "blueprints": [
            {
                "blueprintArn": "Blueprint ARN",
                "blueprintStage": "LIVE"
            }
        ],
        "document": {
            "fallbackBlueprints": [
                {
                    "blueprintArn": "Fallback Blueprint ARN",
                    "blueprintStage": "LIVE"
                }
            ]
        }
    }'
  

In questo esempio, BDA tenta innanzitutto di abbinare ciascun documento al modello della fattura o della ricevuta. Se nessuno dei due corrisponde, BDA utilizza il modello generale del documento come riserva.

Nota

È possibile specificare al massimo un blueprint di riserva per progetto. I blueprint di riserva sono supportati solo per la modalità documento.

Comprendere l'output di riserva

Il customOutputStatus campo nell'output indica come è stato elaborato il documento:

personalizzato OutputStatus	Description
MATCH	Il documento corrispondeva a uno dei modelli regolari del progetto.
NO_MATCH	Nessun blueprint corrisponde e non è stato configurato alcun blueprint alternativo.
FALLBACK	Nessun modello normale corrisponde, ma il blueprint di riserva è stato utilizzato per generare un output personalizzato.

Di seguito è riportato un esempio di frammento di output dell'InvokeDataAutomationAsyncAPI quando viene utilizzato un blueprint di riserva:

{
  "semanticModality": "DOCUMENT",
  "outputSegments": [
    {
      "customOutputStatus": "FALLBACK",
      "standardOutput": {
        ...
      },
      "customOutput": {
        "matched_blueprint": {
          "arn": "arn:aws:bedrock:us-east-1:123456789012:blueprint/general-document",
          "version": "1",
          "name": "general-document",
          "confidence": 1.0
        },
        "inference_result": {
          ...
        }
      }
    }
  ]
}