연동 문제 해결

연동이 연결되지 않거나, 작동을 멈추거나, 작업을 완료할 수 없는 경우 이 가이드를 사용하여 연결, 계정 액세스 및 선택한 리소스를 확인하세요.

이 페이지에서는 Atoms에서 발생하는 일반적인 연결 및 인증 문제를 다룹니다. 서비스별 설정, 지원되는 작업 또는 앱 내부 구성에 대해서는 연동 연결 및 관리에서 시작하여 해당 서비스의 가이드를 선택하세요.

다음 항목부터 확인하세요

1. 실패가 발생하는 위치를 확인하세요. Chat에서 에이전트가 서비스를 사용할 수 없나요, 아니면 기능이 앱에서만 실패하나요? Chat용으로 서비스를 연결했다고 해서 앱이 올바르게 구성되었다는 뜻은 아닙니다. 앱에서만 실패하는 경우 연동 연결 및 관리를 참조하세요.
2. 연동을 여세요. 프로젝트의 Chat에서 메시지 입력창 옆의 옵션 메뉴를 연 다음 Connectors → Add connectors를 선택하세요. 서비스를 검색하여 선택하세요. 연결되어 있는지, 아니면 여전히 Connect가 표시되는지 확인하세요. 일부 서비스는 자체 관리 화면을 엽니다.
3. 서비스 자체에서 액세스를 확인하세요. 연결하려는 계정이 관련된 정확한 파일, 리포지토리, 캘린더, 속성 또는 기타 리소스를 열 수 있는지 확인하세요.
4. 무엇이든 변경하기 전에 오류를 저장하세요. 정확한 메시지, 시간 및 시간대, 영향을 받은 프로젝트 또는 Chat, 마지막으로 성공한 시도를 기록하세요. 스크린샷에서는 개인 정보를 가리세요.

Chat 입력 옵션을 열고 Connectors(1)를 선택한 다음 Add connectors(2)를 선택하여 사용 가능한 연동을 찾아보세요.

Settings → Connectors 에서도 사용 가능한 연결을 관리할 수 있습니다. 확인하려는 연동을 선택하세요.

자격 증명은 비공개로 유지하세요. 비밀번호, 로그인 코드, API 키, 액세스 토큰 또는 기타 비밀 정보를 Chat이나 지원 요청에 절대 붙여넣지 마세요. 자격 증명은 서비스의 로그인 흐름 또는 지정된 보안 구성 필드에만 입력하세요.

문제 찾기

연동을 찾을 수 없거나 시작할 수 없습니다

1. Add connectors 를 사용해 카탈로그를 검색하세요. Chat 메뉴의 더 짧은 목록은 전체 카탈로그가 아닙니다.
2. Atoms에서 이 기능은 프로젝트 내에서만 사용할 수 있다고 표시되면, 해당 프로젝트를 열고 այնտեղ서 다시 시도하세요.
3. 컨트롤이 비활성화되어 있다면 설명을 읽어보세요. 다른 역할이나 권한이 필요하다면 프로젝트 또는 워크스페이스 소유자에게 도움을 요청하세요. 제한을 우회하기 위해 다른 서비스를 연결 해제하지 마세요.

결과 확인: 서비스의 연결 또는 관리 화면을 열 수 있어야 합니다. 그래도 표시되지 않으면 연동 연결 및 관리를 확인하거나 지원팀에 문의하여 사용 가능 여부를 확인하세요. 누락된 서비스가 반복적인 로그인 시도로 활성화될 수 있다고 가정하지 마세요.

인증이 완료되지 않습니다

