Einstein Platform Services의 Open API 3.0 Spec을 사용해보십시오.

이번에는 Salesforce에서 제공하는 Einstein Platform Services의 Open API 3.0 Spec을 사용해 보겠습니다. Rest 리소스의 Open API Spec 가 제공되고 있으면(자), 대응하고 있는 툴로부터이면 간단하게 요구를 던질 수 있게 되기 때문에 고마워요.
Salesforce는 향후 Salesforce의 Rest 리소스에 Open API 3.0 Spec을 제공할 것이라고 발표했습니다. 오는 날에 대비하면서 우선 OAS를 Postman에 가져와 요청을 던져 보는 곳까지 해 봅니다.

Einstein Platform Services의 OAuth 토큰 얻기

Rest API를 통해 Einstein Platform Services의 Rest API를 호출하려면 OAuth 토큰이 필요합니다. 이번에는 Postman에서 던지는 요청 헤더에 추가할 수 있으면 좋으므로 Einstein Platform Services 페이지에서 생성합니다.

이렇게 하려면 먼저 Signup 페이지에서 Einstein Platform Services에 가입합니다. 사전에 검증을 위한 DE 환경을 취득해 두고 그 자격 증명으로 가입합시다.



가입하면 Private Key가 발행되므로 메모해 둡니다.



그런 다음 Generate an OAuth Token 페이지를 열고 가입한 사용자의 E メールアドレス 및 Private Key를 붙여넣고 GET TOKEN 합니다. 토큰의 Expiration in minutes 는 60 분 정도로 해 두면 여러가지 실험할 수 있는 시간이 있다고 생각합니다.
발행된 Token은 Einstein Platform Services에 대한 요청에 사용되므로 복사해 둡시다.

Postman에서 Open API 3.0 Spec 로드

Einstein Platform Services의 OAS는 MetaMind의 저장소에 게시되어 있으므로 vision-language-api-openapi-2.0.1.yaml의 RAW 파일을 로컬 환경에 다운로드합니다.

데스크톱 버전의 Postman을 열고 サイドバーの APIs タブ > Create an API 에서 필요한 항목을 입력한 후 다운로드한 OAS를 로드합니다. Create API

API를 만들면 Generate Collection 합니다. 여기서 Test the API를 선택합니다.


Collections 탭을 열면 Einstein Platform Services 엔드포인트가 나열되지만 마지막으로 baseUrl라는 컬렉션 변수를 다시 작성해야 합니다. 방금 작성한 Einstein Platform Services API Collection을 Edit 그러면 편집 모달이 열리므로 Variables 탭에서 baseUrl의 값을 https://api.einstein.ai로 다시 씁니다. 이것으로 준비가 완료됩니다.

Postman에서 요청 보내기

API 사용량 확인

시도하기 위해 Get API Usage 엔드포인트에 요청을 보냅니다. 위에서 얻은 OAuth 토큰을 Authorization 탭에서 입력하고 Send 해 보면 현재 API 사용 상황이 반환되었습니다. 바삭바삭과 API의 움직임을 확인할 수 있는 것이 좋네요.

이미지에서 텍스트 감지

덧붙여서 Detect Text에서 OCR도 시도했습니다. 표 테이블의 이미지를 전송해 보면, 정확하게 셀의 인덱스까지 검지할 수 있습니다만, 각 셀내의 라벨과 값은 구별되지 않고 하나의 텍스트로서 판정되어 버리는 것 같네요.

참고

Einstein Platform Services Guide

MetaMind/openapi | GitHub