--- title: "Ação de acionamento “Extrair texto de imagem”" slug: "extract-text" updated: 2026-10-22T11:10:56Z published: 2026-10-22T11:10:56Z canonical: "support.tulip.co/extract-text" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.tulip.co/llms.txt > Use this file to discover all available pages before exploring further. # Ação de acionamento “Extrair texto de imagem” A ação de acionamento **“Extrair texto da imagem** ” extrai texto de uma imagem com base em uma consulta. Outra forma de descrever isso é “OCR (reconhecimento óptico de caracteres) baseado em consulta” ou “Extrair texto de uma imagem solicitando-o”. O gatilho sempre retornará apenas o texto que estiver realmente presente na imagem. Ele não adicionará informações ou interpretações adicionais a ele. Isso o torna muito poderoso para transferir dados do mundo físico para o digital. ### Exemplos de casos de uso: - **Importar dados de um formulário de pedido proveniente de um fornecedor externo.** Esqueça a transferência manual daquele número de pedido de 14 caracteres da fatura do fornecedor para o seu WMS; combine um aplicativo simples com a ação “Extrair Texto de Imagem” para obter esses dados em segundos. - **Digitalize formulários em papel.** Os dados contidos em formulários em papel já existentes se tornam ainda mais valiosos quando podem ser acessados nos aplicativos da Tulip. As ações “Extrair Texto da Imagem” são um ótimo mecanismo para fazer a ponte entre o mundo físico e o digital. - **Trabalhe com textos em idiomas desconhecidos para seus operadores, de forma confiável.** O mundo da manufatura é global; dê superpoderes aos seus operadores combinando as ações de gatilho “Extrair Texto da Imagem” e “Traduzir” para transformar informações em papel em algo que seus operadores possam utilizar. ## Exemplo de acionamento Use um aplicativo móvel para tirar uma foto de uma etiqueta em um produto e obter o número do lote. | Imagem | Ação de acionamento | Resultado | | --- | --- | --- | | image.png{height="" width="400"} | image.png{height="" width="400"} | 11EP8F4WA58CCX | ## Extrair valor da imagem ### Entradas e saídas A ação de acionamento possui duas entradas, Imagem de Entrada e Consulta, e uma saída, o texto extraído. #### Entrada: imagem de entrada Esta é a imagem da qual o texto deve ser extraído. Ela pode vir do widget de entrada da câmera, [do Tulip Vision](/r230/docs/vision) ou de sistemas externos. | | Tipo de dados compatível | | --- | --- | | Entrada | URL da imagem | ### Entrada: consulta Esta é a consulta usada para extrair o texto da imagem ou do documento. Práticas recomendadas para consultas:* Sempre que possível, use palavras do documento. Isso é particularmente útil para siglas e abreviações (por exemplo, SN, ID, SSN, nº do lote etc.). As ações de gatilho “Extrair texto” suportam consultas menos complexas do que [as ações de gatilho “Responder à pergunta a partir de dados/documento](/r230/docs/answer-question-from-input)”. * Ex. Entrada correta: “Quem é o fornecedor?” * Ex. Entrada incorreta: “Quem você acha que poderia ter enviado isso para nós?”* Especificar a localização da informação também pode ajudar (por exemplo, “Qual é o número de referência na parte inferior?”) | | Tipos de dados suportados | | --- | --- | | Entrada | Texto | ### Saída: texto extraído Este é o texto que foi extraído da imagem com base na consulta. | | Tipo de dados suportado | | --- | --- | | Saída | Texto | ## Extrair valores de imagem/documento Note Extracting values from documents is a relatively slow operation. We limit documents to 10 pages to limit execution time. A função “Extrair valores de imagem/documento” funciona exatamente como a função “Extrair valor de imagem”, mas suporta uma série de perguntas. Isso terá um desempenho significativamente melhor do que executar a ação de gatilho “Extrair valor de imagem”. #### Entrada: imagem/documento de entrada Esta é a imagem da qual o texto deve ser extraído. Ela pode vir do widget de entrada da câmera, [do Tulip Vision](/r230/docs/vision) ou de sistemas externos. Para arquivos, isso pode ser definido estaticamente, inserido com o widget de entrada de arquivo ou referenciar arquivos armazenados em Tabelas. | | Tipos de dados suportados | | --- | --- | | Entrada | URL da imagem | ### Entrada: consulta Esta é a consulta usada para extrair o texto da imagem. Deve ser uma matriz/lista de valores de texto. | | Tipo de dados suportado | | --- | --- | | Entrada | Lista de texto | #### Saída: texto extraído Este é o texto que foi extraído da imagem com base na consulta. | | Tipo de dados suportado | | --- | --- | | Saída | Matriz de objetos. Cada elemento terá os atributos “Pergunta” e “Resposta”. | ## Extrair todo o texto da imagem/documento Em alguns casos, o paradigma chave:valor das ações de gatilho de extração de valor não faz sentido para o seu caso de uso. Ler todos os dados de uma imagem oferece flexibilidade quase infinita quanto aos problemas que podem ser resolvidos pelo Copilot. As ações de gatilho “Extrair todo o texto” oferecem essa flexibilidade. ![image.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/image%28412%29.png) #### Entrada: imagem/documento de entrada Esta é a imagem da qual o texto deve ser extraído. Ela pode vir do widget de entrada da câmera, [do Tulip Vision](/r230/docs/vision) ou de sistemas externos. Para arquivos, isso pode ser definido estaticamente, inserido com o widget de entrada de arquivo ou referenciar arquivos armazenados em Tabelas. | | Tipo de dados suportado | | --- | --- | | Entrada | URL da imagem ou URL do arquivo | #### Saída: texto extraído Trata-se de todo o texto encontrado na respectiva imagem ou documento. Os documentos retornarão uma matriz de dados, em que cada item representa o texto de uma página do documento fornecido. | | Tipo de dados suportado | | --- | --- | | Saída | (para imagens) Texto. (para documentos) Lista de textos | --- ## Casos extremos ### Nenhuma imagem de entrada e/ou nenhuma consulta fornecida Se nenhuma imagem de entrada ou nenhuma consulta for fornecida à ação de acionamento, o aplicativo exibirá o seguinte erro do sistema:*Sua entrada ou consulta está vazia* Isso ocorre em todos os seguintes casos:* A imagem de entrada e/ou a consulta não têm um valor atribuído. Isso equivale a “nulo”.* A consulta tem uma string vazia atribuída. ### Nenhum resultado para a consulta Se nenhum resultado for encontrado para a consulta, a ação de acionamento retornará um texto vazio. ## Limites Supported languages The following languages are the only ones supported for documents where values are being extracted: English, Spanish, Italian, Portuguese, French, German. Esses limites são monitorados no nível do “ Instance ”. Caso esses limites sejam excedidos, a ação de gatilho “Extrair texto da imagem” falhará. Existem os seguintes limites para os gatilhos “Extrair texto da imagem”: | | Limite | | --- | --- | | Tamanho da imagem | 5 MB | | Limite mensal | 10.000 solicitações por mês | | Limite de frequência | 10 solicitações por minuto | | Número de valores extraídos | 15 valores extraídos por ação | Para limites adicionais, incluindo o uso da conta, consulte [Uso e preços do Tulip AI](https://support.tulip.co/docs/tulip-ai-usage-and-pricing). {{snippet.Você encontrou o que estava procurando?}}