서브 에이전트 및 LLM 작업

Triggerfish 에이전트는 서브 에이전트에게 작업을 위임하고 격리된 LLM 프롬프트를 실행할 수 있습니다. 이는 병렬 작업, 집중된 추론, 멀티 에이전트 작업 분해를 가능하게 합니다.

도구

subagent

자율적인 다단계 작업을 위한 서브 에이전트를 생성합니다. 서브 에이전트는 자체 대화 컨텍스트를 가지며 독립적으로 도구를 사용할 수 있습니다. 완료 시 최종 결과를 반환합니다.

매개변수	유형	필수	설명
task	string	예	서브 에이전트가 달성해야 할 것
tools	string	아니오	쉼표로 구분된 도구 화이트리스트 (기본값: 읽기 전용 도구)

기본 도구: 서브 에이전트는 읽기 전용 도구(read_file, list_directory, search_files, run_command)로 시작합니다. 서브 에이전트에 쓰기 접근이 필요하면 추가 도구를 명시적으로 지정하십시오.

사용 예시:

• 메인 에이전트가 다른 작업을 계속하는 동안 주제를 조사
• 여러 각도에서 코드베이스를 병렬로 탐색 (explore 도구가 내부적으로 하는 것)
• 자체 포함된 구현 작업 위임

llm_task

격리된 추론을 위한 원샷 LLM 프롬프트를 실행합니다. 프롬프트는 별도 컨텍스트에서 실행되며 메인 대화 기록을 오염시키지 않습니다.

매개변수	유형	필수	설명
prompt	string	예	보낼 프롬프트
system	string	아니오	선택적 시스템 프롬프트
model	string	아니오	선택적 모델/제공자 이름 재정의

사용 예시:

• 메인 컨텍스트를 채우지 않고 긴 문서 요약
• 구조화된 텍스트에서 데이터 분류 또는 추출
• 접근 방식에 대한 세컨드 오피니언 얻기
• 기본과 다른 모델에 대해 프롬프트 실행

agents_list

구성된 LLM 제공자와 에이전트를 나열합니다. 매개변수를 받지 않습니다.

사용 가능한 제공자, 모델, 구성 상태에 대한 정보를 반환합니다.

서브 에이전트 작동 방식

에이전트가 subagent를 호출하면 Triggerfish는:

1. 자체 대화 컨텍스트를 가진 새 오케스트레이터 인스턴스를 생성합니다
2. 서브 에이전트에 지정된 도구를 제공합니다 (기본값은 읽기 전용)
3. 작업을 초기 사용자 메시지로 보냅니다
4. 서브 에이전트가 자율적으로 실행됩니다 -- 도구를 호출하고, 결과를 처리하고, 반복합니다
5. 서브 에이전트가 최종 응답을 생성하면 부모 에이전트에게 반환됩니다

서브 에이전트는 부모 세션의 taint 수준과 분류 제약을 상속합니다. 부모의 상한을 넘어 에스컬레이션할 수 없습니다.

사용 시기

도구	사용 시기
subagent	도구 사용 및 반복이 필요한 다단계 작업
llm_task	원샷 추론, 요약 또는 분류
explore	코드베이스 이해 (내부적으로 서브 에이전트 사용)

explore 도구는 subagent 위에 구축되어 있습니다 -- 깊이 수준에 따라 2-6개의 병렬 서브 에이전트를 생성합니다. 구조화된 코드베이스 탐색이 필요하면 수동으로 서브 에이전트를 생성하는 대신 explore를 직접 사용하십시오. :::

서브 에이전트 vs 에이전트 팀

서브 에이전트는 발사 후 잊기입니다: 부모가 단일 결과를 기다립니다. 에이전트 팀은 고유 역할, 리드 조정자, 구성원 간 통신을 가진 영구 협업 에이전트 그룹입니다. 집중된 단일 단계 위임에는 서브 에이전트를 사용하십시오. 작업이 여러 전문화된 관점이 서로의 작업을 반복하는 것이 유익할 때 팀을 사용하십시오.