기능이 서른 개나 되는 봇에는 설정도 아주 많고, 대부분은 다른 설정과 함께 봐야 의미가 있어요. 설정 어시스턴트는 서버의 설정을 읽고 질문에 답해 줍니다. 어떤 설정이 무슨 일을 하는지, 지금 어떤 값이 들어 있는지, 다르게 동작시키려면 무엇을 바꿔야 하는지를 알려 줘요.
변경도 제안할 수 있어요. 변경 전/후 목록으로 보여 주고, 읽어 본 뒤 직접 적용하는 방식입니다. 클릭하지 않으면 아무것도 적용되지 않아요.
✨ 어디에 있나요
서버의 기능 구성 페이지에 있는 채팅 패널이에요. 오른쪽 아래 모서리의 🛠 버튼으로 엽니다.
개인이 아니라 팀에 속해 있어요. 팀원 모두가 같은 대화를 보기 때문에, 팀원이 이어서 대화를 진행할 수 있고, 이미 나온 질문을 다시 묻는 대신 읽어 볼 수 있습니다.
이 어시스턴트는 그래프 어시스턴트를 대체하는 것이 아니라 옆에 놓인 두 번째 어시스턴트예요. 그래프 어시스턴트는 그래프 편집기 안에 남아 하던 일을 계속하고, 이쪽은 서버의 기능에 대해 이야기합니다. 둘은 팀의 모델 설정만 공유하고, 한쪽에 질문한다고 다른 쪽이 막히는 일은 없어요.
📖 실시간 설정을 읽어요
문서도, 기능이 예전에 하던 동작도 아니에요. 지금 이 서버에 적용되어 있는 설정을 읽습니다.
활성화된 모든 기능에 대해 각 설정의 이름, 실제 키, 유형, 그리고 입력된 값을 전달받아요. 채우지 않은 설정은 건너뛰지 않고 설정되지 않음으로 알려 줍니다. "그 입력란이 비어 있어서 아무 일도 일어나지 않는다"가 대개 정답이기 때문이에요.
활성화되지 않은 기능도 알고 있어요. 그런 기능에 대해 물으면 그렇다고 알려 주고, 설정이 존재하려면 먼저 기능 페이지에서 활성화해야 한다고 안내합니다. 없는 설정에 대해 답을 지어내지 않아요.
무언가를 바꾼 뒤에는 설정 다시 읽기를 누르세요. 다음 질문과 함께 새로운 설정 내용이 어시스턴트에 전달되므로, 서버의 현재 상태를 기준으로 답합니다.
✅ 어시스턴트는 제안하고, 적용은 직접 해요
답변에 무언가를 바꾸는 내용이 있으면 변경 내용 보기가 함께 나와요. 누르면 변경 전/후 목록이 열립니다. 기능, 설정 이름과 실제 키, 현재 값, 제안하는 값이 표시돼요. 어시스턴트가 언급한 설정이 이미 올바른 값을 가지고 있으면 이미 이 값입니다. 표시와 함께 보여 주므로, 변경이 아닌 것이 변경처럼 보이는 일은 없습니다.
적용을 누르면 그 즉시 서버 설정에 기록돼요. 기능 자체 페이지에서 저장할 때와 같은 방식으로, 같은 검사를 거치고 감사 로그에도 같은 항목이 남습니다. 취소는 제안을 거절합니다. 적용하지 않고 다시 질문하는 것도 거절로 처리돼요. 이전 제안에는 이후 답변으로 대체됨 표시가 붙고 버튼이 사라지므로, 더 나은 답변 두 개가 이미 대체한 제안을 적용하는 일은 절대 없습니다.
목록은 열 때, 그리고 적용할 때 그 시점의 설정을 기준으로 다시 계산돼요. 그 사이에 팀원이 무언가를 바꿨다면 변경 전 열에서 그 사람의 값을 볼 수 있어요. 한 시간 전의 제안이 그 뒤에 누군가 바꾼 내용을 슬그머니 되돌리는 일은 없습니다.
전부 적용되거나 전부 적용되지 않아요. 제안의 일부라도 맞지 않으면(존재하지 않는 설정이거나 입력란이 받아들이지 않는 값 등) 전체가 거부되고 아무것도 기록되지 않습니다. 어시스턴트는 무엇이 잘못되었는지 정확히 전달받고 다시 시도하며, 이유는 스레드에서 확인할 수 있어요.
아예 제안할 수 없는 것도 있어요.
- 기능 켜기/끄기. 이 작업은 기능 페이지에서 해야 해요. 어시스턴트가 그쪽으로 가라고 안내합니다.
- 모든 인증 정보. 어시스턴트는 이를 볼 수도, 쓸 수도 없습니다(아래 참고).
- 설정 양식이 아니라 자체 페이지가 있는 기능 - 모더레이션, Automod, 레벨링, 리액션 역할, 서버 로그, Discord 신고, Discord 티켓이 해당돼요. 어시스턴트는 대신 그 페이지로 안내해야 한다는 것을 알고 있어요.
누가 적용할 수 있나요
제안을 읽는 것과 적용하는 것은 서로 다른 권한이에요. 어시스턴트를 사용할 수 있는 사람은 누구나 변경 전/후 목록 전체를 볼 수 있지만, 적용하려면 서버를 구성할 권한이 필요합니다. 설정 양식에 필요한 권한과 같아요. 권한이 없으면 목록은 계속 읽을 수 있고, 버튼만 사용할 수 없습니다.
🙈 인증 정보는 절대 보지 않아요
여러 기능이 비밀 값을 가지고 있어요. AI 응답용 API 키, 음성 녹음용 S3 시크릿, 소셜 알림용 토큰 등이 그 예입니다. 이런 값은 어시스턴트에 무언가를 전달하기 전에 ••••••••로 바뀝니다.
값이 숨겨져 있다는 사실과 그 이유는 어시스턴트도 알고 있어서, 비밀 값이 패널 밖으로 나가지 않고도 "이 기능에는 키가 설정되어 있어요" 또는 *"이 기능에는 키가 빠져 있어요"*라고 말할 수 있어요. 유용한 절반의 답은 그대로 얻는 셈이죠. 채우지 않은 설정은 가려지지 않고 비어 있는 그대로 보이므로, "설정됨"과 "설정 안 됨"이 같아 보이는 일은 없습니다.
가려진 값은 복구할 수 없고, 어시스턴트는 그 값을 채팅에 붙여 넣어 달라고 요청하지 않도록 지시를 받았어요.
🏷 원시 ID가 아니라 이름으로
Discord는 채널과 역할을 긴 숫자로 저장하기 때문에, ID로만 읽어 주는 설정은 알아보기 어려워요. 패널이 이름을 아는 곳에서는 ID 옆에 이름이 함께 적힙니다. 예를 들면 123456789 (#announcements), 987654321 (@Moderator)처럼요. 그래서 답변에서 실제로 알아볼 수 있는 채널 이름을 말할 수 있어요.
💬 여러 개의 대화
주제마다 각자의 스레드를 가져요. 주제를 바꿀 때마다 **+**로 새 스레드를 시작하세요. 어시스턴트가 보는 것은 대화의 기록뿐이라서, 관련 없는 이전 논의가 답변을 헷갈리게 만들지 않아요.
스레드의 제목은 첫 질문에서 따오고, 마지막 메시지 순서로 정렬됩니다. 🗑 버튼은 스레드와 그 안의 모든 내용을 삭제하며, 팀원 모두에게서 사라져요. 마지막으로 남은 스레드는 삭제할 수 없습니다. 패널에는 글을 쓸 곳이 항상 필요하니까요. 어시스턴트가 지금 작업 중인 스레드도 삭제할 수 없어요.
⏳ 한 번에 하나의 요청
어시스턴트가 작업하는 동안에는 모든 대화에서 팀 전체의 입력창이 비활성화되고, 누구의 요청이 실행 중인지 모두에게 표시돼요. 팀은 하나의 모델과 하나의 청구서를 공유합니다. 질문 두 개를 동시에 처리하면 비용이 두 배가 들고 답변이 서로 겹치기 때문이에요.
창이 닫혀 있을 때도 🛠 버튼에 같은 상태가 표시되므로, 무엇이든 열기 전에 팀이 바쁜지 알 수 있어요.
그래프 질문과 설정 질문은 서로를 막지 않아요. 일부러 별도의 대기열로 나뉘어 있습니다.
👀 생각하는 과정 보기
각 답변에는 어시스턴트의 추론이 추론 보기 아래에 접혀 있어요. 답변이 의외일 때 열어 보세요. 어떤 설정을 읽고 그 결론에 이르렀는지 알려 주는 경우가 많아서, 설정을 하나하나 확인하는 것보다 빠릅니다.
스레드는 함께 쓰기 때문에, 질문에는 누가 물었는지가 표시돼요.
🧠 봇이 여기서 기억하는 것
서버에서 AI 메모리가 켜져 있으면, 봇은 Discord 대화에서 알게 된 서버에 대한 내용을 메모해 둬요. 어시스턴트는 질문과 함께 이 메모를 받을 수 있습니다.
이 기능은 직접 켜기 전까지 꺼져 있고, 그래프 어시스턴트의 ⚙ 패널에서 설정하는 것과 같은 스위치예요. 창이 아니라 사용자에게 속한 설정입니다. 그 출처를 허용한 사람은 특정 화면이 아니라 출처 자체를 허용한 것이니까요. 켜져 있으면 첫 메시지 위에 채팅이 그렇게 알려 줍니다.
받는 내용에도 같은 제한이 있어요. 열어 둔 서버 하나만 해당하고 다른 서버는 포함되지 않으며, 서버 자체에 대한 메모만 받고 개별 멤버에 대해 기록된 메모는 받지 않습니다. 가장 최근 메모 중 정해진 개수만, 각각 적당한 길이로 잘라서 전달돼요. 이 메모는 지시가 아니라 배경 정보로만 전달됩니다.
👥 누가 사용할 수 있나요
두 가지가 필요해요. 서버를 볼 권한과 팀의 AI 어시스턴트 권한입니다. 두 권한은 모든 요청마다, 그리고 실시간 연결에서도 다시 확인되므로, 팀 밖의 사람에게 공유한 링크로는 아무것도 얻을 수 없어요.
⚙️ 어떤 모델을 사용하나요
그래프 어시스턴트와 같은 모델이에요. 기본값은 플랫폼의 모델이고, 팀 전용 모델도 쓸 수 있습니다. 자체 API 키, 자체 모델, 또는 자체 OpenAI 호환 엔드포인트를 지정할 수 있어요. 팀 설정 페이지의 어시스턴트 모델에서 한 번만 설정하면 두 어시스턴트가 모두 따릅니다.
아무것도 설정되어 있지 않으면, 질문에 실패하는 대신 창에서 그렇다고 알려 줘요.
💡 좋은 답변을 얻으려면
데이터베이스가 아니라 동작에 대해 물어보세요.
- "누가 참가해도 환영 메시지가 나오지 않는 이유가 뭐예요?"
- "레벨 업 알림에는 지금 뭐라고 적혀 있고, 어디에 게시되나요?"
- "활성화한 기능 중 더 이상 존재하지 않는 채널에 쓰는 것이 있나요?"
- "Automod가 메시지를 삭제하는 대신 경고하게 하고 싶어요. 무엇을 바꿔야 하나요?"
그다음 추론을 읽고, 알려 준 페이지를 열거나 제안한 변경 내용을 검토하세요.
답변에서 이미 무언가를 활성화했거나 저장했다고 주장한다면, 어시스턴트가 자기 자신에 대해 잘못 말하는 거예요. 변경은 변경 전/후 목록에서 확인하고 적용을 클릭한 뒤에야 존재하며, 그렇게 하면 감사 로그에 사용자의 이름으로 남습니다.