에이전트는 Craken 워크스페이스 안의 AI 참여자입니다. 사람과 대화하고, 링크로 걸어 준 맥락을 읽고, 워크스페이스 도구를 사용해 위키 수정, 요약, 파일 분석, 후속 메시지 같은 결과물을 남깁니다. 새 워크스페이스에는 Orca가 들어 있고, 관리자는 다른 서버 관리형 에이전트를 추가할 수 있으며, 외부 CLI 에이전트는 CLI로 연결합니다.
할 수 있는 일
에이전트는 워크스페이스 도구를 통해 다음 작업을 수행합니다.
- 최근 채널/DM 맥락을 읽고, 오래된 메시지를 검색하고, 현재 대화에 답합니다.
- 적절한 위키 워크플로를 불러오면 위키 페이지를 찾고 읽고 쓰고 수정하고 이름을 바꾸고 복구하고 검증합니다.
- Workspace files를 검사해 텍스트·Markdown 파일을 읽고, 지원되는 PDF와 문서·데이터 파일에서 텍스트를 추출하고, 근거를 요약하고, 워크스페이스 파일 이름을 바꾸고, 요청받으면 보이는 첨부 파일을 Workspace files로 옮깁니다.
- 채널, 위키, 파일, 메시지에 흩어진 결정을 연결합니다.
- 연구 스킬을 사용할 수 있을 때 논문을 검색하고 근거를 확인합니다.
Orca가 볼 수 있는 범위까지 포함한 설명은 Orca 능력에 있습니다.
에이전트 부르기
개인 작업은 Direct messages에서 Orca에게 보내고, 공유 작업은 그 에이전트가 멤버로 있는 채널에서 @Orca처럼 이름을 멘션합니다.
에이전트는 멘션되었거나 자신에게 온 요청이 분명할 때 움직이고, 사람들끼리의 대화에는 끼어들지 않습니다. 채널에서 답이 없으면 멘션과 채널 멤버십을 확인하세요.
요청을 잘 쓰는 법
목적, 근거 자료, 원하는 출력 형식을 한 번에 적어 주세요. 자료는 말로 설명하는 대신 위키·파일·채널 링크 문법으로 걸어 줍니다.
#research의 지난주 논의를 바탕으로 [[Launch Plan]]의 Risks 섹션을 업데이트해줘.
근거는 [[/briefs/q2-risks.pdf]]를 참고하고 결과는 짧은 표로 정리해줘.
채널, 위키, 파일, 에이전트를 함께 쓰는 예시는 자주 쓰는 흐름에 있습니다.
Jobs와 진행 상황
긴 작업은 Job이 되어 대화에 진행 표시 줄과 계획/체크리스트가 보이고, 에이전트가 진행하면서 계획을 갱신합니다. 방향을 바꾸려면 같은 대화에 새 메시지를 보내고, 명시적으로 멈추려면 진행 표시 줄의 interrupt control을 사용합니다. 시스템 운영자는 Manage Workspace에서 추가 Jobs 진단을 확인할 수 있습니다.
토큰 한도
에이전트 사용량은 워크스페이스 전체가 함께 쓰며 사이드바 하단에 표시됩니다. 짧은 질문은 적게, 길고 여러 단계를 거치는 작업은 많이 씁니다. 한도에 가까워지면 작업을 더 작은 요청으로 나누거나 일일·월간 재설정을 기다리세요.
학습
에이전트는 워크스페이스에서 반복되는 선호와 잘 맞는 워크플로를 시간이 지나며 배울 수 있습니다. 시스템 운영자는 Manage Workspace에서 Dreams 진단을 확인할 수 있습니다.