telegram chat summarizer

전보 채팅 요약기 앱

귀중한 정보를 찾기 위해 매일 수많은 텔레그램 메시지를 훑어보는 데 지치셨나요? 구원은 여기에 있다!

이 저장소는 그룹 채팅을 모니터링하고 요약하는 Telegram 애플리케이션 구현을 호스팅합니다. 처음에는 개인적인 용도로 제작되었지만 수동으로 검토하기에는 너무 많은 메시지를 생성하는 하나 이상의 실시간 대규모 Telegram 그룹 채팅에서 정보를 수집해야 하는 사람들을 위한 것입니다.

주어진 구성을 기반으로 다음을 수행합니다.

1. Telegram API를 사용하여 특정 Telegram 그룹 채팅 세트를 모니터링합니다.
2. 정의된 전환 확인 기간 동안 모니터링된 채팅을 요약합니다. 즉, 전환 확인 기간을 12시간으로 설정한 경우 지난 12시간 동안의 요약을 하루에 두 번씩 받게 됩니다. 현재는 문자 메시지만 분석됩니다.
3. Bot API를 사용하여 지정된 Telegram 사용자 집합에게 요약을 보냅니다.
4. 전송된 각 요약에 대해 앱은 사용자가 요약에 대해 명확한 질문을 할 수 있도록 다음 요약까지 요약 컨텍스트를 유지합니다.

설치

1. 이 가이드를 사용하여 Telegram API에 대한 api_id 및 api_hash 값을 얻으세요.
2. 이 가이드를 사용하여 Telegram 봇을 만들고 토큰을 얻으세요.
3. 여기에서 OpenAI API 키를 받으세요. 현재 앱에는 하드 코딩된 OpenAI 백엔드( gpt-4-turbo-preview 모델)가 있지만 LangChain 라이브러리 호출을 통해 사용되므로 원하는 백엔드로 교체하는 것이 매우 쉽습니다.
4. 채팅 요약을 위한 프롬프트를 작성합니다. examples/ 폴더에 있는 것을 참조로 사용하세요.
5. 구성을 정의하고 config.json 파일에 저장합니다.

{
  "telegram_api_id" : <api_id>,
  "telegram_api_hash" : " <api_hash> " ,
  "openai_api_key" : " <key> " ,
  "telegram_bot_auth_token" : " <token> " ,
  "chats_to_summarize" : [
    {
      "id" : " <group chat ID or name> " ,
      "lookback_period_seconds" : 86400 ,
      "summarization_prompt_path" : " prompts/example_summarization_prompt.txt "
    }
  ],
  "telegram_summary_receivers" : [
    " <Telegram username> "
  ]
}

5. 요구 사항.txt 파일에 정의된 Python 요구 사항을 설치하거나 Docker 이미지를 빌드합니다.

python3 -m pip install -r requirements.txt

또는

docker build -t tcsa:latest .

6. 앱을 실행합니다.

python3 app.py config.json

또는

docker run -it tcsa:latest

처음 실행 시 앱은 다음과 같이 사용한 Telegram 계정에 로그인하라는 메시지를 표시합니다.

user@pc: ~ /telegram-chat-summarizer $ python3 app.py config.json
2024-03-27 23:03:11,618 - INFO - Started !
Please enter your phone (or bot token): < phone number >
Please enter the code you received: < OTP >
Please enter your password:

그러면 세션이 디스크에 저장되고 후속 실행에는 인증이 필요하지 않습니다.

용법

앱이 실행되면 각 요약 구독자는 사용자를 등록할 수 있도록 봇에 /verify 메시지를 보내야 합니다.

봇은 /<summarized chat name> 명령을 제공하여 대화 컨텍스트를 전환할 수 있습니다(채팅 이름은 구성에 정의된 이름 중 하나일 수 있음). 이 메커니즘은 요약되는 채팅이 두 개 이상인 경우에 사용됩니다. 해당 명령을 제공하면 LLM 컨텍스트를 다른 채팅으로 전환하고 해당 채팅 요약에 대해 토론할 수 있습니다.

구현 세부 사항 및 제한 사항

구현은 매우 단순하며 확실히 개선의 여지가 있습니다. 즉시 사용하면 좋은 몇 가지 사항(PR을 환영합니다!):

1. 사용자 확인 및 채팅 컨텍스트를 위한 디스크 스토리지 지속성.
2. 덜 불편한 점을 위해 요약 구독 메커니즘을 제거합니다.
3. 구성 파일의 대안으로 봇을 통한 기본 앱 관리(요약 채팅, 요약 구독자 등).
4. 문자 메시지 이외의 메시지 지원: 음성 메시지, 이미지, 비디오.

이 구현 후에 작성된 Habr(RU)에 대한 단계별 가이드가 있습니다.