서브에이전트

숨겨진 대화 상태를 상속하지 않는 제한된 내장·사용자 정의·외부 에이전트를 실행합니다.

Markdown 보기

사용 가능한 에이전트 확인

/subagents를 열어 내장 정의를 확인하고 사용자 정의 프로필을 관리하세요. 목록에는 각 프로필의 실행 종류, 모델 역할, 범위, 도구, 위임 권한이 표시됩니다.

공개 내장 ID는 다음과 같습니다.

builtin/scout
builtin/griller
builtin/planner
builtin/executor
builtin/reviewer
builtin/coder
builtin/web-search
builtin/web-tester

단일 요청 실행

자식은 부모 대화를 자동으로 상속하지 않으므로 요청에 필요한 작업 컨텍스트를 모두 포함하세요.

text

/subagent builtin/scout app/model.go의 취소 경로를 설명해줘

TUI에서는 사용자 정의 프로필의 짧은 이름을 사용합니다. 프로필에 저장하는 위임 권한은 builtin/scout, global/code-reader, workspace/browser-check 같은 정규 ID를 사용합니다.

내부 에이전트 정의

내부 프로필은 q 모델 역할, 명시적인 도구 목록, 직접 호출 가능한 위임 대상을 선택합니다.

yaml

version: 1
name: code-reader
description: 요청된 코드를 설명합니다.
kind: inner
role: scout
system_prompt: |
  요청된 코드를 읽고 구체적인 파일 위치와 함께 동작을 설명하세요.
tools:
  - list_directory
  - read_file
delegates:
  - builtin/scout

프로필은 ~/.q/subagents/ 또는 <workspace>/.q/subagents/에 있습니다. 같은 이름의 워크스페이스 프로필은 전역 프로필 전체를 대체합니다.

외부 에이전트

외부 프로필은 활성 ACP 연결에 바인딩됩니다. 시스템 프롬프트와 원격 에이전트의 워크스페이스 변경 허용 여부를 저장하지만 q 도구, 위임 대상, q 모델 역할은 선택하지 않습니다.

ACP 세션 생성에는 시스템 메시지 필드가 없으므로 q는 저장된 시스템 프롬프트를 첫 일반 ACP 요청 앞에 붙입니다. 연결이 없거나 비활성화되어 있으면 프로필을 삭제하지 않고도 사용할 수 없는 상태가 됩니다.