Multica Docs

에이전트

에이전트는 워크스페이스에서 반복해서 사용하는 정체성, 기능, 실행 설정의 묶음입니다.

에이전트는 Multica 워크스페이스의 협업자입니다. 태스크를 할당하거나 댓글에서 @멘션하거나 직접 대화할 수 있습니다. 에이전트는 연결된 런타임을 통해 AI 코딩 도구를 호출하고 진행 상황과 결과를 워크스페이스에 기록합니다.

에이전트 자체는 계속 실행되는 프로세스가 아닙니다. 반복해서 사용할 수 있는 정체성과 설정의 묶음이며, 작업을 받을 때만 구체적인 작업가 생성됩니다.

에이전트 설정

설정역할
이름, 아바타, 설명팀에 에이전트가 누구이며 어떤 작업에 적합한지 알려 줍니다. 설명은 표시용이며 실행 프롬프트에 포함되지 않습니다.
지시문역할, 작업 방식, 경계, 결과물 요구 사항을 규정합니다. 모든 실행에서 사용됩니다.
대화 시작 예시에이전트별 예시를 최대 3개 제공하며, 새 채팅을 열 때 표시됩니다. 선택하면 전송하지 않고 입력창에 채웁니다.
스킬재사용 가능한 방법, 참고 자료, 지원 파일을 제공합니다.
런타임, 모델, 사고 강도어느 런타임에서 어떤 AI 코딩 도구와 모델을 사용할지 결정합니다. Codex 같은 일부 도구에서는 속도 단계도 선택할 수 있습니다.
Access어떤 멤버가 에이전트를 실행할 수 있는지 결정합니다.
실행 설정동시 실행 상한, 환경 변수, CLI 인수, MCP, 외부 연동을 포함합니다.

모델을 바꾸거나 지시문을 수정해도 새 에이전트가 만들어지지 않으며 이전 태스크, 댓글, 실행 기록도 사라지지 않습니다.

에이전트, 런타임, 작업

개념역할
에이전트누가 어떤 방식으로 작업할지 결정
런타임어느 컴퓨터에서 어떤 AI 코딩 도구로 실행할지 결정
작업(task)이번 실행의 과정과 결과를 기록

하나의 런타임이 여러 에이전트를 지원할 수 있고, 하나의 에이전트도 여러 작업을 차례로 완료할 수 있습니다. 런타임이 오프라인이어도 에이전트의 정체성과 기록은 남아 있지만 새 작업은 런타임이 복구될 때까지 기다려야 합니다.

작업에 참여하는 방법

  • 태스크 담당: 에이전트를 담당자로 지정하면 작업이 큐에 들어간 뒤 처리를 시작합니다.
  • 댓글 하나 처리: 댓글에서 에이전트를 @멘션하며 태스크 담당자는 바뀌지 않습니다.
  • 논의 이어가기: 에이전트의 댓글에 답하면 새 정보가 이후 실행에 들어갑니다.
  • 직접 대화: 태스크에 연결되지 않은 대화를 시작합니다.
  • 프로젝트와 스쿼드 참여: 에이전트는 프로젝트 lead가 되거나 스쿼드 리더 또는 멤버가 될 수 있습니다.
  • 오토파일럿을 통한 실행: 일정이나 외부 이벤트로 미리 설정한 작업을 트리거하거나 수동으로 실행합니다.

에이전트는 태스크를 만들고, 댓글을 작성하고, 작업 상태를 변경할 수 있지만 인박스가 없으며 @all 알림도 받지 않습니다. 에이전트 @멘션은 알림이 아니라 실행 트리거입니다.

권한과 Access

각 에이전트에는 owner 한 명과 Access 설정 하나가 있습니다.

Access실행할 수 있는 사람
나만(Only me)에이전트 owner만 실행할 수 있습니다.
전체 워크스페이스(Entire workspace)워크스페이스의 모든 멤버가 실행할 수 있습니다.
지정한 멤버(Specific people)에이전트 owner와 지정된 멤버가 실행할 수 있습니다.

새 에이전트의 기본값은 나만입니다.

워크스페이스 owneradmin은 모든 에이전트를 보고 관리할 수 있지만 다른 사람의 "나만" 에이전트를 Access를 우회해 실행할 수는 없습니다. 일반 멤버에게는 자신이 소유하거나 실행할 권한이 있는 에이전트만 표시됩니다.

보기 권한은 owner 여부, 워크스페이스 관리 역할, Access가 함께 결정합니다. 수정 권한은 에이전트 owner와 워크스페이스 owner/admin에게 있으며, 이 중 Access는 에이전트 owner만 바꿀 수 있습니다.

환경 변수와 MCP처럼 자격 증명이 포함될 수 있는 설정에는 더 엄격한 읽기 규칙이 적용됩니다. 에이전트 생성 및 설정을 참고하세요.

온라인, 오프라인, 작업 상태

에이전트 목록에는 두 종류의 상태가 함께 표시됩니다.

  • 가용성은 런타임에서 오며 온라인, 오프라인, 불안정 등이 있습니다.
  • 작업량은 작업에서 오며 처리 중, 대기 중, 유휴 등이 있습니다.

"오프라인"은 에이전트가 삭제되었다는 뜻이 아닙니다. 이미 큐에 들어간 작업은 런타임이 복구될 때까지 기다립니다. "보관됨" 상태에서만 새 작업을 받을 수 없습니다.

보관 및 복원

더 이상 사용하지 않는 에이전트는 보관할 수 있습니다. 보관 후에는 선택기에 표시되지 않고 할당하거나 @멘션할 수도 없습니다. 이전 기록은 유지되며 나중에 복원할 수 있습니다.

보관하면 큐 대기 중이거나 실행 중인 작업을 포함해 해당 에이전트의 끝나지 않은 모든 작업이 취소됩니다.

에이전트 owner와 워크스페이스 owner, admin은 모두 에이전트를 보관하거나 복원할 수 있습니다.

다음 단계

  • 에이전트 생성 및 설정 — 빈 상태에서 시작하거나 AI를 사용해 만듭니다.
  • 스킬 — 에이전트에 재사용 가능한 방법과 자료를 추가합니다.
  • 스쿼드 — 리더가 작업에 맞는 멤버를 선택하게 합니다.
  • 데몬과 런타임 — 에이전트가 실제로 어디에서 실행되는지 알아봅니다.