워크스페이스 ID, API 키, 도구 토큰 및 콘솔
Connections 화면의 각 자격 증명이 무엇을 위한 것인지 — 워크스페이스 ID, API 키, 레코드 도구 뒤에 있는 도구 토큰, 콘솔 접근 — 그리고 실제로 어떤 것이 필요한지.
Connections 화면(agent4.io/dashboard/tenant)에는 워크스페이스에 관한 기술적 핸들이 모여 있습니다. 대부분의 사용자는 이를 전혀 사용할 필요가 없습니다 — 이들은 agent4.io를 여러분 자신의 소프트웨어와 연결하기 위해 존재합니다. 각각이 무엇인지 살펴보겠습니다.
워크스페이스 ID
여러분의 워크스페이스("테넌트")를 나타내는 고정된 식별자입니다. 비밀 정보가 아니며, 단지 요청이 어느 워크스페이스의 에이전트, 데이터, 사용량에 속하는지를 플랫폼에 알려줄 뿐입니다. 직접 입력할 일은 거의 없습니다.
API 키
플랫폼 API를 위한 여러분 워크스페이스의 비밀 키입니다. 자체 코드나 서드파티 도구가 agent4.io를 직접 호출할 때 사용합니다 — 예를 들어 여러분의 에이전트와 통신하는 커스텀 앱 같은 경우입니다. 비밀번호처럼 취급하세요. 서버 측에만 보관하고, 브라우저나 공개 저장소에 붙여넣지 마세요. 자세한 내용은 인증을 참고하세요.
도구 토큰
에이전트가 레코드를 기록할 때 인증에 사용하는 자격 증명입니다 — 인박스에 도착하는 리드, 예약, 체크리스트, 에스컬레이션이 여기에 해당합니다. 설정 마법사가 만든 에이전트는 이미 연결되어 있으므로, 보통은 이 토큰을 건드릴 필요가 없습니다. 여러분 자신의 무언가에 레코드 도구를 연결하려는 경우에만 필요합니다.
콘솔 접근
콘솔은 여러분의 워크스페이스를 위한 전체 관리자 패널로, 모든 에이전트, 지식 베이스, 스킬을 한 곳에서 관리할 수 있습니다. 다시 로그인하지 않고도 대시보드에서 바로 접근할 수 있습니다 — agent4.io가 콘솔의 아이덴티티 제공자 역할을 하므로, 두 번째 로그인이 아니라 클릭 한 번으로 이동합니다. 여기서 콘솔 비밀번호를 설정해 대시보드를 사용할 수 없을 때를 대비한 대체 접근 수단으로 삼을 수도 있습니다. 언제든지 agent4.io/console/enter에서 열 수 있습니다.
실제로 무엇이 필요한가요?
- 대시보드에서 에이전트만 만들고 있나요? 이 중 어느 것도 필요 없습니다 — 마법사가 모든 것을 대신 연결해 줍니다.
- 사이트에 위젯을 넣고 있나요? 웹 위젯 임베드를 참고하세요. API 키가 아니라 공유 스니펫을 붙여넣게 됩니다.
- 자체 백엔드에서 agent4.io를 호출하나요? 이럴 때 필요한 것이 바로 API 키입니다.