# Extrair Texto

## CONFIGURAÇÃO

Para utilizar esse objeto basta configurar os parâmetros desejados.

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2FnII3ghwmd7EfxUnUtg1i%2Fimage.png?alt=media&#x26;token=67b4aab8-f416-4966-a849-c9543ffd08fb" alt=""><figcaption><p>Layout geral do objeto</p></figcaption></figure>

| Campo                        | Descritivo                                                                                                                                                                                                                                                       |
| ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Título                       | É o nome do objeto e **não precisa ser alterado**, a menos que você queira identificá-lo para facilitar a localização dele no robô, por exemplo: "Extrair Texto - Nota Fiscal".                                                                                  |
| Nome identificador do objeto | É um identificador único do objeto e **não precisa ser alterado**, mas você pode renomear caso queira para localizá-lo mais facilmente quando for usá-lo em outros objetos. Apenas lembre-se que esse nome deve ser único e sem espaços ou caracteres especiais. |
| Provedor                     | Provedor  utilizado para identificação do conteúdo                                                      **(Tesseract (grátis) / Google).**                                                                                                                       |
| Idioma                       | idioma do conteúdo presente na imagem. Atualmente, é permitido utilizar Português ou Inglês.                                                                                                                                                                     |
| Forma de Captura             | Determina a origem da imagem, podendo ser um link de uma imagem na internet ou um arquivo.                                                                                                                                                                       |
| Arquivo/Url                  | Informar o caminho do arquivo ou o link da imagem. Essa configuração depende da **Forma de Captura** selecionada.                                                                                                                                                |

{% hint style="info" %}
**INTERPOLAÇÃO**

Trata-se de um conceito técnico utilizado em programação e você não precisa se preocupar em alterá-lo neste momento.
{% endhint %}

{% hint style="warning" %}
Caso selecionado o provedor da Google e não informada a chave de acesso, o Objeto será executado apenas se a empresa possuir créditos de OCR disponíveis.
{% endhint %}

## QUAL UTILIZAR: LINK OU ARQUIVO.

* Em quais casos utilizar LINK:

1. O extrator quando utilizado via Link não extrai textos com muitos detalhes. Então, caso o seu texto seja um dos seguintes, use o LINK.

<details>

<summary>Textos exemplo para uso do extrator LINK</summary>

* <https://ik.imagekit.io/grupokyly/CX_E-mail-Marketing_Bolsa_escolher2_01.png?updatedAt=1694805693374>
* <https://thumbor.novaescola.org.br/Amvg0PRdY2sSqKCBcRQ4VDyCt0I=/nova-escola-producao.s3.amazonaws.com/MHNnRHSXdNnbaC4V9WyZcJy8sx9GpDnC5j2Ztc2KvYA35>
* <https://files.realpython.com/media/results2.5d8d3b8108cd.png>
* <https://s3-sa-east-1.amazonaws.com/mundogum/wp-content/uploads/2007/10/lorem-ipsum.png>
* <https://img.freepik.com/vetores-premium/letra-sb-logotipo-moderno-cursivo-feminino_608024-707.jpg>
* <https://s.tmimgcdn.com/scr/1200x750/172600/eolireh--fonte-cursiva-moderna_172678-original.jpg>

</details>

* Em quais casos utilizar ARQUIVO:

1. Em casos que o arquivo tiver um texto detalhado como por exemplo uma Nota Fiscal ou uma Nota do Sintegra.

## CASOS DE USO

* Utilizar para extrair textos de arquivos ou links de imagens/documentos via OCR.

## EXEMPLO

Extrair texto via OCR  de imagem via Link.

<details>

<summary>ITENS UTILIZADOS NO ROBÔ</summary>

* **Objetos:** [Caixa de Mensagem](https://docs.roboteasy.tech/studio/geral/objetos/acoes-globais/caixa-de-mensagem).
* Link: <https://s3-sa-east-1.amazonaws.com/mundogum/wp-content/uploads/2007/10/lorem-ipsum.png>

</details>

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2FEEJsJmR8HfksQ4wzNw7O%2Fimage.png?alt=media&#x26;token=fdd5615a-54b2-4084-a2be-aec48f236afb" alt=""><figcaption><p>Configuração Robô Exemplo Extrair Texto OCR</p></figcaption></figure>

**PASSO 1:** Configurar Extrair Texto com o Link desejado. O provedor utilizado será o google, mas é possível usar o **Tesseract.**

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2FYAueoT8ymhkIUI1QIrYq%2Fimage.png?alt=media&#x26;token=019dfb49-40ab-43f2-9771-407bef0693e4" alt=""><figcaption><p>Configuração Extrair Texto</p></figcaption></figure>

**PASSO 2:** Configurar Caixa de Mensagem com o nome identificador do objeto para retornar o texto extraído.

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2FZLsv3ohW6Bv9KrPszJcJ%2Fimage.png?alt=media&#x26;token=f144d5a0-8cf5-41da-9fc1-44b8669eac65" alt=""><figcaption><p>Configuração Caixa de Mensagem</p></figcaption></figure>

**PASSO 3:** Executar o robô e verificar as ações.

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2FEpwgiweidKFKK0iP7Kul%2FOCR.gif?alt=media&#x26;token=fe724a7a-b22f-40bc-a05d-cb633b3d0d8d" alt=""><figcaption><p>Execução Sucesso Robô Exemplo Extrair Texto OCR</p></figcaption></figure>

## Baixar o Robô

{% file src="<https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2FkBmoVlM4kcaGPoZEXCQe%2FOCR%20Extrair%20Texto%20-%20Rob%C3%B4%20Exemplo.roboteasy?alt=media&token=c3a83d10-09cf-4229-abc0-c55c7c8950c2>" %}

{% file src="<https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2Fh9uWnq5MXvQTVterc8Js%2FOCR%20Extrair%20Texto%20-%20Rob%C3%B4%20Exemplo.roboteasy?alt=media&token=1801aa00-e9da-446e-b13d-20553fa957e9>" %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.roboteasy.tech/studio/geral/objetos/ocr/imagem/extrair-texto.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
