Elementi HTML di IA aumentata Crowd

I seguenti Elementi Crowd HTML sono disponibili solo per le attività del flusso di lavoro umano IA aumentata Amazon.

Un widget per consentire la revisione umana di un risultato di analisi del documento Amazon Textract.

Attributes

I seguenti attributi sono supportati da questo elemento.

intestazione

Questo è il testo che viene visualizzato come intestazione.

src

Si tratta di un collegamento all'immagine che deve essere analizzata dal worker.

initialValue

Imposta i valori iniziali per gli attributi trovati nell'interfaccia utente del worker.

Di seguito è riportato un esempio di input initialValue.


[
            {
                "blockType": "KEY_VALUE_SET",
                "confidence": 38.43309020996094,
                "geometry": {
                    "boundingBox": {
                        "width": 0.32613086700439453,
                        "weight": 0.0942094624042511,
                        "left": 0.4833833575248718,
                        "top": 0.5227988958358765
                    },
                    "polygon": [
                        {"x": 0.123, "y": 0.345}, ...
                    ]
                }
                "id": "8c97b240-0969-4678-834a-646c95da9cf4",
                "relationships": [
                    {
                        "type": "CHILD",
                        "ids": [
                            "7ee7b7da-ee1b-428d-a567-55a3e3affa56",
                            "4d6da730-ba43-467c-a9a5-c6137ba0c472"
                        ]
                    },
                    {
                        "type": "VALUE",
                        "ids": [
                            "6ee7b7da-ee1b-428d-a567-55a3e3affa54"
                        ]
                    }
                ],
                "entityTypes": [
                    "KEY"
                ],
                "text": "Foo bar"
            },
]

blockTypes

Questo determina il tipo di analisi che i worker possono eseguire. Al momento è supportato soltanto KEY_VALUE_SET.

keys

Specifica le nuove chiavi e il valore di testo associato che il worker può aggiungere. I valori di input per keys possono includere i seguenti elementi:

importantFormKey accetta stringhe e viene utilizzato per specificare una singola chiave.
importantFormKeyAliases può essere utilizzato per specificare alias che sono alternative accettabili alle chiavi fornite. Utilizzare questo elemento per identificare ortografie o presentazioni alternative delle chiavi. Questo parametro accetta un elenco di una o più stringhe.

Di seguito è riportato un esempio di input per keys.


[
      {
        importantFormKey: 'Address',
        importantFormKeyAliases: [
          'address',
          'Addr.',
          'Add.',
        ]
      },
      {
        importantFormKey: 'Last name',
        importantFormKeyAliases: ['Surname']
      }
]

no-key-edit

Ciò impedisce ai worker di modificare le chiavi delle annotazioni passate tramite initialValue. Ciò impedisce ai worker di modificare le chiavi rilevate nei documenti,. Questo dato è obbligatorio.

no-geometry-edit

Impedisce ai worker di modificare i poligoni delle annotazioni passate tramite initialValue. Ad esempio, questo impedirebbe al worker di modificare il riquadro di delimitazione attorno a una determinata chiave. Questo dato è obbligatorio.

Gerarchia di elementi

Questo elemento dispone dei seguenti elementi padre e figlio.

Elementi padre - crowd-form
Elementi figlio – full-instructions, short-instructions

Regioni

Le seguenti regioni sono supportate da questo elemento. È possibile utilizzare codice HTML e CSS personalizzato all'interno di queste regioni per formattare le istruzioni per i worker. Ad esempio, utilizzare la sezione short-instructions per fornire esempi buoni e cattivi di come completare un'attività.

full-instructions

Istruzioni generali su come utilizzare il widget.

short-instructions

Istruzioni importanti specifiche dell'attività che vengono visualizzate in un posto di rilievo.

Esempio di modello di worker che utilizza l'elemento crowd

Un esempio di modello di worker che utilizza questo elemento crowd è simile al seguente.


<script src="https://assets.crowd.aws/crowd-html-elements.js"></script>
{% capture s3_uri %}http://s3.amazonaws.com/{{ task.input.aiServiceRequest.document.s3Object.bucket }}/{{ task.input.aiServiceRequest.document.s3Object.name }}{% endcapture %}

