갤러리와 에셋

갤러리와 에셋 도구를 사용하면 어시스턴트가 내가 Nodaro에서 이미 만든 것을 찾고, 보여 주고, 다시 쓸 수 있습니다. browse_gallery와 browse_uploads는 내 결과와 업로드를 그리드로 보여 주고, get_asset과 display_asset은 결과 하나를 가져오거나 보여 줍니다. get_app_run은 워크플로나 앱 실행을 확인하고, list_favorites와 favorite_asset은 즐겨찾기를 관리합니다. 어느 도구도 크레딧이 들지 않습니다.

browse_gallery

내 갤러리를 썸네일로 이루어진 대화형 그리드로 보여 줍니다. 타일을 클릭해 보거나, 복사하거나, 다음 편집에 쓸 수 있습니다. 사용자가 작업물을 보고 싶어 할 때 사용하고, 어시스턴트에게 데이터만 필요할 때는 list_jobs를 사용하세요.

권한: assets:read. 크레딧: 무료.

반환값: MCP Apps를 표시하는 클라이언트에서는 그리드를 보여 주고, 데이터로는 항목과 next_cursor를 반환합니다.

공개 범위는 웹의 공개 갤러리가 보여 주는 것을 같은 검토 기준으로 보여 줍니다. 그래서 한 페이지의 항목이 limit보다 적을 수 있습니다. next_cursor가 없어질 때까지 계속 따라가세요.

내 갤러리에는 내 EDL 적용 렌더도 나열됩니다. 동영상 렌더는 video에, 오디오 렌더는 audio에 들어갑니다. 미리 보기 품질로 만든 렌더에는 preview: true가 있고, 텍스트 줄에 (preview)가 표시됩니다. 공개 범위에는 EDL 적용 렌더가 나열되지 않습니다.

browse_uploads

Nodaro가 생성한 결과가 아니라 내가 업로드한 파일을 보여 줍니다. 이전에 업로드한 파일을 새 생성의 입력으로 고를 때 사용하세요. 그리드의 Use(사용) 버튼을 누르면 파일의 id가 채팅으로 전달됩니다.

권한: assets:read. 크레딧: 무료.

반환값: URL과 id가 있는 업로드 목록, 그리고 nextCursor입니다. 미리 보기 품질로 만든 EDL 적용 렌더에는 preview: true가 있고, 텍스트 줄에 (preview)가 표시됩니다.

get_asset

결과 하나의 출력 URL, 프롬프트, 모델 같은 세부 정보를 반환합니다. 내 작업은 상태와 관계없이, 다른 사용자의 작업은 공개되고 완료된 것만 반환합니다. 실패한 작업에는 retryable, guidance, 그리고 있는 경우 suggestedProvider를 덧붙입니다. 이 필드는 작업이 실패할 때에서 설명합니다.

권한: assets:read. 크레딧: 무료.

반환값: input을 제외한 작업 엔벨로프입니다.

display_asset

결과 하나를 채팅에 보여 줍니다. 사용자는 데이터 대신 이미지, 동영상, 오디오를 봅니다. 이미지에는 Animate(애니메이션), Edit(편집), Recreate(다시 만들기) 버튼과 전체 화면 보기도 붙습니다. 어시스턴트에게 세부 정보만 필요하면 get_asset을 사용하세요.

권한: assets:read. 크레딧: 무료.

반환값: 미디어 카드와, 데이터로 제공되는 결과의 세부 정보입니다.

get_app_run

워크플로 실행이나 게시된 앱 실행의 진행 상황을 반환합니다. 실행 상태, 각 노드의 상태, 그리고 지금까지 만들어진 모든 출력 URL과 각각의 프롬프트, 모델, 작업 id입니다. 작업 ID 대신 실행 ID(execution_id)를 반환하는 run_workflow, render_final, run_app 다음에 사용하세요. get_job은 실행 ID를 찾지 못합니다. 실행이 pending이나 running인 동안 5~10초마다 호출하세요.

권한: assets:read. 크레딧: 무료.

반환값: 실행 상태, 노드 상태, 지금까지의 출력입니다.

• executionId, status, errorMessage, 그리고 개수 total, completed, failed, skipped, skippedForEmptyInput이 담긴 summary입니다.
• nodeStates는 워크플로 순서대로 노드마다 하나씩 있는 항목으로, id, label, nodeType, status, error, jobId, text, media가 담깁니다. text는 노드의 텍스트 출력으로 1,500자에서 잘리며, 잘렸으면 textTruncated: true가 붙습니다. media는 노드가 만든 모든 이미지, 동영상, 오디오 URL을 각각 { kind, url }로 나열합니다. skipReason: "empty_input"은 이번 실행에서 노드의 입력에 아무것도 도달하지 않았다는 뜻입니다.
• outputs는 실행의 모든 미디어 URL로, 그것을 만든 작업의 prompt, model, createdAt이 함께 담깁니다.

실행이 완료되면 outcome도 담깁니다. 입력에 아무것도 도달하지 않아 건너뛴 노드가 하나 이상 있고 실패한 것이 없으면, 예를 들어 새 게시물을 찾지 못한 피드라면 결과는 "nothing_new"입니다. 그 밖에는 "succeeded"입니다. 실패하거나 취소된 실행에는 결과가 아니라 status가 있습니다.

list_favorites

즐겨찾기한 결과의 작업 id를 최신순으로 나열합니다.

권한: assets:read. 크레딧: 무료.

반환값: 즐겨찾기한 결과의 작업 id입니다. 즐겨찾기한 내 EDL 적용 렌더도 나열되며, 미리 보기에는 preview: true가 있습니다. 다른 사람의 렌더는 나열되지 않습니다.

favorite_asset

결과를 즐겨찾기에 추가하거나 제거합니다. 결과는 내 작업일 수도 있고 다른 사용자의 공개 작업일 수도 있습니다. favorited: true를 지정한 list_jobs는 내가 즐겨찾기한 작업을 나열합니다.

권한: assets:write. 크레딧: 무료.

반환값: 확인 메시지입니다.