태그

태그 (Tags)

세션을 조직화하고 필터링하는 데 사용하는 태그(tags)를 소개해요. 태그를 추가하는 방법과 다양한 사용 사례, 대시보드에서 활용하는 법을 살펴볼게요.

출처: 문서

본문

태그 추가하기 (Adding Tags)

AgentOps를 초기화할 때 태그를 추가할 수 있는데, 이것이 가장 일반적인 방법입니다.

import agentops

# Initialize AgentOps with tags
agentops.init(
    api_key="YOUR_API_KEY",
    default_tags=["production", "customer-service", "gpt-4"]
)

또는 수동으로 트레이스를 만들 때 추가할 수도 있습니다.

# Initialize without auto-starting a session
agentops.init(api_key="YOUR_API_KEY", auto_start_session=False)

# Later start a trace with specific tags (modern approach)
trace = agentops.start_trace(trace_name="test_workflow", default_tags=["development", "testing", "claude-3"])

태그 사용 사례 (Tag Use Cases)

태그는 다양한 목적으로 사용될 수 있습니다.

환경 식별 (Environment Identification)

환경에 따라 세션에 태그를 붙여 보세요.

default_tags=["production"] # or ["development", "staging", "testing"]

기능 추적 (Feature Tracking)

특정 기능이나 컴포넌트와 관련된 세션에 태그를 붙입니다.

default_tags=["search-functionality", "user-authentication", "content-generation"]

사용자 세분화 (User Segmentation)

사용자 특성에 따라 세션에 태그를 붙여 보세요.

default_tags=["premium-user", "new-user", "enterprise-customer"]

실험 추적 (Experiment Tracking)

특정 실험의 일부로 세션에 태그를 붙입니다.

default_tags=["experiment-123", "control-group", "variant-A"]

모델 식별 (Model Identification)

사용 중인 모델로 세션에 태그를 붙여 보세요.

default_tags=["gpt-4", "claude-3-opus", "mistral-large"]

태그가 붙은 세션 보기 (Viewing Tagged Sessions)

AgentOps 대시보드에서요:

1. 태그 필터를 사용해 특정 태그를 선택하세요
2. 여러 태그를 결합해 보기를 정리하세요
3. 자주 쓰는 뷰를 저장해 빠르게 접근하세요

모범 사례 (Best Practices)

• 태그에 일관된 명명 규칙을 사용하세요
• 광범위한 카테고리와 구체적인 식별자를 모두 포함하세요
• 세션당 너무 많은 태그는 피하세요 (보통 3-5개면 충분해요)
• 계층적 태그 구조를 고려하세요 (예: "env:production", "model:gpt-4")
• 애플리케이션이 발전함에 따라 태깅 전략을 업데이트하세요

더 알아보기 (Learn more)

• AgentOps 공식 문서