<crowd-form>
  <crowd-textract-analyze-document
    src="{{ s3_uri | grant_read_access }}"
    initial-value="{{ task.input.selectedAiServiceResponse.blocks }}"
    header="Review the key-value pairs listed on the right and correct them if they don't match the following document."
    no-key-edit
    no-geometry-edit
    keys="{{ task.input.humanLoopContext.importantFormKeys }}"
    block-types="['KEY_VALUE_SET']"
  >
    <short-instructions header="Instructions">
      <style>
        .instructions {
          white-space: pre-wrap;
        }
        .instructionsImage {
          display: inline-block;
          max-width: 100%;
        }
      </style>
      <p class='instructions'>Click on a key-value block to highlight the corresponding key-value pair in the document.

If it is a valid key-value pair, review the content for the value. If the content is incorrect, correct it.

The text of the value is incorrect, correct it.
<img class='instructionsImage' src="https://assets.crowd.aws/images/a2i-console/correct-value-text.png" />

A wrong value is identified, correct it.
<img class='instructionsImage' src="https://assets.crowd.aws/images/a2i-console/correct-value.png" />

If it is not a valid key-value relationship, choose No.
<img class='instructionsImage' src="https://assets.crowd.aws/images/a2i-console/not-a-key-value-pair.png" />

If you can’t find the key in the document, choose Key not found.
<img class='instructionsImage' src="https://assets.crowd.aws/images/a2i-console/key-is-not-found.png" />

If the content of a field is empty, choose Value is blank.
<img class='instructionsImage' src="https://assets.crowd.aws/images/a2i-console/value-is-blank.png" />

<b>Examples</b>
Key and value are often displayed next or below to each other.

Key and value displayed in one line.
<img class='instructionsImage' src="https://assets.crowd.aws/images/a2i-console/sample-key-value-pair-1.png" />

Key and value displayed in two lines.
<img class='instructionsImage' src="https://assets.crowd.aws/images/a2i-console/sample-key-value-pair-2.png" />

If the content of the value has multiple lines, enter all the text without line break. Include all value text even if it extends beyond the highlight box.
<img class='instructionsImage' src="https://assets.crowd.aws/images/a2i-console/multiple-lines.png" /></p>
    </short-instructions>

    <full-instructions header="Instructions"></full-instructions>
  </crowd-textract-analyze-document>
</crowd-form>

Output

Di seguito è riportato un esempio di output di tale elemento. Puoi trovare una spiegazione dettagliata di questo output nella documentazione dell'AnalyzeDocumentAPI Amazon Textract.


{
  "AWS/Textract/AnalyzeDocument/Forms/V1": {
    blocks: [
      {
        "blockType": "KEY_VALUE_SET",
        "id": "8c97b240-0969-4678-834a-646c95da9cf4",
        "relationships": [
          {
            "type": "CHILD",
            "ids": ["7ee7b7da-ee1b-428d-a567-55a3e3affa56", "4d6da730-ba43-467c-a9a5-c6137ba0c472"]
          },
          {
            "type": "VALUE",
            "ids": ["6ee7b7da-ee1b-428d-a567-55a3e3affa54"]
          }
        ],
        "entityTypes": ["KEY"],
        "text": "Foo bar baz"
      }
    ]
  }
}

Un widget per abilitare la revisione umana di un risultato di moderazione dell'immagine Amazon Rekognition.

Attributes

I seguenti attributi sono supportati da questo elemento.

intestazione

Questo è il testo che viene visualizzato come intestazione.

src

Si tratta di un collegamento all'immagine che deve essere analizzata dal worker.

categorie

Questo supporta categories come un array di stringhe o un array di oggetti in cui ogni oggetto ha un campo name.

Se le categorie sono disponibili come oggetti, si applica quanto segue:

Le categorie visualizzate sono il valore del campo name.
La risposta restituita contiene gli oggetti completi di ogni categoria selezionata.

Se le categorie sono disponibili come stringhe, si applica quanto segue:

La risposta restituita è un array di tutte le stringhe selezionate.

exclusion-category

Impostando questo attributo si crea un pulsante sotto le categorie nell'interfaccia utente.

