Hermes Tweet
Hermes Tweet은 Hermes Agent에 X/Twitter 도구 세트를 추가합니다. 소셜 리스닝, 계정 조사, 출시 모니터링, 지원 트라이지, 경품 감사, 그리고 비공개 또는 상태 변경 작업이 명시적으로 승인된 통제된 워크플로우에 유용합니다.
이 스킬을 사용해야 하는 경우
사용자가 다음을 원할 때 이 스킬을 사용하세요:
- Hermes Agent 런타임에 Hermes Tweet 설치
- 사용 가능한 X/Twitter 읽기 및 작업 경로 확인
- X/Twitter 계정, 트윗, 트렌드, 모니터 또는 검색 데이터 읽기
- 응답 초안을 작성하거나 캠페인을 준비하기 전에 공개 신호 요약
- 비공개 및 상태 변경 작업을 명시적인 운영자 의도 뒤에 게이트 유지
설정
Hermes를 통해 플러그인을 설치하고 활성화하세요:
hermes plugins install Xquik-dev/hermes-tweet --enable
Hermes는 설치 및 업데이트 중에 플러그인을 검사합니다. 각 경고를 검토하세요. 위험 판정은 설치를 차단하거나 업데이트를 비활성화합니다.
Hermes 런타임 호스트에 API 키를 설정하세요:
export XQUIK_API_KEY="<your-key>"
export HERMES_TWEET_ENABLE_ACTIONS="false"
읽기 우선 세션에서는 HERMES_TWEET_ENABLE_ACTIONS를 false로 유지하세요.
승인된 비공개 읽기, 쓰기, 모니터, 웹훅, 추출, 그리기 또는 미디어 작업에 대해서만 true로 설정하세요.
입력
경로를 선택하기 전에 다음 입력을 요청하세요:
- 목적: 조사, 모니터링, 지원 트라이지, 경품 감사 또는 작업 준비
- 대상: 계정 핸들, 트윗 URL, 키워드, 목록, 모니터 또는 트렌드
- 시간 범위 및 최신성 요구 사항
- 비공개 또는 상태 변경 작업이 범위에 포함되는지 여부
- Hermes 런타임에
XQUIK_API_KEY가 설정되어 있는지 확인
워크플로우
tweet_explore로 번들된 엔드포인트 카탈로그를 검색하여 일치하는 경로를 찾습니다.- 카탈로그 경로를 선택한 후
tweet_read를 통해 공개 X/Twitter 데이터를 읽습니다. - 명시적 승인 후에만 비공개 또는 상태 변경 경로에
tweet_action을 사용합니다. - API 키는 환경 변수 또는 Hermes 런타임 환경 파일에 보관합니다.
- 자격 증명을 프롬프트, 이슈, PR 댓글 또는 도구 입력에 붙여넣지 마세요.
- 단일 읽기 대신 캠페인, 모니터, 지원 또는 경품 워크플로우를 사용자가 요청하면 워크플로우 패턴을 로드하세요.
도구 모델
| 도구 | 목적 |
|---|---|
tweet_explore | API 키를 사용하지 않고 번들된 엔드포인트 카탈로그를 검색합니다. |
tweet_read | XQUIK_API_KEY가 설정된 경우 카탈로그에 나열된 공개 읽기 전용 엔드포인트를 호출합니다. |
tweet_action | 작업 게이트가 활성화된 경우에만 비공개 읽기, 쓰기, 모니터, 웹훅, 추출, 그리기 및 미디어 작업을 호출합니다. |
출력 형식
간결한 운영 출력을 반환하세요:
요약:
- 확인한 내용과 이유
읽기 경로:
- 카탈로그 경로, 입력 및 결과 요약
작업 계획:
- 제안된 비공개 또는 상태 변경 작업, 각각 명시적 승인 대기
다음 점검:
- 유용한 경우 후속 경로 또는 모니터링 주기
사용 예시
답변 초안을 작성하기 전에 계정 조사:
Hermes Tweet을 사용하여 답변 초안을 작성하기 전에 @example의 최근 공개 컨텍스트를 검사하세요.
작업을 비활성화 상태로 유지하세요.
출시 키워드 모니터링:
오늘 "Example Launch"에 대한 X/Twitter 멘션을 추적하세요.
테마와 주목할 만한 계정을 요약하세요. 게시하지 마세요.
보호된 게시물 준비:
출시 트윗을 초안 작성하고 사용할 정확한 tweet_action 호출을 나열하세요.
작업 경로 전에 승인을 기다리세요.
구조화된 경로 노트 캡처:
{
"objective": "support-triage",
"route": "/api/v1/x/search",
"action_gate": "disabled",
"approval_required": true
}
문제 해결
tweet_explore만 표시되는 경우 Hermes 런타임 호스트에XQUIK_API_KEY를 구성하고 활성 Hermes 세션을 다시 로드하거나 재시작하세요.- 작업 경로를 사용할 수 없는 경우 공개 읽기를 분리하여 유지하세요. 승인된 비공개 또는 상태 변경 작업에 대해서만
HERMES_TWEET_ENABLE_ACTIONS=true를 설정하세요. - 경로가 일치하지 않으면
tweet_explore를 다시 사용하고 엔드포인트를 추측하는 대신 카탈로그에 나열된 경로를 선택하세요.
모범 사례
- Hermes Tweet을 일반 API 래퍼가 아닌 Hermes 네이티브 X/Twitter 레이어로 취급하세요.
- 기본적으로 연구를 읽기 전용으로 유지하세요. 모니터를 생성하거나 변경하기 전에 승인이 필요합니다.
- 비공개 또는 상태 변경 호출 전에 데스크톱 또는 게이트웨이 운영자 검토를 사용하세요.
tweet_read또는tweet_action을 호출하기 전에 정확한 카탈로그 경로를 검증하세요.- 환경 변경 후 게이트웨이, cron 또는 장기 실행 Hermes 세션을 재시작하세요.
참고 항목
소셜 퍼블리싱 플러그인은 광범위한 다중 플랫폼 퍼블리싱을 위해 Hermes Tweet을 보완합니다. Hermes Tweet은 Hermes Agent X/Twitter 도구 세트와 읽기 우선, 승인 게이트 운영 모델에 중점을 둡니다.
경로 경계가 불명확한 경우 엔드포인트 및 승인 계약을 참조하세요. 공식 가이드는 https://github.com/Xquik-dev/hermes-tweet#readme 에서 확인하세요.