> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coreweave.com/llms.txt
> Use this file to discover all available pages before exploring further.
# op
> weave.trace.op에 대한 Python SDK 레퍼런스
export const SourceLink = ({url}) =>
Source
;
API 개요
***
클래스 `DisplayNameFuncError`
***
클래스 `OpCallError`
***
클래스 `OpKwargs`
op() 키워드 인수를 위한 TypedDict입니다.
***
클래스 `Sentinel`
Sentinel(package: 'str', path: 'str', name: 'str')
방법 `__init__`
```python theme={"system"}
__init__(package: 'str', path: 'str', name: 'str') → None
```
***
클래스 `WeaveKwargs`
***
함수 `as_op`
```python theme={"system"}
as_op(fn: 'Callable[P, R]') → Op[P, R]
```
@weave.op으로 데코레이팅된 함수가 주어지면 해당 Op를 반환합니다.
@weave.op으로 데코레이팅된 함수는 이미 Op의 인스턴스이므로, 이 함수는 런타임에서 no-op이어야 합니다. 그러나 OpDef 속성에 유형 안전한 방식으로 액세스해야 하는 경우 유형 체커를 만족시키기 위해 사용할 수 있습니다.
**인수:**
* `fn`: weave.op으로 데코레이팅된 함수입니다.
**반환값:**
함수의 Op입니다.
***
함수 `call`
```python theme={"system"}
call(
op: 'Op',
*args: 'Any',
__weave: 'WeaveKwargs | None' = None,
__should_raise: 'bool' = False,
__require_explicit_finish: 'bool' = False,
**kwargs: 'Any'
) → tuple[Any, Call] | Coroutine[Any, Any, tuple[Any, Call]]
```
op를 실행하고 결과와 이 실행을 나타내는 Call을 함께 반환합니다.
이 함수는 예외를 발생시키지 않습니다. 발생한 오류는 모두 Call 객체에 캡처됩니다.
이 방법은 `@weave.op`으로 데코레이팅된 모든 함수에 자동으로 바인딩되므로 다음과 같이 사용할 수 있습니다:
```python theme={"system"}
@weave.op
def add(a: int, b: int) -> int:
return a + b
result, call = add.call(1, 2)
```
***
함수 `calls`
```python theme={"system"}
calls(op: 'Op') → CallsIter
```
이 op에 대한 모든 Call의 이터레이터를 조회합니다.
이 방법은 `@weave.op`로 데코레이트된 모든 함수에 자동으로 바인딩되므로 다음과 같이 사용할 수 있습니다.
```python theme={"system"}
@weave.op
def add(a: int, b: int) -> int:
return a + b
calls = add.calls()
for call in calls:
print(call)
```
***
함수 `get_captured_code`
```python theme={"system"}
get_captured_code(op: 'Op') → str
```
op의 캡처된 코드를 조회합니다.
ref에서 op를 다시 가져올 때만 작동합니다. 패턴은 다음과 같습니다:
ref = weave.publish(func) op = ref.get() captured\_code = op.get\_captured\_code()
***
함수 `is_op`
```python theme={"system"}
is_op(obj: 'Any') → TypeIs[Op]
```
객체가 Op인지 확인합니다.
***
함수 `is_placeholder_call`
```python theme={"system"}
is_placeholder_call(call: 'Call') → TypeIs[NoOpCall]
```
***
함수 `is_tracing_setting_disabled`
```python theme={"system"}
is_tracing_setting_disabled() → bool
```
***
함수 `maybe_bind_method`
```python theme={"system"}
maybe_bind_method(func: 'Callable', self: 'Any' = None) → Callable | MethodType
```
함수를 모든 객체에 바인딩합니다(클래스가 아니더라도).
self가 None이면 함수를 그대로 반환합니다.
***
함수 `maybe_unbind_method`
```python theme={"system"}
maybe_unbind_method(oplike: 'Op | MethodType | partial') → Op
```
Op과 유사한 방법 또는 partial의 바인딩을 해제하여 일반 Op 함수로 변환합니다.
대상별 동작:
* 방법: 바인딩된 `self` 파라미터를 제거합니다
* partial: 미리 설정된 파라미터를 모두 제거합니다
***
함수 `op`
```python theme={"system"}
op(
func: 'Callable[P, R] | None' = None,
name: 'str | None' = None,
call_display_name: 'str | CallDisplayNameFunc | None' = None,
postprocess_inputs: 'PostprocessInputsFunc | None' = None,
postprocess_output: 'PostprocessOutputFunc | None' = None,
tracing_sample_rate: 'float' = 1.0,
enable_code_capture: 'bool' = True,
accumulator: 'Callable[[Any | None, Any], Any] | None' = None,
kind: 'OpKind | None' = None,
color: 'OpColor | None' = None,
attributes: 'dict[str, Any] | None' = None,
eager_call_start: 'bool' = False
) → Callable[[Callable[P, R]], Op[P, R]] | Op[P, R]
```
함수나 방법을 Weave Op으로 만드는 데코레이터입니다. 동기 및 비동기 함수 모두에서 작동하며, 이터레이터 함수를 자동으로 감지해 그에 맞는 동작을 적용합니다.
**인수:**
***
함수 `placeholder_call`
```python theme={"system"}
placeholder_call() → Call
```
***
함수 `setup_dunder_weave_dict`
```python theme={"system"}
setup_dunder_weave_dict(op: 'Op', d: 'WeaveKwargs | None' = None) → WeaveKwargs
```
WeaveKwargs를 Op에 전달하는 데 사용되는 \_\_weave 딕셔너리를 설정합니다.
* `func`: 데코레이터를 적용할 함수입니다.
* `name`: op의 맞춤형 이름입니다. 기본값은 함수 이름입니다.
* `call_display_name`: Call의 표시 이름이며, string 또는 호출 가능한 객체일 수 있습니다.
* `postprocess_inputs`: 로깅하기 전에 입력을 변환하는 함수입니다.
* `postprocess_output`: 로깅하기 전에 출력을 변환하는 함수입니다.
* `tracing_sample_rate`: 트레이싱할 Call의 비율입니다(0.0\~1.0).
* `enable_code_capture`: 이 op의 소스 코드를 캡처할지 여부입니다.
* `accumulator`: 스트리밍 Op의 결과를 누적하는 함수입니다.
* `attributes`: 이 op가 생성하는 모든 Call에 가장 낮은 우선순위로 병합되는 기본 속성입니다. 키가 충돌하면 `weave.attributes()` 컨텍스트와 명시적인 Call별 속성이 이 값을 재정의합니다. 예약된 "weave" 키는 여기에서 설정할 수 없습니다.
* `eager_call_start`: True이면 Call 시작이 일괄 처리되지 않고 즉시 전송됩니다. 평가처럼 UI에 즉시 표시되어야 하는 장시간 실행 오퍼레이션에 유용합니다.
**인수:**
* `d`: 업데이트할 기존 WeaveKwargs 딕셔너리입니다(선택).
* `op`: kind와 color를 추출할 Op입니다.
**반환값:**
attributes, display\_name 및 선택적으로 kind/color가 설정된 WeaveKwargs 딕셔너리입니다.
***
함수 `should_skip_tracing_for_op`
```python theme={"system"}
should_skip_tracing_for_op(op: 'Op') → bool
```