연결 문제 해결
어제까지 되던 커넥터가 오늘 안 된다면 대개 다섯 가지 중 하나입니다. 이 페이지는 그 목록을, 자주 일어나는 순서대로 담았습니다.
여기서 시작하세요
에이전트 빌더에서 그 에이전트의 커넥터를 엽니다. 손봐야 할 연결은 거기 표시돼 있고, 해법은 거의 항상 다시 승인하는 것입니다.
다시 승인해도 바인딩은 유지됩니다. 같은 서비스를 같은 계정으로 연결하면 두 번째 연결이 생기는 게 아니라 기존 연결이 다시 승인되므로, 에이전트마다 다시 바인딩할 필요가 없습니다.
다섯 가지 원인
승인이 만료됐다
제공자는 일정 기간이 지나면 접근을 만료시킵니다. 빠른 곳도 있고 몇 달 뒤인 곳도 있습니다. 연결에 재승인 필요 표시가 뜨고, 그 서비스의 도구가 동작을 멈춥니다.
해법: 같은 계정으로 다시 연결하세요.
제공자 쪽에서 접근이 취소됐다
누군가 Google 계정 설정에서 Endue 를 제거했거나, Slack 앱을 삭제했거나, API 토큰을 지운 경우입니다. Endue 는 시도해 보기 전까지 이것을 만료와 구분하지 못합니다.
해법: 다시 승인하거나, 새 토큰을 만들어 다시 연결하세요. 의도한 취소였다면 Endue 에서도 연결을 제거해 상태를 정직하게 맞추세요.
엉뚱한 계정을 연결했다
전형적인 경우입니다. 업무용 커넥터를 승인할 때 개인 Google 계정으로 로그인돼 있던 것이죠. 오류는 나지 않습니다. 엉뚱한 받은편지함을 보고 있으니 에이전트가 아무것도 찾지 못할 뿐입니다.
해법: 제공자에서 잘못된 계정을 로그아웃하거나 시크릿 창을 쓰고, 의도한 계정으로 다시 연결하세요. 승인 전에 동의 화면에 표시된 계정을 확인하는 습관을 들이면 좋습니다.
그 리소스에 대한 접근이 없다
연결은 멀쩡하고, 리소스가 공유돼 있지 않은 것입니다.
| 서비스 | 증상 | 해법 |
|---|---|---|
| Slack | 기록을 읽을 때 “채널에 없음” | Slack 에서 그 채널에 앱을 초대 |
| Notion | 눈에 보이는 페이지인데 검색 결과가 없음 | Notion 에서 그 페이지를 통합에 공유 |
| GitLab | 프로젝트나 이슈를 찾을 수 없다고 함 | 토큰 소유자에게 권한이 없을 수 있음 — 철자가 아니라 권한을 확인 |
| 파일을 찾을 수 없음 | 연결한 계정에 그 파일의 접근 권한이 없을 수 있음 |
자체 설치 서비스가 옮겨졌거나 닿지 않는다
주소를 묻는 커넥터 — GitLab · Jenkins · Discourse · WordPress · Mattermost · Grafana · Elasticsearch — 는 그 주소가 인터넷에서 닿을 수 있어야 합니다.
해법: 주소가 맞고 공개적으로 닿을 수 있는지 확인한 뒤 다시 연결하세요. VPN 뒤의 서비스에는 닿을 수 없습니다.
커넥터는 멀쩡한데 에이전트가 계속 실패한다면
- 그 작업이 존재하지 않습니다. 커넥터마다 제공하는 작업이 정해져 있습니다. 연결 가능한 서비스를 확인하세요. Endue 가 노출하지 않는 제공자 API 는 에이전트가 쓸 수 없습니다.
- 연결이 이 에이전트에 바인딩되지 않았습니다. 연결은 계정 단위이고, 사용은 에이전트 단위입니다.
- 도구 그룹이 꺼져 있습니다. 빠진 능력이 커넥터가 아니라 메모리·아웃풋·예약·웹 가져오기라면 에이전트의 내장 툴를 확인하세요.
- 승인 관문에서 거절됐습니다. 지켜보는 사람이 없는 실행이라 자동으로 거절된 경우도 포함합니다.
연결 제거하기
Endue 에서 제거하면 그 연결에 바인딩된 모든 에이전트가 즉시 그 도구를 잃습니다. 기존 대화의 기록은 남고, 에이전트가 더 이상 그 호출을 하지 못하게 됩니다.
Endue 에서 연결을 제거해도 제공자 쪽의 Endue 접근이 취소되지는 않습니다. 완전히 끊으려면 양쪽 다 하세요.