Logic 함수 만들고 사용하기

생성과 화면

워크스페이스 탐색 모음이나 CMD+J(macOS), CTRL+J(Windows)로 Logic을 엽니다. Files의 +New > AIP Logic으로도 만들 수 있습니다. 파일은 홈 폴더가 아니라 프로젝트 폴더에 저장해야 합니다.

왼쪽은 입력, 블록과 출력 구성, 가운데는 Debugger, 오른쪽은 Run 패널입니다. 오른쪽 사이드바에는 Automate와 Evals 연동이 있습니다.

입력, 블록과 출력

입력 이름과 자료형을 지정합니다. 지원 입력은 array, boolean, date, double, float, integer, long, media reference, model, object, object list, object set, short, string, struct, timestamp입니다.

블록에는 변수 생성, 액션 적용, 함수 실행, LLM 사용, 반복과 조건 분기가 있습니다. 이전 블록의 출력을 다음 블록에서 사용할 수 있습니다. 블록 중간 출력은 기본값 또는 객체가 될 수 있습니다. 마지막 경로는 함수 출력을 정의하며 값(Value) 또는 Legacy 모드의 온톨로지 편집 목록을 반환합니다. 적용 대기 쓰기 모드는 편집 목록을 반환하는 방식과 다릅니다.

실행과 Debugger

Run 패널에서 시험 입력으로 실행하면 Debugger가 열립니다. 블록 카드를 펼치거나 접고, 도구 호출 표시를 정리하며 생성 프롬프트와 실행 단계를 조사할 수 있습니다.

Run 아래의 최근 실행을 선택하면 출력과 로그를 다시 볼 수 있습니다. 기본 사용자 권한 모드에서는 자신의 로그만 볼 수 있고 프로젝트 권한 모드에서는 프로젝트 접근자가 로그를 볼 수 있습니다.

단위 평가 아이콘을 선택하면 입력을 사례로 저장합니다. Modify columns에서 매개변수 이름, 자료형과 선택성을 수정합니다. Run history > Add as test case는 이전 실행을 새 모음이나 기존 모음의 사례로 추가합니다. Evals 탭의 Generate evals는 사례, 평가 함수와 지표를 생성하며 업무에 맞게 수정해야 합니다.

다른 앱에서 함수 사용

Logic 함수는 플랫폼 함수로 사용할 수 있습니다. 액션의 기반 함수로 연결한 뒤 Workshop에서 액션을 호출하거나, 문자열을 반환하여 Workshop Markdown 위젯의 내용을 계산할 수 있습니다. 다른 Logic 함수나 객체 함수에서도 호출할 수 있습니다.

Uses에서는 외부 터미널에서 실행할 curl 요청을 복사할 수 있습니다. 온톨로지 편집을 반환하는 Logic에는 이 경로가 제공되지 않습니다.

온톨로지 변경 적용

Logic 편집기의 실행은 시나리오에 제안된 편집을 Debugger로 보여 주며 실제 온톨로지에는 적용하지 않습니다. 실제 적용은 액션이나 해당 모드에 맞는 Automate 실행 경로를 사용합니다.

Use LLM의 Apply actions 도구에 사용할 액션을 구성하고 적용 조건을 지시합니다. 함수를 게시하고 해당 함수를 기반으로 새 액션을 만든 뒤 Workshop에서 실행할 수 있습니다.

Automations 아이콘으로 자동화 생성을 시작할 수도 있습니다. 적용 대기 쓰기는 액션 효과, Legacy 편집 목록 함수는 Logic 효과를 사용하는 연동 조건을 확인합니다.

브랜치와 버전 비교

브랜치에서 분리하여 개발하고 게시하면 같은 브랜치를 이해하는 Workshop 같은 앱에서 사용할 수 있습니다. 승인된 변경 제안으로 병합합니다. 버전 이력에서는 두 버전의 블록 추가, 삭제와 수정 사항을 비교할 수 있습니다.