Feishu / Lark AI 봇 가이드: 그룹 주제별 협업과 권한·Credits 관리

자신의 Feishu 또는 Lark 앱 봇을 연결합니다. 메시지 이벤트를 수신하고 사용할 기능에 맞는 권한을 설정해야 합니다. 그룹의 사용자 지정 Webhook 봇으로 대체할 수 없습니다. Sparkles는 QR 코드로 새 앱을 만드는 방법과 기존 앱 연결을 모두 지원합니다. 같은 앱을 다른 봇 서비스에 동시에 연결해 메시지를 처리하게 하지 마세요.

관리자는 자신의 Sparkles 계정으로 연결하고 멤버는 관리자가 정한 범위에서 사용합니다. 멤버마다 별도의 Credits 계정을 만들 필요는 없습니다. 개인 일대일 어시스턴트가 필요하다면 Telegram AI 봇 가이드를 참고하세요.

1. Sparkles에 로그인하고 사이드바의 Telegram / Lark 연결에서 Feishu / Lark를 선택하거나 계정 페이지의 Feishu 설정으로 이동합니다.
2. 사용할 플랫폼을 고르고 안내에 따라 QR 코드로 앱을 만듭니다. 관리자 본인이 권한을 확인해야 합니다. 기존 앱의 App ID와 App Secret을 입력할 수도 있습니다. 기존 앱은 개발자 플랫폼에서 봇 기능과 메시지 이벤트의 지속 연결을 설정하고 게시해야 합니다. 인증 정보는 전용 입력란에만 넣으세요.
3. 화면 안내대로 관리자 개인 채팅을 페어링합니다. QR 코드로 만든 앱은 봇에게 먼저 개인 메시지를 보내고, 기존 앱은 화면에 표시된 일회용 연결 명령을 보냅니다. 기본값에서는 관리자만 개인 채팅을 사용할 수 있습니다.
4. 봇을 대상 그룹에 추가하고 그룹에서 한 번 멘션한 뒤 설정 페이지의 그룹 목록을 새로고침합니다. 새 그룹은 기본적으로 꺼져 있습니다. 먼저 설정하고 저장한 뒤 사용하세요.
5. 그룹별 반응 조건과 사용 멤버 범위를 선택합니다. 처음에는 멘션할 때만 반응하도록 하고 소수의 지정 멤버부터 시작해, 사용 방식을 확인한 뒤 넓히는 편이 좋습니다.

스트리밍 카드와 상호작용 버튼에는 해당 플랫폼 권한과 콜백 설정이 필요합니다. 기존 앱을 수정했다면 개발자 플랫폼에서 게시해야 합니다. Sparkles에서 모든 메시지를 선택해도 플랫폼의 전체 그룹 메시지 읽기 권한이 자동으로 부여되지는 않습니다.

예를 들어 멘션할 때만과 지정 멤버를 선택했다면, 지정된 사람도 봇을 멘션해야 합니다. 전체 멤버를 선택해도 꺼진 그룹이 즉시 동작하지는 않습니다. 모든 메시지는 어시스턴트의 참여를 분명히 원하는 작업 그룹에 적합합니다. 켜기 전에 이용 범위와 비용 부담 주체를 멤버에게 알려 주세요.

허용된 멤버가 같은 주제에서 봇과 대화하면 그 주제의 공통 맥락을 사용합니다. 서로 다른 주제, 그룹과 개인 채팅의 맥락은 각각 분리됩니다. 앞서 만든 포스터를 수정하려면 원래 주제에 답장하고, 관련 없는 다른 포스터를 만들려면 새 주제를 시작하세요.

새 주제에서 행사와 대상 독자를 설명하고, 같은 주제에 참고 이미지를 보충한 뒤, 구체적인 수정 요청을 이어가는 순서가 좋습니다. 다음은 입력 예문이므로 실제 자료로 바꾸세요. 멘션할 때만 모드에서는 Feishu / Lark의 @ 메뉴에서 봇을 실제로 선택한 뒤 아래 문장을 보내야 합니다. ‘@봇’이라는 글자만 붙여 넣으면 유효한 멘션이 되지 않습니다.

이 주제는 주말 커피 행사 포스터 작업에 사용합니다.
먼저 대상 독자, 메인 제목, 반드시 들어갈 정보 세 가지를 정리하고 이미지는 생성하지 마세요.
부족한 내용은 한 번에 질문하고, 저희가 확인한 뒤 시각적 방향을 논의해 주세요.

다른 멤버도 원래 주제에서 날짜를 보충하거나 제목을 바꿀 수 있지만 현재 그룹의 반응 조건과 멤버 권한을 충족해야 합니다. 서로 다른 프로젝트의 참고 이미지와 수정 요구를 한 주제에 섞지 마세요. 공유 맥락은 대화를 이어 주지만 팀에서도 작업 범위를 구분해야 합니다.

