Tool - CoreWeave Docs

class Tool(BaseModel): ...

단일 도구 실행을 나타냅니다. execute_tool OTel span에 매핑됩니다. arguments와 result에는 JSONString 어노테이션이 적용됩니다. 호출자가 dict / list / 스칼라 값을 부여하면 SDK가 생성 시점 또는 부여 시점에 이를 JSON으로 인코딩합니다. 저장되는 값은 GenAI semconv의 전송 형식에 맞춰 항상 문자열입니다. Tool은 Pydantic 모델입니다. 생성할 때 아래의 모든 필드를 키워드 인수로 설정할 수 있습니다. Tool은 컨텍스트 관리자이므로 with 문에서 사용할 수 있습니다.

필드

필드	유형	기본값
`name`	`str`	`''`
`arguments`	`JSONString`	`''`
`result`	`JSONString`	`''`
`tool_call_id`	`str`	`''`
`tool_type`	`str`	`''`
`tool_description`	`str`	`''`
`tool_definitions`	`str`	`''`
`duration_ms`	`int`	`0`
`started_at`	`Union[datetime, None]`	`None`
`ended_at`	`Union[datetime, None]`	`None`

메서드

end

def end() -> None: ...

start

def start() -> Self: ...

이 span을 한 번 시작합니다. 컨텍스트 관리자로 진입할 때도 동일한 경로를 사용합니다.

record_error

def record_error(error: BaseException) -> Self: ...

span을 종료하지 않은 채 실패를 기록합니다. 종료할 준비가 되면 end()를 호출하세요.

set_attributes

def set_attributes(attributes: dict[str, Any]) -> Self: ...

이 span에 임의의 OTel 속성을 설정합니다. 키가 하나든 여러 개든 dict를 전달하세요. 키가 하나뿐이라면 span.set_attributes({"weave.tag": "value"})처럼 호출합니다. OTel의 Span.set_attributes와 동일하게 동작합니다. start_* 팩토리, start() 또는 with로 span을 시작한 후, span이 종료되기 전에 호출해야 합니다. 이 윈도우를 벗어나 호출하면 아무 작업도 수행하지 않고 경고를 로깅합니다. 일괄 수집 시에는 객체에 선언된 필드를 직접 채운 후 log_turn / log_conversation에 전달하세요.

​필드

​메서드

​end

​start

​record_error

​set_attributes

필드

메서드

end

start

record_error

set_attributes