iri 문서

Slack 통합

Slack에서 /iri-* 명령어로 채널 요약, 워크스페이스 질문, 노트 검색, 빠른 캡처. 각 명령어는 Slack 워크스페이스에 설치한 iri 인스턴스의 워크스페이스에 쓰거나 읽음.

가능한 것

명령어 동작 쿼터 차감?
/iri-summary [hours] 채널 최근 스레드 요약해서 iri 노트로. 기본 24h. 6h, 1d, 30m 가능. 예 (summary 1회)
/iri-ask <질문> 워크스페이스 노트 RAG 답변, 출처 포함 예 (ask 1회)
/iri-find <검색어> top 5 매칭 노트 + 발췌 아니오
/iri-capture <텍스트> 기본 (또는 라우팅된) sphere에 빠른 노트 저장 아니오
/iri-recent 워크스페이스 최근 노트 5개 아니오
/iri-help 명령어 가이드 아니오

summary와 ask는 월간 server-LLM 쿼터에 차감 (Free 10/mo, Pro EA 100/mo). 읽기 명령과 capture는 무료, rate limit만.

셋업

iri 워크스페이스의 admin 또는 manager 권한 필요.

1. iri를 Slack 워크스페이스에 설치

  1. iri에서: Workspace → Integrations → Slack → Install to Slack.
  2. Slack 승인 화면 → Allow 클릭.
  3. iri로 redirect, 통합 연결 완료.

2. 기본 destination 지정

채널별 라우팅이 없을 때 /iri-summary와 /iri-capture가 노트를 어디 쓸지.

  • Target sphere. 노트 들어갈 sphere (예: dev, operations).
  • Folder. 선택. 하위 폴더 이름 (예: standups, decisions).

3. 채널에 봇 초대

iri로 요약하려는 Slack 채널에서:

/invite @iri

봇이 채널 멤버여야 메시지 읽기 가능. 안 하면 /iri-summary가 "iri isn't a member..." 에러.

4. 시도

/iri-summary 6h

봇이 즉시 "Working on the summary…" 응답, 5-10초 후 새 iri 노트 링크 게시.

채널별 라우팅

기본적으로 모든 /iri-summary와 /iri-capture는 기본 sphere/folder로 감. 특정 채널은 다른 곳으로 보낼 수 있음:

  • iri 페이지에서: Integrations → Slack → "Send specific channels to specific spheres" → 채널 + sphere + folder 선택 → Add rule.
  • Slack 인라인: /iri-summary save-to=engineering/standups → 요약 + 이 채널의 라우트로 영구 저장.
  • 일회성 override: /iri-summary 6h to=strategy/decisions → 그 호출만, 저장 안 함.

우선순위: 인라인 to= > 채널 라우트 > 기본.

두 가지 모드 (auto vs agent)

Slack 통합은 두 가지 사용 패턴 지원. 워크스페이스 설정에서 선택, 또는 그때그때 편한 거.

Auto 모드 (기본). iri가 서버에서 자체 LLM 호출로 요약. 쿼터에 차감. 단순: /iri-summary 입력 → 노트.

Agent 모드. 본인 AI 에이전트(Claude Code, Cursor)가 iri MCP로 Slack 메시지 읽고 (list_slack_messages, read_slack_messages), 본인이 노트 작성 (create_note). iri server-LLM 쿼터 차감 안 함; 본인 에이전트 토큰 사용. 더 유연 (커스텀 프롬프트, 커스텀 포맷), 셋업 더 필요.

플랜별 한도

Free Pro EA
월 server-LLM (summary + ask) 10 100
Per-summary 메시지 cap 500 2,000
Daily auto-summary cron 불가 3 채널

Free 월 cap 다 쓰면 → info@iri-ai.com으로 파일럿 한도 상향 문의.

Troubleshooting

봇이 slash command 응답 안 함.

  • iri Slack 앱 설치 확인 (워크스페이스 설정).
  • 봇이 채널에 초대돼있는지 확인: /invite @iri.
  • 완전히 응답 멈추면 재설치 (Integrations → Slack → Disconnect → Install).

/iri-summary가 "iri can't read this channel".

  • 봇이 채널 멤버 아님. /invite @iri.
  • 또는 채널 이름 막 바뀐 경우, 재설치.

Slash command 자동완성에 안 나옴.

  • Slack 앱 설정이 stale. Slack admin이 api.slack.com/apps에서 재설치.

요약에 raw U0XXXX 사용자 ID 나옴.

  • Slack 앱이 users:read scope 없음. manifest에서 재설치.

쿼터 초과 메시지.

  • Free는 월 10. 월별 reset 기다리거나, 헤비 유저는 Agent 모드로 전환 (쿼터 안 함), 또는 문의.

개인정보

  • iri는 요약 중에만 Slack 메시지를 임시 저장, 요약 결과만 워크스페이스에 씀.
  • 메시지별 메타데이터 (채널 ID, 작성자 user ID, 타임스탬프)는 audit 로깅.
  • 봇 OAuth 토큰은 AES-256-GCM으로 암호화 저장.
  • Integrations → Slack → Disconnect 누르면 토큰 revoke + 통합 행 삭제.