1. Connect 를 한 번 선택하고 서비스의 로그인 창이 나타나는지 확인하세요. 브라우저에서 팝업이 차단되었다고 표시되면 Atoms 사이트에 대해 팝업을 허용한 뒤 다시 시도하세요. Chrome에서는 특정 사이트의 팝업 허용 방법 안내를 따르세요. 모든 사이트에 대해 팝업을 활성화할 필요는 없습니다.
2. 의도한 계정을 선택하고 요청된 액세스를 검토하세요. 창을 닫기 전에 서비스의 인증 흐름을 완료하세요.
3. 서비스에서 조직이 앱 또는 요청된 액세스를 차단했다고 명시적으로 표시하면 해당 메시지를 저장하고 관리자에게 문의하세요. 조직의 정책을 우회하지 마세요.
4. Atoms로 돌아가 연동을 다시 열어 상태를 확인하세요. 로그인 창을 닫는 것만으로는 인증이 성공했다는 확인이 아닙니다.

인증을 완료하기 전에 요청된 액세스를 검토하세요. 계정을 인증했다고 해서 의도한 리소스가 연결되었다는 뜻은 아닙니다.

인증에 조직 또는 워크스페이스 선택기가 포함되어 있다면 의도한 선택이 맞는지 확인하고 요청된 권한을 검토하세요.

결과 확인: 연동이 연결됨으로 표시되어야 합니다. 표준 레이아웃을 사용하는 커넥터 상세 화면에서는 Connect가 Disconnect 및 Try it out으로 바뀝니다. 다른 서비스는 자체 레이아웃을 가질 수 있습니다. 여전히 Connect가 표시되거나 오류가 나타나면 그 결과를 캡처하고 새로 한 번 시도한 후 지원팀에 문의하세요.

잘못된 계정이 연결되어 있습니다

연동의 관리 화면에 계정이 표시된다면, 해당 계정을 리소스를 소유하거나 액세스할 수 있는 계정과 비교하세요. 모든 커넥터가 연결된 계정을 표시하는 것은 아니므로, 브라우저에 현재 로그인된 상태만으로 Atoms가 어떤 계정을 사용 중인지 증명할 수는 없습니다.

의도한 계정으로 서비스에서 리소스를 직접 여세요. 해당 계정이 액세스할 수 없다면 먼저 리소스 소유자에게 액세스를 요청하세요. 연결이 잘못된 계정을 사용하고 있다면 서비스의 계정 전환 안내를 따르거나 안전하게 다시 연결한 뒤 인증 중에 올바른 계정을 명시적으로 선택하세요.

결과 확인: 작고 지원되는 읽기 요청이 의도한 리소스를 반환해야 합니다. 그래도 어떤 계정이 연결되어 있는지 확인할 수 없다면 반복적으로 연결 해제하지 말고 지원팀에 문의하세요.

연동은 연결되어 있지만 에이전트가 데이터를 찾지 못합니다

1. 연결을 확인하세요. Connectors 에서 연동의 세부 정보를 열고 연결되어 있는지 확인하세요. 표시되는 경우 선택된 계정 또는 리소스도 확인하세요.
2. 정확한 리소스를 확인하세요. 의도한 계정으로 서비스에서 직접 여세요. 관련이 있다면 올바른 조직, 워크스페이스, 폴더 또는 속성을 포함해 위치와 액세스 권한을 확인하세요.
3. 요청을 구체적으로 작성하세요. 커넥터가 지원하는 경우 서비스 이름과 정확한 리소스 이름 또는 링크를 제공하세요. 여러 리소스를 한 번에 검색하고 변경하려 하기보다 먼저 지원되는 읽기 작업 하나를 요청하세요.

예를 들어 커넥터가 문서 읽기를 지원하는 경우: “[service]를 사용해 [document name or link]를 읽고 제목을 알려줘. 변경하지는 마.”

결과 확인: 에이전트가 의도한 리소스를 반환해야 합니다. 직접 액세스는 되는데도 에이전트가 여전히 읽지 못한다면 커넥터의 지원 기능과 부여된 액세스를 확인하세요. 인증 문제의 증거가 있는 경우에만 다시 연결하세요.

에이전트가 데이터를 읽을 수는 있지만 변경할 수는 없습니다

읽기에 성공했다고 해서 커넥터가 요청된 변경을 지원하거나 이를 수행할 권한이 있다는 뜻은 아닙니다.

