Discord

Discord 애플리케이션 만들기#

Discord 공식 앱 빠른 시작과 인터랙션 개요를 따르세요. Discord Developer Portal에서 애플리케이션을 만들고 다음 값을 수집합니다.

봇 토큰을 재설정하면 이전 값은 즉시 무효화됩니다. 공개 키는 비밀이 아니지만 봇 토큰과 같은 애플리케이션에 속해야 합니다.

연결하고 /ask 등록하기#

사이트의 커넥터 페이지에서 Discord를 선택하고 세 값을 입력한 뒤 연결을 누릅니다.

Make Agent Fast는 Discord 애플리케이션 엔드포인트에서 봇 토큰을 검증하고 애플리케이션과 일치하지 않는 공개 키를 거부합니다. 잘못 입력한 애플리케이션 ID는 인증된 앱의 실제 ID로 정규화한 뒤 다른 앱 명령을 삭제하지 않고 글로벌 /ask question 명령을 생성하거나 업데이트합니다.

저장 후 표시되는 Interactions Endpoint URL을 Discord의 General Information → Interactions Endpoint URL에 복사하고 저장합니다. Discord가 서명된 PING을 보내면 Make Agent Fast가 서명을 검증하고 필수 PONG을 반환합니다.

설치 및 테스트#

Discord 설치 설정에서 애플리케이션 명령에 필요한 권한으로 테스트 서버에 앱을 승인합니다. 글로벌 명령 전파에는 시간이 걸릴 수 있습니다.

/ask를 실행하고 필수 question 옵션을 입력해 제출합니다. Make Agent Fast는 짧은 Discord 제한 시간 전에 인터랙션을 확인하고 에이전트를 실행한 뒤 지연된 원본 응답을 수정합니다. 대화 기록은 Discord 사용자별로 분리되어 이후 /ask 요청에 문맥을 유지할 수 있습니다.

현재 커넥터는 텍스트 전용입니다. 음성 채널, 첨부 파일, 일반 채널 메시지, 다이렉트 메시지는 읽지 않으며 등록된 /ask 인터랙션만 에이전트에 전달됩니다.

교체 또는 연결 해제#

봇 토큰이 노출되면 Discord에서 재설정하고 커넥터를 업데이트한 뒤 /ask를 다시 확인합니다. 애플리케이션 자체가 바뀌면 세 값과 해당 앱의 Interactions Endpoint URL을 모두 업데이트하세요.

커넥터를 끄거나 삭제해도 Discord 애플리케이션이나 글로벌 명령은 삭제되지 않습니다. 영구 종료할 때 서버에서 앱을 제거하고 오래된 제공자 자격 증명도 별도로 삭제합니다.

문제 해결#

봇 토큰을 클라이언트 코드, 저장소, 로그, 스크린샷에 노출하지 마세요.