문제 해결

Studio 사용 중 자주 발생하는 문제와 확인 방법입니다. 오류가 반복되면 화면의 오류 메시지, 발생 시각, 사용한 모델/도구/워크플로우 이름을 함께 관리자에게 전달하세요.

로그인과 계정

증상	확인할 내용	조치
로그인할 수 없음	이메일, 비밀번호, 계정 상태를 확인합니다.	비밀번호를 재입력하고, 계속 실패하면 관리자에게 계정 상태를 문의합니다.
관리 메뉴가 보이지 않음	현재 사용자에게 관리 메뉴 접근 권한이 있는지 확인합니다.	사용자 관리나 역할 운영이 필요한 업무라면 역할 변경을 요청합니다.
특정 기능 버튼이 보이지 않음	에이전트, 워크플로우, MCP 생성 권한이 있는지 확인합니다.	권한과 공유를 참고해 필요한 역할을 요청합니다.

채팅

증상	확인할 내용	조치
모델 목록이 비어 있음	사용 가능한 모델이 설정되어 있는지 확인합니다.	관리자에게 모델 설정을 확인해 달라고 요청합니다.
응답이 너무 느림	큰 파일, 많은 도구, 긴 대화 맥락이 포함되어 있는지 확인합니다.	새 채팅에서 핵심 정보만 전달하거나, 도구 수를 줄여 다시 시도합니다.
도구를 사용하지 않음	도구 사용 모드가 사용 안함인지 확인합니다.	자동 또는 수동 모드로 바꾸거나 `@mention`으로 도구를 직접 지정합니다.
`@mention`에서 리소스가 검색되지 않음	에이전트, 워크플로우, MCP 도구의 공유 범위와 게시 상태를 확인합니다.	리소스 소유자에게 공유 범위 변경 또는 워크플로우 게시를 요청합니다.
공유 링크에 최신 메시지가 없음	공유 후 추가된 메시지인지 확인합니다.	최신 내용을 포함하려면 새 공유 링크를 생성합니다.
공유 링크가 만료됨	링크 생성 시 선택한 만료 기간이 지났는지 확인합니다.	원본 채팅에서 새 공유 링크를 생성하거나 공유자에게 새 링크를 요청합니다.

에이전트

증상	확인할 내용	조치
에이전트가 역할을 지키지 않음	지침에 역할, 목표, 응답 형식이 명확히 적혀 있는지 확인합니다.	지침을 짧은 섹션으로 나누고 금지 사항과 출력 형식을 추가합니다.
연결된 도구를 잘못 사용함	도구 사용 조건이 지침에 구체적으로 적혀 있는지 확인합니다.	"언제 어떤 도구를 먼저 사용할지"를 지침에 추가합니다.
공유된 에이전트를 편집할 수 없음	소유자와 공유 범위를 확인합니다.	소유자에게 수정 요청을 하거나 복제해 개인 에이전트로 관리합니다.
에이전트 실행 시 권한 오류가 남	연결된 MCP 도구나 워크플로우 권한을 확인합니다.	연결 리소스도 함께 공유되었는지 확인합니다.

MCP 도구

증상	확인할 내용	조치
MCP 서버가 오류 상태임	서버 URL, 인증 정보, 네트워크 연결을 확인합니다.	설정을 수정하고 새로고침 또는 도구 테스트를 실행합니다.
인증 필요 상태가 표시됨	OAuth 또는 토큰 인증이 필요한 서버인지 확인합니다.	인증을 진행한 뒤 다시 도구를 호출합니다.
도구 입력 오류가 발생함	입력 JSON이 스키마와 일치하는지 확인합니다.	도구 상세의 입력 스키마를 보고 필수 값을 채웁니다.
AI가 잘못된 도구를 선택함	도구 설명이 모호하거나 비슷한 도구가 많은지 확인합니다.	도구 사용자 지정 지침에 사용 조건과 제한 사항을 추가합니다.

워크플로우

증상	확인할 내용	조치
채팅에서 워크플로우가 보이지 않음	워크플로우가 게시 상태인지 확인합니다.	편집 화면에서 게시한 뒤 다시 채팅에서 `@mention`으로 검색합니다.
실행 결과가 비어 있음	Output 노드가 올바른 변수를 참조하는지 확인합니다.	마지막 단계의 출력 변수와 Output 노드 매핑을 확인합니다.
변수 선택 목록이 비어 있음	이전 노드가 연결되어 있고 출력 스키마가 정의되어 있는지 확인합니다.	노드 연결과 구조화된 출력 스키마를 저장합니다.
가져온 워크플로우가 실행되지 않음	마스킹된 API 키나 토큰이 있는지 확인합니다.	가져온 뒤 민감 값을 다시 입력하고 테스트합니다.
Tool 노드에서 실패함	연결된 MCP 도구의 입력 스키마, 인증 상태, 권한을 확인합니다.	MCP 상세 화면에서 같은 입력으로 도구 테스트를 먼저 실행합니다.

파일과 음성

증상	확인할 내용	조치
파일 업로드 실패	파일 형식과 용량 제한을 확인합니다.	파일을 압축하거나 지원 형식으로 변환해 다시 업로드합니다.
이미지 업로드 실패	이미지 파일인지, 크기가 제한 이하인지 확인합니다.	이미지를 압축하거나 필요한 부분만 잘라 업로드합니다.
음성 채팅이 시작되지 않음	브라우저 마이크 권한과 실시간 모델/API 키 설정을 확인합니다.	브라우저 권한을 허용하고, 계속 실패하면 관리자에게 모델 설정을 문의합니다.

관리자에게 전달할 정보

문제를 빠르게 해결하려면 다음 정보를 함께 전달하세요.

항목	예시
발생 시각	2026-06-05 10:30
화면	Studio > MCP 설정
작업	GitHub MCP 도구 테스트
오류 메시지	인증 필요, 입력 스키마 오류 등
사용한 리소스	모델명, MCP 서버명, 도구명, 워크플로우명
재현 방법	어떤 버튼을 누르고 어떤 입력을 했는지 순서대로 작성

관련 문서