시작하기
외부 앱을 에이전트에 연결하기
Connections let a Kapsule Agents expert work inside apps you already use, with your permission, and they are entirely separate from what an expert can do on your Kapsule account.
연결이란 무엇인가
연결은 당신의 전문가 중 한 명과 외부 앱 하나 사이의 서명된 링크입니다. 연결되면 해당 전문가는 대화에서 앱의 도구를 사용할 수 있습니다: 문서 읽기, 메시지 작성, 기록 확인. 연결이 없으면 전문가는 전혀 접근할 수 없습니다.
정확히 해야 할 두 가지가 있습니다:
- 연결은 해당 앱에 대한 접근만 허용하고, Kapsule 계정에 대한 접근은 아닙니다. 두 권한 집합은 절대 섞이지 않습니다.
- 연결된 앱에서 뭔가를 변경하는 모든 작업은 Kapsule 계정의 변경과 동일한 확인 카드를 거칩니다. 읽기는 즉시 진행되며, 쓰기는 먼저 승인을 요청합니다.
연결은 Agents에서 Manage Connections를 통해 접근하거나, /agents/connections로 바로 이동할 수 있습니다. Agents 홈페이지에는 몇 가지 예제 앱을 보여주는 Connections 카드도 있습니다.
어떤 전문가가 어떤 앱을 사용할 수 있는가
명단은 의도적으로 보수적이며, 각 전문가는 자신의 직무에 필요한 앱만 볼 수 있습니다. 일부는 앱 자체가 더 많이 할 수 있어도 읽기 전용 도구로만 제한됩니다:
| 전문가 | 접근 가능한 외부 앱 |
|---|---|
| Mara, Business Advisor | Stripe (읽기 전용) |
| Thea, Creative Writer | Notion |
| Sef, SEO Consultant | GitHub (읽기 전용) |
| Mila, Marketing Planner | Gmail, Slack, Notion, Google Calendar |
| Cora, Customer Comms | Gmail, Slack |
| Ash, Sales and Outreach | Gmail, Slack, Stripe (읽기 전용) |
| Pip, Policy and Docs | 없음 |
앱을 연결해도 전체 팀에게 넘어가지 않습니다. 위의 행에 있는 전문가들에게만 사용 가능해집니다.
앱 연결하기
- Agents를 연 다음 Manage Connections를 엽니다.
- Popular 탭을 찾아보거나, All Apps로 전환하거나, 검색창에 입력하세요. 각 카드는 앱 이름과 그것이 노출하는 도구의 수를 보여줍니다.
- 원하는 앱의 Connect를 클릭하세요. 로그인 창이 준비되는 동안 버튼이 **Opening...**으로 바뀝니다.
- 앱에 로그인하고 요청하는 접근을 승인하세요.
- Connections 페이지로 돌아가서 [app] Connected 확인을 받습니다.
연결되면 카드는 Connected 배지, 로그인한 계정 레이블, 연결이 마지막으로 사용된 시간 또는 Not used yet을 표시합니다.
연결 상태
| 상태 | 의미 | 조치 |
|---|---|---|
| Connected | 작동 중. 전문가들이 사용할 수 있습니다. | 없음 |
| Pending | 로그인이 시작되었지만 완료되지 않았습니다. | Finish Connecting 클릭 |
| Reconnect Needed | 접근이 만료되었거나 앱 쪽에서 철회되었습니다. | Reconnect 클릭 |
Reconnect Needed 상태는 시간이 지나면서 정상입니다: 대부분의 앱은 부여한 접근을 일정에 따라 만료시킵니다. 다시 연결하면 아무것도 잃지 않고 복원됩니다.
안전을 유지하는 방법
Connections 페이지는 안전 모델을 세 줄로 설명하며, 훑어보기보다 이해할 가치가 있습니다:
- 인증된 파트너가 처리합니다. 앱으로의 로그인은 당사의 인증된 통합 파트너가 처리하며, 파트너가 권한을 보유합니다. 당신의 앱 비밀번호는 Kapsule에 절대 닿지 않습니다.
- 작업 전 확인. Agents는 행동하기 전에 묻습니다. 뭔가를 변경하는 모든 것은 당신의 동의가 필요합니다.
- 즉각적인 취소. 연결을 끊으면 여기와 앱 쪽 모두에서 접근이 즉시 차단됩니다.
연결을 누군가를 위해 만든 열쇠처럼 생각하세요. 당신의 전문가가 일하기를 원하는 계정을 연결하되, 당신이 소유한 모든 계정을 연결하지는 마세요. 전문가가 당신이 생각하는 일을 하는 데 앱이 필요한지 확실하지 않으면 연결하지 마세요: 먼저 물어본 다음 연결하세요.
앱 연결 해제하기
- Agents를 연 다음 Manage Connections를 엽니다.
- 연결된 앱의 Disconnect를 클릭하세요.
- 확인이 나타납니다: 당신의 팀은 즉시 [app]에 대한 접근 권한을 잃습니다. 이미 사용한 모든 내용은 당신의 지난 대화에 남아 있습니다.
- Disconnect를 클릭하여 확인하세요.
접근은 즉시 종료됩니다. 이것이 하지 않는 것은 이미 한 대화에서 앱의 내용을 제거하는 것입니다: 전문가가 지난주에 문서를 대화에 인용했다면, 그 텍스트는 여전히 대화 기록에 있습니다. 연결 해제는 향후 접근에 관한 것이지, 소급해서 삭제하는 것이 아닙니다.
당신의 계정에서 Connections를 사용할 수 없을 때
Connections 페이지가 Connections Are Not Available Yet이라고 읽는 하나의 차분한 카드를 표시하면, 외부 앱 연결이 당신의 계정에 대해 아직 활성화되지 않은 것입니다. 카드는 아무것도 연결되지 않았으며 아무것도 접근 권한이 없다는 것을 명시하며, 이는 그 상태에서 정확한 진실입니다. 당신의 전문가들은 여전히 작동합니다. 그들은 단지 Kapsule 밖에 도달할 수 없을 뿐입니다.
Agents의 나머지 부분은 영향을 받지 않습니다. 채팅, Skills 및 계정 읽기는 모두 정상적으로 작동합니다.
실패하면 어떻게 하나요
"권한이 부여되지 않아서 아무것도 연결되지 않았습니다." 앱의 자신의 승인 화면에서 취소했거나 거부했습니다. 아무것도 생성되지 않았습니다. Connect를 다시 클릭하고 접근을 승인하세요.
"연결을 지금 사용할 수 없습니다. 잠시 후 다시 시도하세요." 통합 서비스에 연결할 수 없었습니다. 이는 의도적으로 폐쇄되어 실패합니다: 반쯤 만들어진 목록을 표시하는 대신 페이지는 아무것도 표시하지 않습니다. 1분 기다린 후 새로고침하세요.
"연결을 로드할 수 없습니다." 당신의 설정은 안전합니다. 페이지를 새로고침하세요. 계속되면 지원 티켓을 엽니다.
전문가가 연결된 앱에 도달할 수 없다고 합니다. 위의 표를 확인하세요. 모든 전문가가 모든 앱을 사용할 수 있는 것은 아니며, Cora를 위해 연결된 앱은 자동으로 Mara에게 사용 가능하지 않습니다.
연결이 Pending에 머물러 있습니다. 로그인 창이 완료되기 전에 닫혔습니다. Finish Connecting을 클릭하고 완료하세요.
연결 비용
대화에서 연결된 앱을 사용하는 것은 다른 작업과 마찬가지로 측정됩니다. 전문가가 외부 앱에 수행하는 각 호출은 연결 호출 가중치로 청구되며, 이는 긴 텍스트 작성 비용의 일부입니다. Kapsule 계정에 대한 읽기는 무료로 유지됩니다. 전체 가중치는 Agent 크레딧 작동 방식에 있습니다.