n8n용 Minds: 설치 및 워크플로우 가이드
n8n-nodes-minds를 사용하여 자체 호스팅 n8n에서 Study를 준비하고 검사하세요. 버전 0.1.1이 npm에 게시되었으며, n8n 검증이 검토 중입니다. 연구는 Minds에서 별도의 확인을 거친 후에만 시작됩니다.
Minds는 상업적 합성 연구를 위한 엔드투엔드 플랫폼입니다. Minds 커뮤니티 노드는 귀하의 n8n 워크플로우를 Minds의 Study API에 연결합니다. Study를 생성하고, 검토 가능한 계획을 준비하며, 다운스트림 워크플로우를 위해 기존 결과를 수집할 수 있습니다. 또한 Minds 작업을 n8n AI 에이전트의 도구로 노출할 수도 있습니다.
가용성 및 요구 사항
Minds가 유지 관리하는 패키지 n8n-nodes-minds가 npm에 게시되어 있습니다. 이 가이드는 npm의 현재 릴리스인 버전 0.1.1을 다룹니다. 자동화된 n8n 검토는 통과했으나, 수동 검증은 검토 중입니다. 아직 검증된 목록이 아니며, n8n Cloud에서는 노드를 설치할 수 없습니다.
커뮤니티 패키지를 허용하는 자체 호스팅 n8n 인스턴스, 설치 권한이 있는 소유자 또는 관리자, 그리고 API 액세스 권한이 있는 Minds 계정이 필요합니다. 기존 API 권한 및 사용 제한이 그대로 적용됩니다. 노드는 n8n 내부에서 구성하며, Minds에서 설정해야 할 OAuth 연결은 없습니다.
설치 및 연결
- n8n에서 Settings → Community Nodes → Install을 엽니다.
[email protected]을 입력하고 n8n의 커뮤니티 코드 고지 사항을 검토한 후 설치합니다. 인스턴스에서 다른 설치 방법을 사용하는 경우 n8n 설치 가이드를 참조하세요.- Minds에서 Settings → API Keys를 열고 이 통합을 위한 키를 생성합니다.
- n8n 워크플로우에 Minds 노드를 추가합니다. Minds API 자격 증명을 생성하고, API Key에 키를 붙여넣고 저장한 뒤 연결 테스트를 실행합니다.
- Study → Get Many를 선택하고 실행하여 액세스를 확인합니다. 빈 목록이 반환되면 해당 계정에 아직 Study가 없는 것일 수 있습니다.
n8n은 암호화된 자격 증명 시스템에 키를 저장합니다. 노드 표현식, 워크플로우 JSON, 프롬프트 또는 내보낸 파일이 아닌 해당 자격 증명 내에 키를 보관하세요. 요청은 https://getminds.ai/api/v1으로 전송됩니다. 연결 테스트는 인증된 Minds 계정을 확인합니다. 액세스 세부 정보는 API 인증을 참조하세요.
지원되는 작업
5가지 작업 모두 Study 리소스를 사용합니다. n8n은 API의 data 페이로드를 직접 노출하므로, 생성된 Study의 ID는 다음 노드에서 {{ $json.id }}로 사용할 수 있습니다.
| 작업 | 입력 및 동작 |
|---|---|
| Get Many | 액세스 가능한 Study 목록을 나열합니다. Limit를 1에서 100까지 설정하거나, 페이지네이션을 위해 Return All을 활성화하세요. |
| Create | Name이 필요합니다. Audience IDs는 기존 Audience의 ID를 쉼표로 구분하여 입력받습니다. Link Sharing은 기본적으로 꺼져 있으며, 켜면 Study와 연결된 Audience에 대한 액세스가 게시됩니다. |
| Get | Study ID가 필요하며, Study, Audience, Minds 및 메시지를 검색합니다. |
| Preview Research Plan | Study ID와 Research Request가 필요합니다. Study Locale을 선택하고, Source Kind, Source Label, Source Content 또는 Source URL을 통해 응답자가 볼 수 있는 자료를 별도로 제공하세요. 연구를 시작하지 않고 계획 초안을 저장합니다. |
| Get Summary | Study ID가 필요하며, 저장된 Study 요약 및 의미론적 출력 블록을 읽습니다. 누락된 요약을 생성하거나 새로 고치지 않습니다. |
질문할 내용과 같은 계획자 지침은 Research Request를 사용하세요. 응답자가 평가해야 할 실제 내용은 Source Content에 넣으세요. Source Content는 Prompt 소스 종류에서 사용할 수 있습니다. 웹사이트, 이미지, 비디오 등 다른 종류의 경우 공개 HTTPS URL과 함께 Source URL을 사용하세요. 소스 종류를 선택한다고 해서 로컬 파일이 업로드되지는 않습니다.
연구 계획 준비
- Manual Trigger와 Study → Create로 설정된 Minds 노드로 시작하세요. 설명적인 이름과 사용하려는 기존 Audience ID를 입력하세요. 액세스를 게시할 의도가 없다면 링크 공유는 끄세요.
- Preview Research Plan으로 설정된 다른 Minds 노드를 연결하세요. Study ID에는
{{ $json.id }}를 사용하세요. - Research Request를 다음과 같이 설정하세요: “명확성, 관련성, 신뢰성에 관한 세 가지 질문을 초안으로 작성하세요. 연구를 실행하지 마세요.” 출력 언어를 선택하고, Source Kind를 Prompt로 선택한 뒤, 실제 메시지나 개념을 Source Content에 넣으세요.
- 워크플로우를 한 번 실행하세요. Minds에서 저장된 초안, Audience, 질문 및 소스를 검토한 다음, 거기서 명시적으로 확인하고 연구를 시작하세요.
- 이후 워크플로우 실행 시, 저장된 Study ID와 함께 Get을 사용하여 Study를 검사하고 Get Summary를 사용하여 기존 요약을 수집하세요. 결과 데이터를 적절한 보고 또는 알림 노드로 전달하세요.
워크플로우 실행 간에 Study ID를 유지하세요. Create를 다시 실행하면 다른 Study가 생성되며, 이전 Study를 재개하지 않습니다. 성공 여부를 확인하기 전까지 모호한 시간 초과 후 자동으로 생성을 재시도하지 마세요.
Minds를 AI 에이전트 도구로 사용
n8n AI Agent와 호환되는 채팅 모델을 추가한 다음, 에이전트의 도구 커넥터에 Minds를 연결하세요. Minds API 자격 증명, Study 리소스 및 노출하려는 특정 작업을 선택하세요. Get Many 또는 Create로 시작하고 도구에 명확한 설명을 제공하세요.
예: “구성된 Minds 도구를 사용하여 Commuter bottle review라는 이름의 Study 초안을 하나 생성하세요. ID를 반환하세요. 연구를 시작하지 마세요.” 도구 구성에서 Name을 설정하거나, 에이전트가 선택하도록 의도한 필드에 대해 n8n의 모델 정의 매개변수 제어를 사용하세요. 모델 프롬프트에서 자격 증명을 제외하고 링크 공유는 비활성화된 상태로 두세요. 도구는 일반 노드와 동일한 5가지 작업을 수행하며, 에이전트에 추가한다고 해서 연구 실행이 활성화되지는 않습니다.
예시 및 문제 해결
n8n의 Import from File을 통해 예시 워크플로우를 가져오세요: Study 목록 나열, 연구 계획 준비 또는 Study 요약 읽기. 가져온 후 자신의 자격 증명을 선택하고 필요한 Audience 또는 Study ID를 입력하세요.
- 노드 누락: 정확한 패키지 이름, 설치 상태, 자체 호스팅 인스턴스가 커뮤니티 노드를 허용하는지 확인하세요. n8n Cloud는 이 미검증 패키지를 설치할 수 없습니다.
- 연결 테스트 또는 401 오류: 자격 증명에 현재 Minds API 키가 포함되어 있는지 확인하고, 취소된 키를 교체한 후 다시 테스트하세요.
- 403 또는 계획 제한 응답: 계정의 API 액세스, 작업 공간 권한 및 현재 사용 허용량을 확인하세요.
- Study를 찾을 수 없음: 동일한 계정에 대해 Get Many가 반환한 ID를 사용하세요. Study 이름은 ID가 아닙니다.
- 요약 없음: Minds에서 Study를 열고 연구가 완료되었으며 요약이 존재하는지 확인하세요. Get Summary는 저장된 출력만 읽습니다.
- 429 또는 일시적인 서비스 오류: 백오프를 사용하여 읽기를 재시도하고 API 오류 및 제한을 따르세요. 쓰기를 재시도하기 전에 이미 생성된 Study가 있는지 확인하세요.
버전 0.1.1은 Audience 생성, 파일 업로드, 연구 시작, 데이터 삭제 또는 Minds 이벤트 트리거를 제공하지 않습니다. 추가 작업은 Study API 및 MCP 문서를 참조하세요. 합성 결과는 방향성 증거를 제공하며, 대표적인 인간 인구 추정치를 확립하지 않습니다.
모든 통합을 찾아보거나 n8n audience-check 워크플로우를 확인하세요.
