메인 콘텐츠로 건너뛰기
weave / WeaveAdkPlugin 러너 호출 수, 에이전트 Runs, 모델 Call, 도구 실행을 Weave의 에이전트 파이프라인에서 GenAI-semconv OTel span으로 내보내는 ADK 플러그인입니다. 구조적으로 BasePlugin의 전체 인터페이스를 구현합니다. ADK의 PluginManager는 모든 callback을 호출하므로 callback이 no-op인 경우에도 모두 포함되어 있습니다. ADK는 undefined가 아닌 반환값을 모두 단락 처리로 간주하므로, 모든 callback은 자체 오류를 내부적으로 처리하고 undefined를 반환합니다.

구현 항목

  • BasePlugin

목차

생성자

속성

메서드

생성자

constructor

new WeaveAdkPlugin(): WeaveAdkPlugin

반환값

WeaveAdkPlugin

속성

name

Readonly name: "weave"

구현 대상

AdkBasePlugin.name

정의 위치

src/integrations/googleAdk.ts:590

메서드

afterAgentCallback

afterAgentCallback(params): Promise<undefined>

매개변수

이름유형
paramsObject
params.agentBaseAgent
params.callbackContextContext

반환값

Promise<undefined>

구현 대상

AdkBasePlugin.afterAgentCallback

정의 위치

src/integrations/googleAdk.ts:779

afterContextCompaction

afterContextCompaction(_params): Promise<undefined>

매개변수

이름유형
_paramsunknown

반환값

Promise<undefined>

구현 대상

AdkBasePlugin.afterContextCompaction

정의 위치

src/integrations/googleAdk.ts:997

afterModelCallback

afterModelCallback(params): Promise<undefined>

매개변수

이름유형
paramsObject
params.callbackContextContext
params.llmResponseLlmResponse

반환값

Promise<undefined>

구현 대상

AdkBasePlugin.afterModelCallback

정의 위치

src/integrations/googleAdk.ts:841

afterRunCallback

afterRunCallback(params): Promise<undefined>

매개변수

이름유형
paramsObject
params.invocationContextInvocationContext

반환값

Promise<undefined>

구현 대상

AdkBasePlugin.afterRunCallback

정의 위치

src/integrations/googleAdk.ts:713

afterToolCallback

afterToolCallback(params): Promise<undefined>

매개변수

이름유형
paramsObject
params.resultnullRecord<string, unknown>
params.toolBaseTool
params.toolArgsRecord<string, unknown>
params.toolContextContext

반환값

Promise<undefined>

구현 대상

AdkBasePlugin.afterToolCallback

정의 위치

src/integrations/googleAdk.ts:965

beforeAgentCallback

beforeAgentCallback(params): Promise<undefined>

매개변수

이름유형
paramsObject
params.agentBaseAgent
params.callbackContextContext

반환값

Promise<undefined>

구현 대상

AdkBasePlugin.beforeAgentCallback

정의 위치

src/integrations/googleAdk.ts:765

beforeContextCompaction

beforeContextCompaction(_params): Promise<undefined>

매개변수

이름유형
_paramsunknown

반환값

Promise<undefined>

구현 대상

AdkBasePlugin.beforeContextCompaction

정의 위치

src/integrations/googleAdk.ts:993

beforeModelCallback

beforeModelCallback(params): Promise<undefined>

매개변수

이름유형
paramsObject
params.callbackContextContext
params.llmRequestLlmRequest

반환값

Promise<undefined>

구현 대상

AdkBasePlugin.beforeModelCallback

정의 위치

src/integrations/googleAdk.ts:804

beforeRunCallback

beforeRunCallback(params): Promise<undefined>

매개변수

이름유형
paramsObject
params.invocationContextInvocationContext

반환값

Promise<undefined>

구현 대상

AdkBasePlugin.beforeRunCallback

정의 위치

src/integrations/googleAdk.ts:621

beforeToolCallback

beforeToolCallback(params): Promise<undefined>

매개변수

이름유형
paramsObject
params.toolBaseTool
params.toolArgsRecord<string, unknown>
params.toolContextContext

반환값

Promise<undefined>

구현 대상

AdkBasePlugin.beforeToolCallback

정의 위치

src/integrations/googleAdk.ts:918

beforeToolSelection

beforeToolSelection(_params): Promise<undefined>

매개변수

이름유형
_paramsunknown

반환값

Promise<undefined>

구현 대상

AdkBasePlugin.beforeToolSelection

정의 위치

src/integrations/googleAdk.ts:914

finishInterruptedInvocation

finishInterruptedInvocation(invocationId): void afterRunCallback에 도달하지 못한 run을 완료 처리합니다. ADK는 이벤트 루프가 정상적으로 모두 처리된 후에만 afterRunCallback을 호출하므로, 소비자가 runAsync에서 일찍 빠져나오거나 run이 중단되면 invocation (및 해당 span들)이 열린 상태로 남습니다. 자동 instrument 러너 래퍼는 이를 finally에서 호출해 중단된 것으로 닫습니다. 멱등적이므로 run이 이미 완료된 경우에는 아무 작업도 하지 않습니다(일반적으로 전체를 끝까지 소비한 경우).

매개변수

이름유형
invocationIdstring

반환값

void

정의 위치

src/integrations/googleAdk.ts:732

onEventCallback

onEventCallback(params): Promise<undefined>

매개변수

이름유형
paramsObject
params.eventEvent
params.invocationContextInvocationContext

반환값

Promise<undefined>

구현 대상

AdkBasePlugin.onEventCallback

정의 위치

src/integrations/googleAdk.ts:693

onModelErrorCallback

onModelErrorCallback(params): Promise<undefined>

매개변수

이름유형
paramsObject
params.callbackContextContext
params.errorError
params.llmRequestLlmRequest

반환값

Promise<undefined>

구현 대상

AdkBasePlugin.onModelErrorCallback

정의 위치

src/integrations/googleAdk.ts:884

onToolErrorCallback

onToolErrorCallback(params): Promise<undefined>

매개변수

이름유형
paramsObject
params.errorError
params.toolBaseTool
params.toolArgsRecord<string, unknown>
params.toolContextContext

반환값

Promise<undefined>

구현 대상

AdkBasePlugin.onToolErrorCallback

정의 위치

src/integrations/googleAdk.ts:977

onUserMessageCallback

onUserMessageCallback(_params): Promise<undefined>

매개변수

이름유형
_paramsObject
_params.invocationContextInvocationContext
_params.userMessageContent

반환값

Promise<undefined>

구현 대상

AdkBasePlugin.onUserMessageCallback

정의 위치

src/integrations/googleAdk.ts:614