연결 문제 해결

어제까지 되던 커넥터가 오늘 안 된다면 대개 다섯 가지 중 하나입니다. 이 페이지는 그 목록을, 자주 일어나는 순서대로 담았습니다.

여기서 시작하세요

에이전트 빌더에서 그 에이전트의 커넥터를 엽니다. 손봐야 할 연결은 거기 표시돼 있고, 해법은 거의 항상 다시 승인하는 것입니다.

다시 승인해도 바인딩은 유지됩니다. 같은 서비스를 같은 계정으로 연결하면 두 번째 연결이 생기는 게 아니라 기존 연결이 다시 승인되므로, 에이전트마다 다시 바인딩할 필요가 없습니다.

제공자는 일정 기간이 지나면 접근을 만료시킵니다. 빠른 곳도 있고 몇 달 뒤인 곳도 있습니다. 연결에 재승인 필요 표시가 뜨고, 그 서비스의 도구가 동작을 멈춥니다.

해법: 같은 계정으로 다시 연결하세요.

누군가 Google 계정 설정에서 Endue 를 제거했거나, Slack 앱을 삭제했거나, API 토큰을 지운 경우입니다. Endue 는 시도해 보기 전까지 이것을 만료와 구분하지 못합니다.

해법: 다시 승인하거나, 새 토큰을 만들어 다시 연결하세요. 의도한 취소였다면 Endue 에서도 연결을 제거해 상태를 정직하게 맞추세요.

전형적인 경우입니다. 업무용 커넥터를 승인할 때 개인 Google 계정으로 로그인돼 있던 것이죠. 오류는 나지 않습니다. 엉뚱한 받은편지함을 보고 있으니 에이전트가 아무것도 찾지 못할 뿐입니다.

해법: 제공자에서 잘못된 계정을 로그아웃하거나 시크릿 창을 쓰고, 의도한 계정으로 다시 연결하세요. 승인 전에 동의 화면에 표시된 계정을 확인하는 습관을 들이면 좋습니다.

연결은 멀쩡하고, 리소스가 공유돼 있지 않은 것입니다.

서비스	증상	해법
Slack	기록을 읽을 때 “채널에 없음”	Slack 에서 그 채널에 앱을 초대
Notion	눈에 보이는 페이지인데 검색 결과가 없음	Notion 에서 그 페이지를 통합에 공유
GitLab	프로젝트나 이슈를 찾을 수 없다고 함	토큰 소유자에게 권한이 없을 수 있음 — 철자가 아니라 권한을 확인
Google	파일을 찾을 수 없음	연결한 계정에 그 파일의 접근 권한이 없을 수 있음

주소를 묻는 커넥터 — GitLab · Jenkins · Discourse · WordPress · Mattermost · Grafana · Elasticsearch — 는 그 주소가 인터넷에서 닿을 수 있어야 합니다.

해법: 주소가 맞고 공개적으로 닿을 수 있는지 확인한 뒤 다시 연결하세요. VPN 뒤의 서비스에는 닿을 수 없습니다.

그 작업이 존재하지 않습니다. 커넥터마다 제공하는 작업이 정해져 있습니다. 연결 가능한 서비스를 확인하세요. Endue 가 노출하지 않는 제공자 API 는 에이전트가 쓸 수 없습니다.
연결이 이 에이전트에 바인딩되지 않았습니다. 연결은 계정 단위이고, 사용은 에이전트 단위입니다.
도구 그룹이 꺼져 있습니다. 빠진 능력이 커넥터가 아니라 메모리·아티팩트·루틴·웹 가져오기라면 에이전트의 내장 툴를 확인하세요.
승인 관문에서 거절됐습니다. 지켜보는 사람이 없는 실행이라 자동으로 거절된 경우도 포함합니다.

Endue 에서 제거하면 그 연결에 바인딩된 모든 에이전트가 즉시 그 도구를 잃습니다. 기존 대화의 기록은 남고, 에이전트가 더 이상 그 호출을 하지 못하게 됩니다.

Endue 에서 연결을 제거해도 제공자 쪽의 Endue 접근이 취소되지는 않습니다. 완전히 끊으려면 양쪽 다 하세요.