Yuanbao — Tencent AI 어시스턴트

회사 대규모 파티에 참석했다고 상상해 보세요. 여러분의 AI 비서가 1:1 채팅은 물론 그룹 토론까지 모든 대화에 자연스럽게 참여하길 원합니다. 바로 이 기능이 정확히 그 역할을 해줍니다. Hermes 에이전트를 Tencent의 Yuanbao 메시징 플랫폼에 직접 연결하여, AI가 실시간으로 메시지를 주고받을 수 있게 해주죠. 마치 든든한 동료처럼요.

시작하기 전에 필요한 것

헬스장 멤버십을 등록한다고 생각해 보세요. 몇 가지 준비물이 필요합니다.

• 봇 생성 권한이 있는 Yuanbao 계정 (잘 모르겠다면 관리자에게 문의하세요)
• 본인만의 APP_ID 및 APP_SECRET (봇의 아이디와 비밀번호라고 생각하면 됩니다)
• 컴퓨터에 설치된 Python 패키지

다음 명령어로 모든 것을 설치하세요.

pip install websockets httpx aiofiles

1단계: 봇 만들기

먼저 https://yuanbao.tencent.com/에서 Yuanbao 앱을 다운로드하세요. 설치 후 다음 단계를 따르세요.

1. PAI → My Bot으로 이동합니다.
2. “새 봇 만들기”를 클릭합니다.
3. 생성이 완료되면 APP_ID와 APP_SECRET을 복사하세요. 마치 현금카드 비밀번호처럼 안전하게 보관하세요!

2단계: 마법사(Wizard)에게 맡기기

Hermes에는 모든 것을 자동으로 설정해 주는 마법 같은 도우미가 있습니다. 다음 명령어를 입력하기만 하면 됩니다.

hermes gateway setup

질문이 나오면 Yuanbao를 선택하세요. 마법사가 다음 작업을 수행합니다.

• APP_ID를 요청합니다.
• APP_SECRET을 요청합니다.
• 모든 것을 자동으로 저장합니다.

전문가 팁: WebSocket URL이나 API 도메인은 걱정할 필요가 없습니다. 똑똑한 기본값이 미리 채워져 있으니까요. 여러분은 그저 두 개의 키만 제공하면 됩니다.

3단계: 설정 확인하기

마법사 작업이 끝난 후, ~/.hermes/.env에 있는 설정 파일을 확인해 보세요. 다음과 같은 내용이 보일 것입니다.

YUANBAO_APP_ID=your_app_id_here
YUANBAO_APP_SECRET=your_secret_here
YUANBAO_WS_URL=wss://default-websocket-url
YUANBAO_API_DOMAIN=https://default-api-domain

모든 것이 올바르게 보인다면, 이제 시작할 준비가 끝났습니다!

특별한 점은 무엇일까요?

Yuanbao는 그냥 아무 채팅 앱이 아닙니다. 진지한 비즈니스용으로 설계되었습니다. WebSocket을 사용하여 (편지를 주고받는 대신 항상 연결된 전화선이라고 생각하면 됩니다) 메시지를 즉시 전달합니다. 게다가 리치 미디어를 지원합니다. 이미지, 파일, 음성 메시지까지요. 따라서 AI가 스크린샷을 보내거나, PDF를 공유하거나, 음성 메모를 전달할 수 있습니다. 진짜 팀원처럼요.

마무리

Hermes를 Yuanbao에 연결하는 것은 AI에게 회사 출입증을 달아주는 것과 같습니다. 이제 AI는 실시간으로 대화에 참여하고, 질문에 답하고, 파일을 공유할 수 있습니다. 전체 설정 과정은 5분도 채 걸리지 않으며, 지루한 부분은 마법사가 처리해 줍니다.

초보자를 위한 실용적인 팁: 간단한 테스트부터 시작하세요. 먼저 1:1 채팅에서 봇에게 메시지를 보내 보세요. 작동이 확인되면 그룹에 추가해 보세요. 이렇게 하면 설정 문제를 초기에 발견하고, 본격적인 “AI 동료” 모드로 전환하기 전에 자신감을 키울 수 있습니다. 즐거운 자동화 되세요!