본문으로 건너뛰기

Workflow.tool()

그만큼.tool()메서드는 Tool을 선언적 단계로 추가합니다. Tool 자체의 입력 및 출력 스키마가 적용되므로 이전 단계의 출력은 Tool의 입력 스키마를 충족해야 합니다. 사용.map()일치하지 않는 경우 데이터를 변환합니다.

Tool을 createStep()으로 감싸는 것과 달리 .tool()은 Workflow 그래프에 선언적 항목을 기록합니다. 따라서 Workflow를 이식할 수 있으며, 동일한 그래프를 직렬화하여 동적 Workflow로 저장할 수 있습니다.

사용예
사용예에 대한 직접 링크

workflow.tool(testTool).commit();

매개변수
매개변수에 대한 직접 링크

toolOrId:

Tool | string
Tool 인스턴스 또는 Mastra 인스턴스에 등록된 Tool의 ID입니다. ID를 전달하면 실행 시 레지스트리에서 Tool을 확인합니다.

options?:

{ retries?: number, scorers?: DynamicArgument<MastraScorers>, metadata?: StepMetadata }
Tool 단계의 단계 수준 재시도 횟수, 채점기 및 메타데이터입니다.

stepOptions?:

{ id?: string }
Workflow 내 단계의 호출 지점 ID입니다. 기본값은 Tool의 ID입니다. 동일한 Tool이 하나의 Workflow에 두 번 이상 나타날 때 설정하세요.

보고
보고에 대한 직접 링크

workflow:

Workflow
메서드 체이닝을 위한 Workflow 인스턴스

ID로 Tool 참조
ID로 Tool 참조에 대한 직접 링크

등록된 Tool을 가져오지 않고 참조하려면 문자열을 전달하세요. Workflow가 실행될 때 Tool은 Mastra 인스턴스에 등록되어야 합니다.

workflow.tool("lookup-customer", { retries: 2 }).commit();

지속적인 Tool 단계
지속적인 Tool 단계에 대한 직접 링크

.tool()로 구축된 Workflow는 동적 Workflow에서 사용하는 것과 동일한 선언적 항목으로 직렬화됩니다. 저장소를 왕복해 유지되는 것은 retriesmetadata뿐입니다. 함수 값을 가진 scorers 옵션은 Workflow 저장 시 오류를 발생시킵니다.