<nome_da_construção_do_modelo> !PREDICT¶

Sintaxe¶

<model_build_name>!PREDICT(<presigned_url>,
                           [ <model_build_version> ]
                          )

Argumentos¶

Obrigatório:

presigned_url

URL pré-assinado dos documentos preparados.

Para obter o URL pré-assinado para passar como argumento, chame a função GET_PRESIGNED_URL. Consulte GET_PRESIGNED_URL.

Para obter mais informações, consulte Exemplo.

Nota

A função GET_PRESIGNED_URL tem um tempo de expiração padrão (60 minutos). Para obter mais informações sobre como estender o prazo de expiração, consulte GET_PRESIGNED_URL.

Opcional:

model_build_version

Versão do modelo Document AI.

Se não for especificado, a versão mais recente do modelo disponível será usada por padrão.

Retornos¶

Retorna um objeto JSON com os seguintes campos:

ocrScore

Especifica a pontuação de confiança para o processo de reconhecimento óptico de caracteres (OCR).

score

Especifica a pontuação de confiança para um valor específico.

value

Especifica a resposta extraída para a pergunta.

{
  "__documentMetadata": {
    "ocrScore": 0.918
  },
  "invoice_number": [
    {
      "score": 0.925,
      "value": "123/20"
    }
  ],
  "invoice_items": [
    {
      "score": 0.839,
      "value": "NEW CRUSHED VELVET DIVAN BED"
    },
    {
      "score": 0.839,
      "value": "Vintage Radiator"
    },
    {
      "score": 0.839,
      "value": "Solid Wooden Worktop"
    },
    {
      "score": 0.839,
      "value": "Sienna Crushed Velvet Curtains"
    }
  ],
  "tax_amount": [
    {
      "score": 0.879,
      "value": "77.57"
    }
  ],
  "total_amount": [
    {
      "score": 0.809,
      "value": "465.43 GBP"
    }
  ],
  "buyer_name": [
    {
      "score": 0.925
    }
  ]
  "vendor_name": [
    {
      "score": 0.9,
      "value": "UK Exports & Imports Ltd"
    }
  ]
}

Requisitos de controle de acesso¶

Para extrair informações com Document AI, você deve usar uma função de conta que tenha a função de banco de dados SNOWFLAKE.DOCUMENT_INTELLIGENCE_CREATOR. Para obter mais informações, consulte Controle de acesso da Document AI.

Notas de uso¶

• Certifique-se de atender aos pré-requisitos para usar este método. Para obter mais informações, consulte Pré-requisitos.

• Document AI tem uma limite para o número de documentos processados em uma consulta. Para obter mais informações, consulte Limitações conhecidas da Document AI.

• Todos os documentos devem estar no mesmo diretório do estágio.

• Document AI usa tabelas de diretório. Para obter mais informações, consulte Consulta de tabelas de diretório.

• Se o modelo Document AI não encontrar uma resposta no documento, o modelo não retornará uma chave value. No entanto, ele retorna a chave score, que indica o quão confiante o modelo está de que o documento não contém a resposta. Veja o campo buyer_name como exemplo.

• O modelo Document AI pode retornar listas. Veja o campo invoice_items como exemplo.

Exemplo¶

O exemplo a seguir extrai informações de todos os documentos no estágio pdf_inspections_stage para versão 1 da versão do modelo inspections:

SELECT inspections!PREDICT(
  GET_PRESIGNED_URL(@pdf_inspections_stage, RELATIVE_PATH), 1)
  FROM DIRECTORY(@pdf_inspections_stage);

O exemplo a seguir extrai informações do documento 'paystubs/paystub01.pdf' no estágio pdf_paystubs_stage para versão 1 da versão do modelo paystubs:

SELECT paystubs!PREDICT(
  GET_PRESIGNED_URL(@pdf_paystubs_stage, 'paystubs/paystub01.pdf'), 1);