# 결과를 사용자에게 넘기기 [색인](/llms.txt) · [자동화 경로](/docs/agents/api.md) · [Flow 1.1 스키마](/schema/flow-1.1.json) Arpelier 구조를 만들어 달라는 요청의 결과물은 사용자가 Arpelier 앱에서 여는 Flow 문서입니다(보여 주는 방법 `view`를 담으면 Flow 1.1, 없으면 1.0). 넘기는 방법은 지금 쓸 수 있는 도구에 따라 다릅니다. 표의 위에서부터 확인해 쓸 수 있는 첫 경로를 고르세요. | 지금 쓸 수 있는 도구 | 넘기는 방법 | 수치를 읽는 곳 | | --- | --- | --- | | 1. Arpelier 커넥터(MCP 도구 `arpelier_*`) | 검증·계산한 Flow로 `arpelier_open_in_app` 링크 | 서버 엔진(검증·계산·단면·측정·검사 도구) | | 2. 열린 Arpelier 탭에서 JavaScript를 실행하는 브라우저 도구 | `window.arpelier`로 그 탭에 직접 만들기 | 브라우저 엔진(`computeTo`·`getCrossSection`·`inspectStructure`) | | 3. 클릭과 입력만 하는 브라우저 조작 | 앱의 "Flow JSON 열기" 창에 붙여 넣기 | 앱이 열면서 계산합니다. 수치는 화면으로만 확인합니다 | | 4. 브라우저 조작 없음 | Flow JSON 파일(또는 JSON 코드 블록 하나)과 여는 방법 | 없음. 사용자가 앱에서 열어 계산합니다 | 구조를 어떻게 보여 줄지(투명·숨김 재료, 잘라내기, 카메라, 화풍)는 Flow의 `view`에 적으면 1·3·4번 경로가 프로젝트에 함께 넣고 미리보기도 따릅니다([Flow로 넘길 때](/docs/agents/tasks/real-structures.md#flow로-넘길-때)). 2번은 계산 뒤 `setView`로 정합니다. `setFlow`는 공정만 바꾸고 보기는 그대로 둡니다. Arpelier 링크는 `arpelier_open_in_app`이 만듭니다. 커넥터 미리보기(`arpelier_preview_structure`)의 "Arpelier에서 열기" 버튼은 이 도구를 쓸 수 없을 때 Flow를 주소에 담은 링크(`#flow=d1.…`)를 코드로 만들어 엽니다. 이 링크는 한 글자만 바뀌어도 열리지 않고 실제 Flow는 수천~수만 자가 되므로, AI가 대화에 옮겨 적거나 직접 지어 주지 마세요. `.apl` 파일은 사용자 계정의 키로 암호화되므로 AI가 만들 수 없습니다. ## 1. 커넥터가 있을 때 [MCP 결과와 계정 프로젝트 구분](/docs/agents/api.md#mcp-결과와-계정-프로젝트-구분)을 따릅니다. 링크(`url`)는 보통 Markdown 링크로 넘깁니다. MCP Apps를 표시하는 클라이언트에서는 `arpelier_preview_structure` 미리보기의 "Arpelier에서 열기" 버튼으로도 열 수 있습니다. MCP Apps를 표시하지 않는 클라이언트에서는 미리보기가 아무것도 보이지 않으므로 `arpelier_render_structure`의 PNG로 구조를 보여 줍니다. 링크 도구가 없거나 오류(`OPEN_IN_APP_*`)를 돌려주면 미리보기 버튼을 안내하고, 미리보기도 표시되지 않으면 4번처럼 Flow JSON을 넘깁니다. ## 2. 탭에서 JavaScript를 실행할 수 있을 때 브라우저 도구에 페이지에서 스크립트를 실행하는 기능(evaluate, JavaScript 실행 등)이 있고 열린 탭에서 `window.arpelier?.version === "1.0"`이면 [브라우저에서 모듈별로 만들기](/docs/agents/api.md#브라우저에서-모듈별로-만들기)를 따릅니다. API는 프로젝트를 만들거나 열지 않으므로 사용자가 새 프로젝트나 빈 프로젝트를 열어 두어야 합니다. 클릭과 입력만 할 수 있으면 3번입니다. ## 3. 클릭과 입력만 할 수 있을 때 API를 부를 수 없습니다. 개발자 도구 콘솔이나 주소창에 코드를 입력해 우회하지 마세요. 1. 완전한 Flow를 만들고 [엔진 없이 점검할 것](#엔진-없이-점검할-것)을 확인합니다. 2. Arpelier 대시보드에서 새 프로젝트 옆 폴더 아이콘(파일 열기)을 누르고 "Flow JSON 붙여넣기…"(Paste Flow JSON…)를 고릅니다. 프로젝트 편집기에서는 상단 AI로 작업(로봇 아이콘) 패널의 "Flow JSON 열기"(Open Flow JSON)를 누릅니다. 3. "Flow JSON 내용" 상자에 문서 전체를 넣습니다. 앱이 바로 검사해 상자 아래에 결과를 보입니다. - "열 수 있어요"(Ready to open)와 단계 수·크기가 보이면 "새 프로젝트로 열기"(Open as new project)를 누릅니다. - 고칠 곳이 보이면 그 JSON 경로와 이유대로 고친 문서 전체를 다시 넣습니다. 4. 앱이 저장 전 새 프로젝트로 열고 마지막 단계를 계산합니다. 계산이 끝난 화면에서 구조를 확인하고, 사용자에게 무엇을 보면 되는지 알립니다. 5. 저장은 사용자가 원할 때 사용자가 합니다. ## 4. 브라우저를 조작할 수 없을 때 1. 완전한 Flow를 만들고 [엔진 없이 점검할 것](#엔진-없이-점검할-것)을 확인합니다. 2. 파일을 만들 수 있으면 `<이름>.flow.json` 파일 하나로 줍니다. 아니면 문서 전체를 `json` 코드 블록 하나에 넣습니다. 생략(`...`), 주석, 끝 쉼표, 여러 조각으로 나누기가 있으면 앱이 열지 않습니다. 16 MB를 넘는 문서도 열 수 없습니다(마스크 도형이 많을 때 커집니다). 3. 여는 방법을 사용자의 언어로 알립니다. 예: > arpelier.com 대시보드에서 새 프로젝트 옆 폴더 아이콘을 누르고 이 파일을 고르거나 화면에 끌어다 놓으세요. 내용을 복사했다면 같은 메뉴의 "Flow JSON 붙여넣기"에 붙여 넣으세요. 앱이 검사한 뒤 저장 전 새 프로젝트로 열고 계산합니다. 저장해야 계정에 남습니다. 4. 앱이 고칠 곳을 보이면 사용자가 "고칠 곳 복사"(Copy problems)로 목록을 보내 줄 수 있습니다. 각 줄은 `JSON 경로: 이유`입니다. 그 경로를 고친 문서 전체를 다시 줍니다. 바뀐 부분만 주지 마세요. 5. 계산하지 않았다는 것을 밝힙니다. 두께·부피·빈 공간·접촉 같은 숫자는 설계 의도이며 Arpelier가 계산한 결과가 아닙니다. 6. 사용자가 링크와 계산된 수치를 원하면 MCP 커넥터를 추가할 수 있는 앱에서 `https://arpelier.com/mcp`를 연결하도록 안내합니다([AI 커넥터 안내](/reference/ai-connector)). "Flow JSON 열기"로 연 프로젝트에는 누가 만들었는지 알 수 없어 AI 생성 기록이 남지 않습니다. 기록은 링크(1번)나 브라우저 API(2번)로 만든 새 프로젝트를 처음 저장할 때만 남습니다. ## 엔진 없이 점검할 것 3·4번은 사용자가 열기 전까지 앱 검사를 받지 못합니다. 넘기기 전에 다음을 확인하세요. 코드를 실행할 수 있으면 JSON Schema([1.1](/schema/flow-1.1.json), `view`가 없으면 [1.0](/schema/flow-1.0.json))로 구조를 검사합니다. 이것은 구조 검사일 뿐이고 최종 판정은 앱의 검사입니다. - 하나의 JSON 객체이고 최상위 필드는 `schema`, `name`, `note`, `domain`, `gridResolution`, `displayUnits`, `materials`, `masks`, `processes`, `view`뿐입니다. `schema`는 `view`가 있으면 `https://arpelier.com/schema/flow-1.1.json`, 없으면 `https://arpelier.com/schema/flow-1.0.json`이고 `name`은 비어 있지 않습니다. - `view`가 있으면 필드가 `setView`와 같고([보기 설정](/docs/agents/api.md#보기-설정-보여주기)) `highlightMaterialIds`는 없습니다. 재료 ID는 이 Flow의 재료입니다. - `domain`에 양수 `LX`, `LY`, `dx`, `dy`(nm)가 있습니다. - 모든 공정에 서로 다른 `id`(영문·숫자·`_`·`.`·`-`, 160자 이내)와 [공정 목록](/docs/agents/processes.md)의 `kind`가 있습니다. 기판은 `SUBSTR`입니다. - 재료 ID가 [재료 목록](/docs/agents/materials.md)에 있고, 새 재료는 100–239로 `materials`에 정의했습니다. 식각 대상 `materialetch`는 `{ "18": 1 }` 같은 객체입니다. - PHOTO의 마스크 ID가 `masks`에 있고, PR이 남는 위치를 [마스크 극성](/docs/agents/masks.md) 표로 확인했습니다. - `GROUPSTART`와 `GROUPEND`가 짝을 이룹니다. - `GROUPEND`를 뺀 모든 공정에 사용자 언어로 쓴 `name`(그 단계의 역할만)과 `note`(공정 설명·치수와 출처·엔지니어 코멘트)가 있습니다([이름과 메모](/docs/agents/concepts.md#이름과-메모)). - 필드 이름과 형식이 [작은 예제](/docs/agents/examples/oxide-window.flow.json)나 [목적별 비교 Flow](/docs/agents/tasks/index.md)와 같습니다. ## 하지 말 것 - 사용자에게 개발자 도구 콘솔에 코드를 붙여 넣게 하지 마세요. "Flow JSON 열기"가 같은 일을 검사와 함께 합니다. - 직접 만든 GLB·STL·그림이나 손으로 어림한 수치를 Arpelier 결과로 내놓지 마세요. 3D 파일은 앱에서 연 뒤 내보내기로 만듭니다. - 사용자가 열거나 저장한 것을 확인하기 전에는 열었다거나 저장했다고 말하지 마세요.