hangoutsbot

การแนะนำ

Hangupsbot เป็นแชทบอทที่ออกแบบมาเพื่อทำงานร่วมกับ Google Hangouts

โปรดดู:

• คำแนะนำในการติดตั้ง
• ตัวติดตามปัญหาสำหรับข้อบกพร่อง ปัญหา และการร้องขอคุณสมบัติ
• วิกิสำหรับทุกสิ่งทุกอย่าง

ลิงค์พื้นที่เก็บข้อมูล

• องค์กร GitHub
• โครงการแปล
• อ้างอิงไลบรารี Hangups

คุณสมบัติ

• การกล่าวถึง : หากมีใครพูดถึงคุณในห้องแชท จะได้รับแฮงเอาท์ส่วนตัวจากบอทพร้อมรายละเอียดเกี่ยวกับการพูดถึง รวมถึงบริบท ห้องแชท และบุคคลที่พูดถึงคุณ
• Syncouts : การซิงค์คือการแชทกลุ่มในแฮงเอาท์ 2 รายการที่มีการส่งต่อข้อความถึงกัน ทำให้ทั้งสองห้องมีปฏิสัมพันธ์กันได้อย่างราบรื่น โดยพื้นฐานแล้วใช้เพื่อเอาชนะขีดจำกัดการแชทของสมาชิก 150 คน แต่ยังสามารถใช้เพื่อเชื่อมต่อทีมเข้าด้วยกันชั่วคราวเพื่อโต้ตอบกัน
• Cross-chat Syncouts : ครึ่งหนึ่งของทีมของคุณอยู่ใน Slack หรือไม่? ไม่มีปัญหา! คุณสามารถเชื่อมต่อเข้ากับห้องเดียวกันเพื่อสื่อสารได้ การสนับสนุนสำหรับไคลเอนต์แชทอื่น ๆ ในเร็ว ๆ นี้
• การรวม Hubot : Hangupsbot ช่วยให้คุณสามารถเชื่อมต่อกับ Hubot ทำให้คุณสามารถเข้าถึงเครื่องมือแชทและปลั๊กอินที่พัฒนาขึ้นหลายร้อยรายการได้ทันที
• ปลั๊กอินและซิงก์ : บอทมีคำแนะนำในการพัฒนาปลั๊กอินและซิงก์ของคุณเอง ทำให้บอทสามารถโต้ตอบกับบริการภายนอก เช่น เว็บไซต์บริษัทของคุณ สคริปต์ของ Google และอื่นๆ อีกมากมาย
• ความคลั่งไคล้ปลั๊กอิน : เกม, การสนับสนุนชื่อเล่น, คำหลักที่สมัครรับข้อมูล, API ที่ปรับแต่งได้ - รายการดำเนินต่อไป !

เรียกใช้บอท

หมายเหตุ: วิ่งครั้งแรก? ดูคำแนะนำในการติดตั้ง

วิธีดำเนินการ: python3 hangupsbot.py

 usage: hangupsbot [-h] [-d] [--log LOG] [--cookies COOKIES] [--memory MEMORY] [--config CONFIG] [--version]

optional arguments:
-h, --help         show this help message and exit
-d, --debug        log detailed debugging messages (default: False)
--log LOG          log file path (default:
                   ~/.local/share/hangupsbot/hangupsbot.log)
--cookies COOKIES  cookie storage path (default:
                   ~/.local/share/hangupsbot/cookies.json)
--memory MEMORY    memory storage path (default:
                   ~/.local/share/hangupsbot/memory.json)
--config CONFIG    config storage path (default:
                   ~/.local/share/hangupsbot/config.json)
--version          show program's version number and exit

การกำหนดค่าบอทสำหรับผู้ดูแลระบบ

คุณสามารถระบุคำสั่งการกำหนดค่าได้ใน config.json

โปรดทราบว่าไฟล์ config.json ที่มาพร้อมกับพื้นที่เก็บข้อมูลไม่ควรแก้ไข/เปลี่ยนแปลง เป็นไฟล์อ้างอิงที่บอทใช้เพื่อสร้างไฟล์การกำหนดค่าจริงซึ่งอยู่ที่อื่นในระบบ หากต้องการทราบว่าไฟล์จริงอยู่ที่ใด โปรดดูส่วน การกำหนดค่าเพิ่มเติม ในคำแนะนำในการติดตั้ง

คำสั่งการกำหนดค่าส่วนใหญ่ระบุไว้ ทั่วโลก

• คำสั่งส่วนกลางจะระบุไว้ใน "root" ของ config.json เสมอ
• หากต้องการระบุคำสั่งต่อการสนทนา ควรกำหนดตัวเลือกการกำหนดค่าเดียวกันเป็น config.conversations[<conversation-id>].<configuration option>
• คำสั่งต่อการสนทนาจะแทนที่การตั้งค่าส่วนกลาง หากตั้งค่าทั้งสองรายการไว้
• คำสั่งต่อการสนทนาที่กำหนดค่าด้วยตนเองถูกเลิกใช้แล้ว

ปลั๊กอิน

คีย์ plugins ใน config.json ช่วยให้คุณสามารถระบุรายการปลั๊กอินที่บอทจะโหลดเมื่อเริ่มต้นระบบได้ หากตัวเลือกนี้ปล่อยทิ้งไว้เป็น null ปลั๊กอินที่มีอยู่ทั้งหมดจะถูกโหลด

