--- title: "이미지에서 텍스트 추출 트리거 액션" slug: "extract-text" updated: 2026-10-22T11:11:03Z published: 2026-10-22T11:11:03Z 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. # 이미지에서 텍스트 추출 트리거 액션 **‘이미지에서 텍스트 추출’** 트리거 액션은 쿼리를 기반으로 이미지에서 텍스트를 추출합니다. 이를 다른 말로 표현하면 “쿼리 기반 OCR(광학 문자 인식)” 또는 “요청에 따라 이미지에서 텍스트를 추출”하는 것입니다. 이 트리거는 항상 이미지에 실제로 존재하는 텍스트만 반환합니다. 추가 정보나 해석을 더하지 않습니다. 따라서 물리적 세계에서 디지털 세계로 데이터를 전송하는 데 매우 유용합니다. ### 사용 사례 예시: - **외부 공급업체에서 발송된 주문 양식의 데이터를 수집합니다.** 공급업체 청구서에 기재된 14자리 PO 번호를 WMS로 수동으로 입력할 필요가 없습니다. 간단한 앱과 “이미지에서 텍스트 추출” 기능을 결합하면 이 데이터를 몇 초 만에 가져올 수 있습니다. - **종이 양식을 디지털화하세요.** 기존 종이 전달 양식에 포함된 데이터는 Tulip 앱 내에서 접근할 수 있게 되면 그 가치가 더욱 높아집니다. “이미지에서 텍스트 추출” 액션은 물리적 세계와 디지털 세계를 연결하는 훌륭한 수단입니다. - **작업자가 익숙하지 않은 언어로 된 텍스트를 안정적으로 처리하세요.** 제조업은 글로벌한 산업입니다**.** “이미지에서 텍스트 추출”과 “번역” 트리거 액션을 결합하여 종이 문서를 작업자가 실제로 활용할 수 있는 정보로 변환함으로써, 작업자에게 초능력을 부여하세요. ## 트리거 예시 모바일 앱을 사용하여 제품 라벨 사진을 촬영해 배치 번호를 확인합니다. | 이미지 | 트리거 | 결과 | | --- | --- | --- | | image.png{height="" width="400"} | image.png{height="" width="400"} | 11EP8F4WA58CCX | ## 이미지에서 값 추출 ### 입력 및 출력 이 트리거 액션에는 '입력 이미지'와 '쿼리'라는 두 가지 입력과, 추출된 텍스트라는 하나의 출력이 있습니다. #### 입력: 입력 이미지 텍스트를 추출할 대상 이미지입니다. 이 이미지는 카메라 입력 위젯, [Tulip Vision](/r230/docs/vision) 또는 외부 시스템에서 가져올 수 있습니다. | | 지원되는 데이터 유형 | | --- | --- | | 입력 | 이미지 URL | ### 입력: 쿼리 이 쿼리는 이미지나 문서에서 텍스트를 추출하는 데 사용됩니다. 쿼리 모범 사례:* 가능한 경우 문서 내의 단어를 사용하십시오. 이는 특히 약어 및 줄임말(예: SN, ID, SSN, Lot No. 등)에 유용합니다. ‘텍스트 추출’ 트리거 액션은 [‘데이터/문서에서 질문 답변하기’ 트리거 액션보다](/r230/docs/answer-question-from-input) 덜 복잡한 쿼리를 지원합니다. * 예: 올바른 입력: "공급업체는 누구입니까?" * 예: 잘못된 입력: "누가 이것을 우리에게 보냈을까요?"* 정보의 위치를 명시하는 것도 도움이 될 수 있습니다(예: “하단에 있는 참조 번호는 무엇입니까?”). | | 지원되는 데이터 유형 | | --- | --- | | 입력 | 텍스트 | ### 출력: 추출된 텍스트 이 텍스트는 쿼리에 따라 이미지에서 추출된 내용입니다. | | 지원되는 데이터 유형 | | --- | --- | | 출력 | 텍스트 | ## 이미지/문서에서 값 추출 Note Extracting values from documents is a relatively slow operation. We limit documents to 10 pages to limit execution time. '이미지/문서에서 값 추출' 기능은 '이미지에서 값 추출'과 동일하게 작동하지만, 일련의 질문을 지원합니다. 이 기능은 '이미지에서 값 추출' 트리거 작업을 실행하는 것보다 성능이 훨씬 더 우수합니다. #### 입력: 입력 이미지/문서 텍스트를 추출할 대상 이미지입니다. 이 이미지는 카메라 입력 위젯, [Tulip Vision](/r230/docs/vision) 또는 외부 시스템에서 가져올 수 있습니다. 파일의 경우, 정적으로 설정하거나 파일 입력 위젯을 통해 입력하거나 Tables에 저장된 파일을 참조할 수 있습니다. | | 지원되는 데이터 유형 | | --- | --- | | 입력 | 이미지 URL | ### 입력: 쿼리 이 쿼리는 이미지에서 텍스트를 추출하는 데 사용됩니다. 텍스트 값의 배열 또는 목록이어야 합니다. | | 지원되는 데이터 유형 | | --- | --- | | 입력 | 텍스트 목록 | #### 출력: 추출된 텍스트 이것은 쿼리를 기반으로 이미지에서 추출된 텍스트입니다. | | 지원되는 데이터 유형 | | --- | --- | | 출력 | 객체 배열. 각 요소에는 "Question" 및 "Answer" 속성이 있습니다. | ## 이미지/문서에서 모든 텍스트 추출 경우에 따라 '값 추출' 트리거 동작의 키:값 방식이 사용 사례에 적합하지 않을 수 있습니다. 이미지에서 모든 데이터를 읽어들이면 Copilot이 해결할 수 있는 문제의 범위가 거의 무한히 넓어집니다. "모든 텍스트 추출" 트리거 동작은 이러한 유연성을 제공합니다. ![image.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/image%28412%29.png) #### 입력: 입력 이미지/문서 이 이미지는 텍스트를 추출해야 할 대상입니다. 이 이미지는 카메라 입력 위젯, [Tulip Vision](/r230/docs/vision) 또는 외부 시스템에서 가져올 수 있습니다. 파일의 경우, 정적으로 설정하거나 파일 입력 위젯을 통해 입력하거나 Tables에 저장된 파일을 참조할 수 있습니다. | | 지원되는 데이터 유형 | | --- | --- | | 입력 | 이미지 URL 또는 파일 URL | #### 출력: 추출된 텍스트 이는 해당 이미지나 문서에서 발견된 모든 텍스트입니다. 문서의 경우 데이터 배열이 반환되며, 각 항목은 제공된 문서의 한 페이지에 포함된 텍스트를 나타냅니다. | | 지원되는 데이터 유형 | | --- | --- | | 출력 | (이미지의 경우) 텍스트. (문서의 경우) 텍스트 목록 | --- ## 예외적인 경우 ### 입력 이미지가 없거나 쿼리가 제공되지 않은 경우 트리거 액션에 입력 이미지가 없거나 쿼리가 제공되지 않은 경우, 앱은 다음과 같은 시스템 오류를 표시합니다:*"입력 또는 쿼리가 비어 있습니다*" 다음과 같은 모든 경우에 이 오류가 발생합니다: * 입력 이미지 및/또는 쿼리 입력에 값이 할당되지 않은 경우. 이는 “null”과 동일합니다. * 쿼리에 빈 문자열이 할당된 경우. ### 쿼리에 대한 결과가 없음 쿼리에 대한 결과를 찾을 수 없는 경우, 트리거 액션은 빈 텍스트를 반환합니다. ## 제한 사항 Supported languages The following languages are the only ones supported for documents where values are being extracted: English, Spanish, Italian, Portuguese, French, German. 이러한 제한 사항은 ‘ Instance ’ 수준에서 추적됩니다. 이러한 제한을 초과한 경우, ‘이미지에서 텍스트 추출’ 트리거 액션은 실패합니다. '이미지에서 텍스트 추출' 트리거에는 다음과 같은 제한 사항이 적용됩니다: | | 제한 사항 | | --- | --- | | 이미지 크기 | 5MB | | 월별 제한 | 월 10,000회 요청 | | 요청 제한 | 분당 10회 요청 | | 추출되는 값의 개수 | 액션당 15개의 값 추출 | 계정 사용량을 포함한 추가 제한 사항에 대해서는 [Tulip AI 사용량 및 요금 정책을](https://support.tulip.co/docs/tulip-ai-usage-and-pricing) 참조하십시오. {{snippet.원하시는 정보를 찾으셨나요?}}