Quando un utente seleziona il pulsante, tutte le categorie vengono deselezionate e disabilitate.
La scelta del pulsante consente nuovamente di abilitare le categorie in modo che gli utenti possano sceglierle.
Se si effettua l'invio dopo aver scelto il pulsante, viene restituito un array vuoto.

Gerarchia di elementi

Questo elemento dispone dei seguenti elementi padre e figlio.

Elementi padre - crowd-form
Elementi figlio – full-instructions, short-instructions

AWS Regioni

Le seguenti AWS regioni sono supportate da questo elemento. È possibile utilizzare codice HTML e CSS personalizzato all'interno di queste Regioni per formattare le istruzioni ai worker. Ad esempio, utilizzare la sezione short-instructions per fornire esempi buoni e cattivi di come completare un'attività.

full-instructions

Istruzioni generali su come utilizzare il widget.

short-instructions

Istruzioni importanti specifiche dell'attività che vengono visualizzate in un posto di rilievo.

Esempio modello worker con l'elemento crowd

Un esempio di modello worker che utilizza l'elemento crowd sarebbe simile al seguente.


<script src="https://assets.crowd.aws/crowd-html-elements.js"></script>
{% capture s3_uri %}http://s3.amazonaws.com/{{ task.input.aiServiceRequest.image.s3Object.bucket }}/{{ task.input.aiServiceRequest.image.s3Object.name }}{% endcapture %}

<crowd-form>
  <crowd-rekognition-detect-moderation-labels
    categories='[
      {% for label in task.input.selectedAiServiceResponse.moderationLabels %}
        {
          name: "{{ label.name }}",
          parentName: "{{ label.parentName }}",
        },
      {% endfor %}
    ]'
    src="{{ s3_uri | grant_read_access }}"
    header="Review the image and choose all applicable categories."
  >
    <short-instructions header="Instructions">
      <style>
        .instructions {
          white-space: pre-wrap;
        }
      </style>
      <p class='instructions'>Review the image and choose all applicable categories.
If no categories apply, choose None.

<b>Nudity</b>
Visuals depicting nude male or female person or persons

<b>Graphic Male Nudity</b>
Visuals depicting full frontal male nudity, often close ups

<b>Graphic Female Nudity</b>
Visuals depicting full frontal female nudity, often close ups

<b>Sexual Activity</b>
Visuals depicting various types of explicit sexual activities and pornography

<b>Illustrated Nudity or Sexual Activity</b>
Visuals depicting animated or drawn sexual activity, nudity or pornography

<b>Adult Toys</b>
Visuals depicting adult toys, often in a marketing context

<b>Female Swimwear or Underwear</b>
Visuals depicting female person wearing only swimwear or underwear

<b>Male Swimwear Or Underwear</b>
Visuals depicting male person wearing only swimwear or underwear

<b>Partial Nudity</b>
Visuals depicting covered up nudity, for example using hands or pose

<b>Revealing Clothes</b>
Visuals depicting revealing clothes and poses, such as deep cut dresses

<b>Graphic Violence or Gore</b>
Visuals depicting prominent blood or bloody injuries

<b>Physical Violence</b>
Visuals depicting violent physical assault, such as kicking or punching

<b>Weapon Violence</b>
Visuals depicting violence using weapons like firearms or blades, such as shooting

<b>Weapons</b>
Visuals depicting weapons like firearms and blades

<b>Self Injury</b>
Visuals depicting self-inflicted cutting on the body, typically in distinctive patterns using sharp objects

<b>Emaciated Bodies</b>
Visuals depicting extremely malnourished human bodies

<b>Corpses</b>
Visuals depicting human dead bodies

<b>Hanging</b>
Visuals depicting death by hanging</p>
    </short-instructions>

    <full-instructions header="Instructions"></full-instructions>
  </crowd-rekognition-detect-moderation-labels>
</crowd-form>

Output

Di seguito è riportato un esempio di output di tale elemento. Per informazioni dettagliate su questo output, consulta la documentazione dell'API Amazon DetectModerationRekognition Labels.


{
  "AWS/Rekognition/DetectModerationLabels/Image/V3": {
    "ModerationLabels": [
        { name: 'Gore', parentName: 'Violence' },
        { name: 'Corpses', parentName: 'Violence' },
    ]
  }
}

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

SageMaker Crowd HTML Elements

IA aumentata