หากต้องการระบุปลั๊กอินที่จะโหลด ขั้นแรกตรวจสอบให้แน่ใจว่าไฟล์ .py ที่ถูกต้องอยู่ในไดเร็กทอรี hangupsbot/plugin/ ของคุณ จากนั้นแก้ไขคีย์ plugins ใน config.json เพื่อให้สะท้อนถึงปลั๊กอิน/ไฟล์ที่คุณต้องการโหลด เช่น plugins: ["mentions", "default", "chance", "syncrooms"]

ปลั๊กอินบางตัวอาจต้องมีการกำหนดค่าเพิ่มเติม config.json เป็นผู้ให้บริการกำหนดค่าสำหรับบอทและปลั๊กอิน

ปลั๊กอินที่น่าสนใจบางส่วน:

• กล่าวถึงปลั๊กอิน
  • แจ้งเตือนผู้ใช้เมื่อมีการกล่าวถึงชื่อของพวกเขาในการแชท
• สมัครสมาชิกปลั๊กอิน
  • แจ้งเตือนผู้ใช้เมื่อมีการพูดถึงคำสำคัญที่พวกเขาสมัครเป็นสมาชิกในการแชท
• ปลั๊กอิน syncout / syncrooms
  • ส่งต่อข้อความแชทระหว่างการสนทนากลุ่มแฮงเอาท์ต่างๆ (ห้องซิงก์)
  • กำหนดค่าผ่านคำสั่งบอท (syncrooms_config)
  • การแปลอัตโนมัติผ่าน Google Translate สำหรับข้อความที่ส่งต่อ (syncrooms_autotranslate)

วิกิมี รายการปลั๊กอิน ที่ครอบคลุมมากขึ้น ...

การโต้ตอบกับบอท

การโต้ตอบกับบอทโดยทั่วไปมีสองประเภท:

• คำสั่ง /bot ขึ้นต้นด้วย /bot เช่น /bot dosomething
  • คำสั่งบอทบางคำสั่งใช้ได้เฉพาะผู้ดูแลระบบเท่านั้น
• การโต้ตอบแบบกำหนดเอง (การใช้งานและการเข้าถึงแตกต่างกันไปตามปลั๊กอิน)

บอทพื้นฐานรองรับคำสั่งพื้นฐานบางอย่างแม้ว่าจะไม่ได้โหลดปลั๊กอินก็ตาม นี่คือรายการบางส่วน:

/bot help

• บอทแสดงรายการคำสั่งที่รองรับทั้งหมดในข้อความส่วนตัวกับผู้ใช้

/bot ping

• บอทตอบกลับด้วย pong

/bot version

• บอทตอบกลับด้วยหมายเลขเวอร์ชันของเฟรมเวิร์ก

รายการคำสั่งทั้งหมดที่รองรับโดยเฟรมเวิร์กพื้นฐานมีอยู่ที่หน้าวิกิ Core Commands

วิกิยังมี รายการปลั๊กอิน ที่ให้รายละเอียดเกี่ยวกับปลั๊กอินที่มีอยู่พร้อมรายการคำสั่งและการใช้งาน

กำลังอัปเดต

• นำทางไปยังไดเร็กทอรีบอท (เช่น cd ~/hangupsbot )
• เปลี่ยนเป็นสาขาที่เสถียรล่าสุดโดยใช้ git checkout master
• git pull เพื่อดึง hangupsbot เวอร์ชันล่าสุด
• pip3 install -r requirements.txt --upgrade
• รีสตาร์ทบอท

การดีบัก

• รันบอทด้วยพารามิเตอร์ -d เช่น python3 hangupsbot.py -d ซึ่งจะลดระดับบันทึกเป็น INFO เพื่อให้ได้ไฟล์บันทึกที่มีรายละเอียดและให้ข้อมูลมากขึ้น
• tail ไฟล์บันทึก ซึ่งอาจอยู่ที่ /<user>/.local/share/hangupsbot/hangupsbot.log - ตำแหน่งจะแตกต่างกันไปตาม distro!
• เอาต์พุตคอนโซล (STDOUT) ค่อนข้างจำกัดไม่ว่าระดับบันทึกจะเป็นอย่างไร ดังนั้นให้ใช้เอาต์พุตของไฟล์บันทึกแทน

เคล็ดลับในการแก้ไขปัญหา

โปรแกรมไม่ทำงาน:

• อัปเดต hangupsbot และ hangups
• เรียกใช้ hangups เพื่อตรวจสอบว่าไลบรารี Hangups เดิมทำงานอยู่หรือไม่
  • หากมีข้อผิดพลาด ให้ลบคุกกี้ที่ ``~/.local/share/hangupsbot/cookies.json` แล้วลองอีกครั้ง
  • ลงชื่อเข้าใช้บัญชี Google ของคุณจากที่อยู่ของเซิร์ฟเวอร์

บอทไม่ตอบสนองต่อข้อความ:

• ตรวจสอบว่าแชทไม่อยู่ในส่วน "คำเชิญ" ของแฮงเอาท์

กำลังขยาย

โปรดดู https://github.com/hangoutsbot/hangoutsbot/wiki/Authoring-Bot-Extensions

เครดิต/ประวัติ

Hangoutsbot มาจากบอท mogunsamang ซึ่งเป็นทางแยกของ hangupsbot ของ xmikos

เมื่อวันที่ 20-06-2558 ทางแยกนี้ถูกถอดออกและทำเป็นสแตนด์อโลนบน GitHub

ในวันที่ 03-07-2558 ทางแยกได้ถูกสร้างขึ้นเป็นองค์กร Github