1. 연동 연결 및 관리 또는 표시되는 경우 커넥터의 What you can do 목록을 확인하세요. 요청한 작업이 지원되는지 확인하세요.
2. 연결된 계정이 해당 정확한 리소스에 대해 그 변경을 수행할 수 있는지 확인하세요. 필요한 최소한의 액세스만 리소스 소유자 또는 관리자에게 요청하세요.
3. 오류 또는 확인 요청을 읽어보세요. 추가 인증이 필요하다면 서비스의 문서화된 흐름을 따르세요. 다시 연결해도 커넥터가 지원하지 않는 작업이 추가되지는 않습니다.

쓰기 작업을 다시 시도하기 전에: 대상 위치를 확인하여 첫 번째 시도에서 이미 무언가가 생성되거나 변경되었는지 살펴보세요. 실패 응답만으로는 변경이 없었다고 증명하기에 충분하지 않습니다. 이전 결과를 확인하기 전까지 결제, 메시지, 초대 또는 레코드 생성을 반복하지 마세요.

결과 확인: 지원되는 변경이 적절한 테스트 리소스에서 성공하고, 서비스에서 직접 이를 확인할 수 있어야 합니다. 결제 또는 기타 실제 워크플로의 경우 실제 거래 대신 서비스별 테스트 안내를 사용하세요.

이전에 작동하던 연결이 중단되었습니다

마지막으로 성공한 요청 이후 무엇이 바뀌었는지 확인하세요. 계정, 해당 계정의 리소스 액세스 권한, 조직의 앱 정책 또는 연결의 인증 상태가 바뀌었을 수 있습니다.

1. Atoms에서 연동을 다시 열고 여전히 연결되어 있는지 확인하세요.
2. 서비스에서 리소스를 직접 열어보세요. 액세스가 제거되었다면 리소스 소유자 또는 관리자와 해결하세요.
3. 오류에 인증이 만료되었거나, 취소되었거나, 유효하지 않다고 표시되면 안전하게 다시 연결을 따르세요. 오류가 서비스 장애, 제한 또는 지원되지 않는 작업과 관련된 경우 먼저 그 원인을 해결하세요.

결과 확인: 작은 읽기 요청이 다시 작동해야 합니다. 동일한 오류가 계속되면 마지막으로 성공한 시간과 함께 저장한 뒤 지원팀에 문의하세요.

결과가 최신이 아니거나 요청이 계속 실패합니다

1. 결과를 서비스 자체와 비교하세요. 관련이 있다면 계정, 리소스, 날짜 범위, 필터 및 시간대를 확인하세요. 대화의 이전 답변에 의존하지 말고 에이전트에게 현재 값을 가져오도록 요청하세요.
2. 명시적인 시간 초과 또는 서비스 사용 불가 오류가 발생하면 서비스의 공식 상태 페이지 또는 도움말 페이지를 확인하세요. 오류에 재시도 시간이 표시되면 그때까지 기다리세요. 제한이나 장애가 지속되는 동안 반복적으로 요청을 보내지 마세요.
3. 전송되지 않은 텍스트를 저장하고 Atoms를 새로고침한 뒤 커넥터 상태를 다시 확인하세요. 페이지를 새로고침하는 것은 계정을 다시 인증하는 것과 다릅니다.
4. 작은 읽기 요청 하나를 다시 시도하세요. 외부 데이터를 변경하는 작업을 다시 시도하기 전에는 이전 결과가 대상에 반영되었는지 확인하세요.

결과 확인: 새 결과가 서비스의 의도한 리소스와 일치해야 합니다. 여전히 올바르지 않다면 예상값과 실제값을 타임스탬프와 함께 지원팀에 보내세요. 모든 연동이 동일한 일정으로 업데이트된다고 가정하지 마세요.

안전하게 다시 연결하기

인증이 유효하지 않거나 잘못된 계정이 연결된 경우에만 다시 연결하세요. 실패한 모든 요청의 첫 단계로 사용하지 마세요.