그룹에서 /new를 보내면 기존 주제 안에서 보냈더라도 별도의 새 주제를 만듭니다. 그룹의 /sessions는 그 그룹의 과거 주제를 보고 여는 데 쓰이며, 현재 주제를 다른 대화 맥락으로 바꾸지 않습니다. 이동이 가능한지는 앱의 메시지 읽기 권한에도 달려 있습니다. 권한이 부족하면 관리자가 설정을 확인해야 합니다.

개인 채팅의 /new는 같은 채팅창 안에서 새 대화를 만들고, /sessions는 그 대화를 시작한 사람 자신의 기록으로 돌아갈 수 있게 합니다. 전환은 이후 수신한 메시지에 적용되며, 이미 제출된 작업은 원래 대화에 남습니다. 미제출 첨부도 자동으로 옮겨지지 않습니다.

관리자는 /setting 또는 /settings로 설정 카드를 열어 답변 모델, 지원하는 추론 강도와 답변 언어를 선택할 수 있습니다. 설정은 이후 새 작업에만 적용됩니다. 그룹 멤버의 /stop은 현재 대화 범위에서 자신이 가장 최근 제출한 작업의 취소를 요청하는 기능이며, 다른 사람의 작업을 관리하는 수단이 아닙니다.

실제 처리 단계에 따라 Markdown 카드에 답변이 표시됩니다. CardKit 권한이 있으면 네이티브 텍스트 스트리밍과 타자기 효과를 볼 수 있고, 없으면 일반 카드 업데이트를 사용합니다. 선택이 필요하면 원래 질문자가 답할 수 있는 선택 카드를 보내 다른 사람의 잘못된 조작을 막습니다.

텍스트, 이미지, 일반 파일과 동영상 첨부를 제출할 수 있으며 한 번에 최대 6개입니다. 첨부를 먼저 보낸 뒤 요청을 쓰는 경우, 미제출 파일은 멤버별로 대기하므로 다른 멤버가 보내 둔 이미지를 자동으로 가져다 쓰지 않습니다. 형식과 크기는 도구와 플랫폼의 업로드 제한을 따라야 합니다.

이미지 결과는 미리보기와 별도의 원본 파일 첨부로 전달됩니다. 원래 화질이 필요하면 해당 파일을 다운로드하세요. 채널 업로드 상한을 넘는 결과를 자동으로 저화질로 바꾸어 보내지는 않습니다. 관리자는 웹에서 기존 결과를 확인할 수 있습니다. 메시지 반응 권한이 있으면 처리 상태를 표시하며, 요청 완료와 결과 전달 성공이 모두 확인된 뒤에만 완료로 표시합니다.

모든 채널 작업은 연결한 관리자의 Credits와 모델 이용 자격을 사용합니다. 그룹 멤버가 사용할 수 있다고 모델 호출이 무료인 것은 아니며, 관리자의 모든 웹 권한을 얻는 것도 아닙니다. 잔액 조회 명령인 /credits는 관리자 개인 채팅에서만 사용할 수 있고 그룹에 공개되지 않습니다.

관리자는 채널의 개인 채팅을 포함한 자신의 채널 대화를 웹에서 볼 수 있습니다. 멤버 자신의 개인 채팅 목록에 다른 사람의 개인 채팅이나 다른 그룹이 나오지 않더라도, 관리자가 볼 수 없다는 뜻은 아닙니다. 업무용 봇을 개인 비밀 채팅으로 오해하지 않도록 그룹 활성화 때 이 점을 알려 주세요.

웹 캔버스와 비공개 파일에 접근하려면 권한이 있는 계정으로 로그인해야 합니다. 그룹에 링크를 보낸다고 관리자의 비공개 프로젝트가 모든 멤버에게 자동으로 공유되지는 않습니다. 결과 정리 방법은 채팅 앱에서 캔버스로 돌아가기를 참고하세요.

그룹 하나, 명확한 주제 하나, 소수의 허용된 멤버로 요구 사항 논의 → 방향 확인 → 생성 → 다운로드와 검토 과정을 진행해 보세요. 카드, 원본 파일, 과거 주제와 관리자 사용량이 예상대로인지 확인한 뒤 더 많은 작업에 적용합니다.

봇이 반응하지 않으면 그룹이 활성화되어 있는지, 보낸 사람이 허용 범위에 있는지, 멘션이 필요한지, 앱 권한이 게시되었는지 차례로 확인하세요. 결과 메시지는 있는데 첨부가 오지 않았다면 바로 유료 생성을 반복하지 말고, 관리자가 웹에서 기존 결과부터 살펴보세요.