--- title: "yuanbao" description: "Hermes Agent의 yuanbao 번들 스킬은 Yuanbao 그룹에서 멤버 조회, 정확한 @멘션, 그룹 정보 확인, DM 전송을 처리하기 위한 플랫폼 전용 상호작용 스킬입니다." tags: - Hermes - Hermes Agent - Skills - 번들스킬 - yuanbao - Yuanbao - 메시징 image: "hermes_bg.png" published: "2026-06-24T12:00:00+09:00" updated: "" author: "신민항" source_url: "https://hermes-agent.nousresearch.com/docs/user-guide/skills/bundled/yuanbao/yuanbao-yuanbao" summary: - "yuanbao는 Yuanbao(元宝) 그룹에서 사용자를 찾고, 정확한 닉네임으로 @멘션하며, 그룹 정보와 멤버 목록을 조회하는 번들 스킬입니다." - "핵심 원칙은 '에이전트의 최종 답변 자체가 그룹에 전송되는 메시지'라는 점입니다. 별도 전송 도구를 찾거나 사용 불가라고 설명하지 말고, 필요한 도구 조회 후 자연스러운 답변을 작성해야 합니다." - "Yuanbao 플랫폼을 운영하거나 그룹 내 특정 사용자를 호출·확인·DM 전송해야 하는 에이전트에게 적합하지만, Slack·Discord 같은 다른 메시징 플랫폼의 멘션 방식과 혼동하면 안 됩니다." --- # yuanbao > 스킬명: `yuanbao` > 분류: `yuanbao` > 공식 설명: `Yuanbao (元宝) groups: @mention users, query info/members.` > 작성 기준: Hermes Agent 공식 Bundled Skills Catalog, 2026-06-24 확인 ## 한 줄 요약 `yuanbao`는 Hermes Agent가 **Yuanbao 그룹에서 특정 사용자를 찾고, 정확한 닉네임으로 @멘션하거나, 그룹 정보·멤버 목록·DM 전송을 처리하도록 안내하는 플랫폼 전용 스킬**입니다. ## 공식 설명 번역 공식 문서의 요지는 다음과 같습니다. > Yuanbao(元宝) 그룹에서 사용자를 @멘션하고, 그룹 정보와 멤버 정보를 조회한다. 공식 SKILL.md의 핵심 지시는 더 구체적입니다. - 에이전트의 **텍스트 답변 자체가 그룹 또는 사용자에게 전송되는 메시지**입니다. - Yuanbao 게이트웨이는 답변 안의 `@nickname`을 실제 멘션으로 변환합니다. - 사용자를 멘션해야 할 때는 먼저 `yb_query_group_members`로 정확한 닉네임을 조회해야 합니다. - Yuanbao DM은 일반 `send_message`가 아니라 `yb_send_dm` 도구를 사용해야 합니다. - 그룹 정보는 `yb_query_group_info`, 멤버 조회는 `yb_query_group_members`, DM 전송은 `yb_send_dm`이 담당합니다. 이 스킬은 단순한 “Yuanbao 사용법”이 아니라, **Hermes가 Yuanbao 안에서 말하고 행동하는 방식을 오해하지 않도록 강제하는 운영 지침**에 가깝습니다. ## 이 스킬이 해결하는 문제 메시징 플랫폼 연동에서 에이전트가 자주 저지르는 실수는 “플랫폼별 전송 방식”을 일반화하는 것입니다. Slack, Discord, Telegram, Yuanbao는 모두 채팅 플랫폼이지만, 멘션과 DM 처리 방식은 다릅니다. `yuanbao` 스킬은 특히 다음 문제를 줄여줍니다. - Yuanbao 그룹에서 `@멘션`을 해야 하는데 “제가 직접 멘션할 수 없습니다”라고 잘못 답하는 문제 - 사용자의 표시 이름을 추측해서 잘못된 닉네임으로 멘션하는 문제 - 그룹 코드를 현재 `chat_id`에서 추출해야 하는데 이를 놓치는 문제 - Yuanbao DM 요청에 일반 메시지 전송 도구를 사용하려는 문제 - 그룹 멤버와 Yuanbao AI assistant, bot, 일반 사용자를 구분하지 못하는 문제 ## 핵심 동작 구조 ```mermaid flowchart TD A[사용자 요청 수신] --> B{요청 유형 판단} B -->|특정 사용자 멘션| C[yb_query_group_members: find + mention=true] C --> D[정확한 nickname 확보] D --> E[최종 답변에 @nickname 포함] E --> F[게이트웨이가 실제 멘션으로 변환] B -->|그룹 정보 확인| G[yb_query_group_info] G --> H[그룹명·소유자·멤버 수 보고] B -->|멤버 검색/목록| I[yb_query_group_members] I --> J[find/list_bots/list_all 결과 보고] B -->|DM/私信 전송| K[yb_send_dm] K --> L[전송 결과 보고] ``` 이 흐름에서 중요한 점은 마지막 단계입니다. Yuanbao 그룹에 보내는 일반 답변은 별도 전송 도구를 호출하는 것이 아니라, **Hermes의 최종 답변 텍스트가 그대로 전송 메시지가 된다**는 전제를 갖습니다. ## 적합한 사용 상황 이 스킬은 다음 상황에 적합합니다. - Yuanbao 그룹에서 특정 사용자를 찾아 `@멘션`해야 할 때 - Yuanbao 그룹의 이름, 소유자, 멤버 수 같은 기본 정보를 확인해야 할 때 - 그룹 멤버 중 특정 이름을 가진 사람을 찾아야 할 때 - Yuanbao AI assistant 또는 bot 계정을 구분해서 확인해야 할 때 - Yuanbao 안에서 특정 사용자에게 DM 또는 私信을 보내야 할 때 - 중국어권 그룹 운영 환경에서 Hermes를 보조 운영자로 활용할 때 예를 들어 사용자가 “元宝를 불러줘”, “某某에게 DM 보내줘”, “이 그룹에 봇이 누구누구 있어?”라고 요청하는 상황에 맞습니다. ## 부적합하거나 주의해야 할 상황 다음 상황에서는 이 스킬만으로 충분하지 않거나, 다른 플랫폼 스킬과 구분해야 합니다. - Slack, Discord, Telegram, Matrix 같은 다른 메시징 플랫폼의 멘션 처리 - Yuanbao가 아닌 일반 웹 UI 자동화 - 그룹 바깥의 임의 사용자에게 무단으로 메시지를 보내는 요청 - 멤버 이름이 여러 명에게 부분 일치하여 후보가 여러 개 나오는 경우 - 사용자가 민감한 개인정보나 비공개 파일을 DM으로 보내라고 요청하는 경우 - 현재 대화의 `chat_id`에서 `group_code`를 추출할 수 없는 경우 특히 멘션은 추측하면 안 됩니다. 공식 스킬은 `yb_query_group_members`로 먼저 정확한 닉네임을 얻으라고 지시합니다. 같은 표시 이름을 가진 사람이 있거나, 유사한 닉네임이 여러 개 있을 수 있기 때문입니다. ## 실무 관점의 해석 `yuanbao` 스킬은 기능 수가 많은 스킬은 아닙니다. 하지만 메시징 게이트웨이와 플랫폼 문맥을 정확히 이해해야 하므로, 운영상 중요도는 낮지 않습니다. 핵심은 다음 세 가지입니다. 1. **답변이 곧 전송 메시지다** Yuanbao 그룹 응답에서는 “메시지를 보내는 도구”를 따로 찾는 사고방식을 버려야 합니다. 최종 답변이 곧 전송 본문입니다. 2. **멘션은 닉네임 정확도가 생명이다** `@nickname`이 실제 멘션으로 변환되려면 플랫폼이 인식하는 정확한 닉네임이 필요합니다. 그래서 먼저 멤버 조회가 필요합니다. 3. **DM은 별도 도구를 쓴다** 일반 그룹 응답과 달리 개인 메시지는 `yb_send_dm`이 담당합니다. DM 요청을 그룹 답변으로 대체하면 요구를 충족하지 못합니다. ## 사용 흐름 마인드맵 ```markmap # yuanbao 사용 판단 ## 멘션 요청 - 대상 이름 확인 - `yb_query_group_members` - `action="find"` - `mention=true` - 정확한 nickname 확보 - 최종 답변에 `@nickname` 포함 ## 그룹 정보 요청 - `yb_query_group_info` - 그룹명 - owner - member count ## 멤버 조회 요청 - `yb_query_group_members` - `find` - `list_bots` - `list_all` ## DM 요청 - `yb_send_dm` - `group_code` - 대상 `name` 또는 `user_id` - message - optional media_files ## 주의 - 닉네임 추측 금지 - 다른 플랫폼 멘션 방식과 혼동 금지 - 민감정보 전송 주의 ``` ## 실제 사용 예시 ### 예시 1. Yuanbao 그룹에서 특정 사용자를 멘션하기 사용자가 이렇게 요청할 수 있습니다. ```text 元宝 좀 불러줘. ``` 이때 Hermes는 곧바로 `@元宝`라고 추측해서 답하지 않고, 먼저 그룹 멤버에서 정확한 닉네임을 찾습니다. ```json { "group_code": "328306697", "action": "find", "name": "元宝", "mention": true } ``` 도구 결과에서 정확한 닉네임이 `元宝`로 확인되면 최종 답변은 짧고 자연스럽게 작성합니다. ```text @元宝 민항님이 찾고 계십니다. ``` 이 답변은 단순 텍스트처럼 보이지만, Yuanbao 게이트웨이가 `@元宝` 부분을 실제 멘션으로 변환합니다. ### 예시 2. Yuanbao 그룹의 봇 목록 확인 ```text 이 Yuanbao 그룹에 봇이나 AI assistant가 누가 있는지 확인해줘. ``` 예상 처리 흐름: 1. 현재 대화의 `chat_id`에서 `group_code`를 추출합니다. 2. `yb_query_group_members`를 `action="list_bots"`로 호출합니다. 3. 결과를 일반 사용자, Yuanbao AI assistant, bot 기준으로 정리해서 답합니다. 답변 예시는 다음과 같은 형태가 적절합니다. ```text 현재 그룹에서 확인된 bot/AI assistant는 다음과 같습니다. - 元宝: yuanbao_ai - 배포도우미: bot ``` 단, 실제 이름과 역할은 반드시 도구 결과에 근거해야 합니다. ### 예시 3. 특정 사용자에게 DM 보내기 ```text 사용자 aea3에게 "회의 자료 확인 부탁드립니다"라고 DM 보내줘. ``` 이 경우 그룹에 `@사용자 aea3`를 남기는 것이 아니라 `yb_send_dm`을 사용합니다. ```json { "group_code": "535168412", "name": "사용자 aea3", "message": "회의 자료 확인 부탁드립니다." } ``` 전송이 끝나면 결과를 간단히 보고합니다. ```text 사용자 aea3에게 DM을 보냈습니다. ``` ## 추천 대상 이 스킬은 특히 다음 사용자에게 추천합니다. - Yuanbao 그룹을 Hermes Agent와 연결해 운영하려는 사용자 - 중국어권 협업 플랫폼에서 AI 에이전트를 보조 운영자로 쓰려는 사용자 - 그룹 멤버 호출, 봇 확인, DM 전송을 자주 자동화해야 하는 운영자 - 메시징 플랫폼별 멘션 방식 차이를 에이전트에게 명확히 가르치고 싶은 사람 - Yuanbao 그룹에서 “사람을 찾아 불러오는” 요청을 안전하게 처리하고 싶은 사람 반대로 Yuanbao를 쓰지 않는 환경이라면 이 스킬의 직접적인 가치는 낮습니다. Slack, Discord, Telegram 연동은 각 플랫폼의 게이트웨이 규칙과 도구를 따라야 합니다. ## 함께 쓰기 좋은 스킬 | 관련 스킬 | 함께 쓰는 이유 | |---|---| | `external-platform-automation` | 외부 플랫폼을 공식 도구와 게이트웨이 규칙에 맞춰 자동화하는 관점이 유사합니다. | | `productivity-platform-workflows` | Yuanbao에서 받은 요청을 문서, 회의, 업무 플랫폼 처리로 이어갈 때 유용합니다. | | `hermes-agent` | Hermes의 게이트웨이, 플랫폼 연동, 도구 호출 구조를 이해하는 데 필요합니다. | | `webhook-subscriptions` | Yuanbao 외부 이벤트를 Hermes 실행으로 연결하는 구조를 설계할 때 함께 검토할 수 있습니다. | ## 운영 체크리스트 Yuanbao 그룹에서 이 스킬을 사용할 때는 다음을 확인합니다. - [ ] 현재 대화가 Yuanbao 그룹 문맥인지 확인했다. - [ ] `group_code`를 현재 `chat_id`에서 정확히 추출했다. - [ ] 멘션 대상은 `yb_query_group_members`로 먼저 조회했다. - [ ] 최종 답변에 들어가는 `@nickname`은 도구 결과에 근거한다. - [ ] DM 요청에는 `yb_send_dm`을 사용했다. - [ ] 후보가 여러 명이면 임의로 고르지 않고 사용자에게 확인한다. - [ ] 민감한 정보나 파일을 DM으로 보낼 때는 요청의 정당성과 범위를 확인한다. - [ ] Slack/Discord/Telegram 방식과 Yuanbao 방식을 혼동하지 않는다. ## 이 스킬의 한계 `yuanbao`는 Yuanbao 플랫폼 안에서의 그룹 상호작용을 돕는 스킬입니다. 따라서 다음을 대신해주지는 않습니다. - Yuanbao 계정 권한 자체의 생성 또는 승인 - 플랫폼 정책을 우회한 메시지 전송 - 모든 그룹 멤버의 개인정보 수집 - Yuanbao 외부 시스템의 업무 처리 - 다른 메시징 플랫폼의 멘션 규칙 처리 또한 에이전트가 멤버 목록을 조회할 수 있더라도, 그 결과를 과도하게 노출하는 것은 별개의 운영 판단 문제입니다. “가능하다”와 “공유해도 된다”는 다릅니다. ## 문서 작성 체크리스트 - [x] 공식 문서와 SKILL.md 원문 요지를 확인했다. - [x] 공식 설명과 실무 해설을 분리했다. - [x] 사용 예시를 최소 2개 이상 넣었다. - [x] 추천 대상과 주의 상황을 모두 적었다. - [x] 관련 스킬을 연결했다. - [x] `published` 값에 시분초가 포함되어 있다. - [x] 백그라운드 이미지가 `hermes_bg.png`로 지정되어 있다. - [x] mdweb2에서 해석 가능한 Mermaid와 Markmap 문법을 필요한 범위에서 사용했다.