연결을 해제하기 전에: 연결에 의존하는 작업을 완료하거나 일시 중지하고, 보류 중인 외부 쓰기 작업의 결과를 확인하고, 필요한 액세스 권한으로 다시 로그인할 수 있는지 확인하세요. 연결을 해제하면 다시 연결될 때까지 해당 연결을 사용할 수 없습니다. 추가 영향이 있는지 연동 연결 및 관리를 확인하세요. 연결 해제가 이전 변경 사항을 되돌리거나 이미 전송된 작업을 취소한다고 가정하지 마세요.

1. 서비스의 연결 세부 정보를 여세요. 자체 계정 관리 화면이 있다면 해당 연동의 안내를 따르세요.
2. 표준 커넥터 상세 화면에서는 준비가 되었을 때 Disconnect를 선택한 다음 Connect를 선택하세요. 연결 해제 전에 추가 확인이 있을 것이라고 가정하지 마세요.
3. 의도한 계정을 선택하고 인증을 완료하세요. 요청된 권한을 검토하세요.
4. Atoms로 돌아가 연결 상태를 확인하세요.
5. 원래 작업을 다시 시작하기 전에 아래의 복구 확인을 실행하세요.

동일한 오류가 다시 발생하면 다시 연결을 중단하고 오류 내용과 이미 완료한 확인 사항을 포함해 지원팀에 문의하세요.

문제가 해결되었는지 확인하기

1. 직접 확인할 수 있는 리소스에 대해 지원되는 읽기 전용 작업 하나를 요청하세요. Try it out을 사용하는 경우 전송 전에 제안된 프롬프트를 검토하세요.
2. 응답을 서비스 자체와 비교하세요. 단순히 연결 표시만 보지 말고 올바른 리소스, 계정 컨텍스트 및 요청한 결과를 확인하세요.
3. 작업에 변경이 필요하다면 적절한 테스트 리소스 또는 서비스의 문서화된 테스트 워크플로를 사용하고 대상 위치에서 결과를 확인하세요.

연결 상태와 선택된 리소스를 확인하세요. 연결 표시만으로는 예상한 데이터를 사용할 수 있거나 최신 상태라는 뜻이 아닙니다.

조직과 프로젝트를 확인한 다음 Dashboard를 열어 변경 없이 리소스를 검사하세요. 연결 해제는 이 확인의 일부가 아닙니다.

확인이 통과하면 작업을 재개하세요. Chat에서는 작동하지만 앱 내부 기능이 여전히 실패한다면 연동 연결 및 관리 또는 빌드 및 미리보기 문제 해결을 참조하세요. 실패가 발생하는 환경을 확인하세요. Chat 요청이 성공했다고 해서 앱이 올바르게 구성되었다는 증거는 아닙니다.

도움 받기

문제가 계속되면 지원 받기를 사용하고 다음 내용을 포함하세요.

• 연동 이름과 Atoms 계정 이메일
• 영향을 받은 프로젝트 또는 Chat 링크, 그리고 실패가 Chat에서 발생하는지 앱에서 발생하는지 여부. 앱의 경우 영향을 받은 환경을 식별하세요.
• 조사에 필요한 비밀이 아닌 식별자만 사용한 의도한 서비스 계정 및 리소스
• 정확한 오류, 날짜, 시간 및 시간대. 알고 있다면 마지막으로 성공한 시간도 포함하세요.
• 재현 단계, 예상 결과, 실제 결과 및 이미 시도한 확인 사항
• 브라우저와 기기, 그리고 유용하다면 민감 정보를 가린 스크린샷 또는 짧은 녹화

쓰기 작업이 실패한 경우 대상 위치에 변경 완료가 표시되는지, 변경이 없는지 또는 결과를 알 수 없는지 알려주세요. 모든 첨부 파일에서 비밀번호, 로그인 코드, API 키, 토큰 및 관련 없는 개인 데이터를 제거하세요.