colleague공개 문서v0.7.0

Docs · v0.7.0

사용법

TecAce 직원이 Teams 에서 tecace-colleague 를 부르고, AXKH 를 연결하고, 모델과 모드를 바꾸는 방법입니다.

문서 검토 버전 0.7

Teams 에서 @tecace-colleague 로 부르면 됩니다. 1:1 채팅에서는 멘션 없이 그냥 입력합니다.

처음 시작하기

  1. Teams 왼쪽 앱 에서 tecace-colleague 를 찾아 추가합니다. (보이지 않으면 Teams 관리자에게 앱 배포를 요청하세요.)
  2. 1:1 채팅을 열고 아무 질문이나 입력합니다. 예: 우리 회사 AI 거버넌스 원칙 요약해줘
  3. 처음이면 AXKH 연결이 필요합니다 카드가 옵니다. AXKH 연결하기 를 눌러
    • TecAce Microsoft 계정으로 로그인하고,
    • AXKH 동의 화면에서 허용합니다.
    • 링크는 10분 동안, 요청한 본인만 쓸 수 있습니다.
  4. 연결이 끝나면 같은 질문을 다시 보냅니다. 이제 본인 AXKH 권한 안에서 문서를 찾아 답하고, 끝에 참고 문서 링크를 붙입니다.

연결은 한 번만 하면 됩니다. AXKH 쪽에서 권한이 만료되거나 취소되면 연결 카드가 다시 옵니다.

어디서 부르느냐에 따라 달라지는 것

어디서 할 수 있는 것 못 하는 것
1:1 채팅 AXKH 사내 지식 검색·문서 읽기, 개인 지식 저장, 스킬 지침 활용 웹 검색, 코드 실행, 파일 만들기
채널·그룹 채팅 웹 검색, 문서·표·코드 작성, 파일 만들기(24시간 링크), 스킬 실행 AXKH 사내 지식 (채널 사람 모두가 답을 보기 때문)
1:1 에서 /public 채널과 같은 공개 모드 AXKH 사내 지식

사내 자료가 필요한 질문은 1:1 에서, 웹 조사나 파일 작업은 채널 이나 /public 으로 요청하세요.

명령

입력 하는 일
/help 사용법 안내와 이 문서 링크
/version 현재 버전과 버전 기록 링크
/public 질문 1:1 에서도 공개 모드(웹 검색·작업 공간)로 처리
/model opus 이 대화방의 기본 모델을 Opus 로 바꿈 (sonnet, opus, haiku)
/model opus 질문 이번 질문만 Opus 로
[opus] 질문 또는 opus로 질문 이번 질문만 해당 모델로

모델 고르기: 평소에는 Sonnet(기본). 길고 복잡한 분석·설계는 Opus. 짧고 빠른 답은 Haiku.

요청 예시

  • 1:1: 고객사 B 제안서에서 일정 관련 내용만 찾아서 표로 정리해줘
  • 1:1: 방금 정리한 내용 내 AXKH 개인 메모로 저장해줘 → 저장 전 확인 질문에 답합니다.
  • 채널: @tecace-colleague 이번 주 Claude API 변경 사항 웹에서 찾아서 요약해줘
  • 채널: @tecace-colleague 이 CSV 요약 통계를 엑셀 파일로 만들어줘
  • 어디서나: [opus] 이 아키텍처의 장단점을 비교해줘

승인 카드

되돌리기 어려운 작업(예: AXKH 팀 공유 저장)은 바로 실행하지 않고 승인이 필요한 작업 카드를 보냅니다.

  • 승인 / 거절 버튼은 요청한 본인만, 같은 1:1 대화에서 누를 수 있습니다.
  • 한 번 처리된 카드는 다시 눌러도 실행되지 않습니다.
  • 현재 팀 공유 게시는 공개 범위 검토 절차가 생길 때까지 막혀 있습니다. 개인 지식 저장은 됩니다.

알아 두면 좋은 것

  • 이전 대화를 기억하지 않습니다. 매번 새로 시작합니다. 앞에서 한 이야기가 필요하면 질문에 함께 적어 주세요.
  • 답이 오래 걸리면 자리표시 메시지가 "AXKH 검색…", "웹 검색…" 처럼 바뀝니다. 최대 몇 분까지 걸릴 수 있습니다.
  • "요청을 중단했습니다" 라는 답은 권한이나 정책을 확인하지 못해 안전하게 멈춘 것입니다. 잠시 뒤 다시 시도하고, 계속되면 관리자에게 알려 주세요.
  • 비밀번호·API 키·토큰은 Teams 에 입력하지 마세요. 봇도 묻지 않습니다.
  • 파일 링크는 24시간 뒤 만료됩니다. 필요한 파일은 내려받아 두세요.

관리자에게

  • 운영 화면: /admin (관리자 ID·비밀번호 필요)
    • 설치 안내: 환경 변수·DB·Teams 설정 점검
    • 스킬: 회사 업무 절차 추가·수정·끄기 (버전 관리)
    • MCP 연결: 공개 모드에서 쓸 읽기 전용 외부 도구 등록
    • Activity / 성능: 실행 기록과 처리 시간 (대화 원문은 저장하지 않음)
  • 새 버전이 배포되면 버전 기록에 무엇이 바뀌었는지 적힙니다.