> ## 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.

# Agent Lens란 무엇인가요?

> CoreWeave Agent Lens를 소개하고, 이를 활용해 LLM 에이전트를 트레이스하고 모니터링하며 개선하는 방법을 알아보세요

CoreWeave Agent Lens는 에이전트의 동작과 메트릭을 관찰하고 추적할 수 있는 관측성 플랫폼입니다. 대화, 도구 Call, 성능 메트릭을 캡처하고, 추적하려는 특정 동작을 한눈에 파악할 수 있도록 보여 줍니다.

Agent Lens는 멀티 테넌트 SaaS에서 공개 프리뷰로 제공됩니다.

<h2 id="core-capabilities">
  핵심 기능
</h2>

Agent Lens는 다음과 같은 핵심 기능을 제공합니다.

* 에이전트 세션과 멀티턴 대화에 대한 \*\*[가시성](/ko/products/agent-lens/conversations/view-activity)\*\*을 제공합니다.
* \*\*[하위 에이전트 트레이싱](/ko/products/agent-lens/tracing/sub-agents)\*\*으로 에이전트가 하위 에이전트에 위임한 작업을 파악할 수 있습니다.
* 에이전트의 동작, 오류, 추세에 대한 \*\*[집계 인사이트](/ko/products/agent-lens/insights)\*\*를 제공합니다.
* 분석하려는 에이전트 또는 사용자 동작을 나타내는 태그로 \*\*[맞춤형 동작 추적](/ko/products/agent-lens/tags/create-tag)\*\*을 할 수 있습니다.
* 사용량, 오류율, 토큰 비용을 보여 주는 \*\*[대시보드 메트릭](/ko/products/agent-lens/conversations/view-activity)\*\*을 제공합니다.
* 사람의 판단과 주석을 캡처하는 **[피드백 수집](/ko/products/agent-lens/conversations/annotate-turns)** 기능을 제공합니다.

<h2 id="how-agent-lens-works">
  Agent Lens 작동 방식
</h2>

Agent Lens는 [OpenTelemetry (OTel)](https://opentelemetry.io/docs/concepts/)와 [GenAI 시맨틱 규칙](https://opentelemetry.io/docs/specs/semconv/gen-ai/)을 기반으로 구축되었습니다. Agent Lens는 모든 OTel span을 수신하고 그 속성을 저장하므로 속성을 기준으로 쿼리할 수 있습니다. `invoke_agent`, `execute_tool` 등 GenAI 에이전트 규칙을 따르는 span은 Agent Lens에서 대화, 턴, 도구 Call로 표시됩니다.

<h2 id="integration-options">
  인테그레이션 옵션
</h2>

필요에 따라 다음 가이드를 참고해 Agent Lens를 통합할 수 있습니다.

* 에이전트가 이미 OTel로 계측되어 있다면 코드를 다시 계측하지 않고도 기존 span을 Agent Lens로 보낼 수 있습니다.  [SDK 인테그레이션 없이 기존 span을 Agent Lens로 보내는 방법](/ko/products/agent-lens/get-started/opentelemetry)을 참조하세요.
* Codex나 Claude Code 같은 기존 하니스를 트레이스하려면 [해당 하니스의 Weave 플러그인을 설치하세요](/ko/products/agent-lens/get-started/integrations#agent-harnesses). 플러그인이 하니스의 span을 프로젝트로 전송하면 Agent Lens에서 확인할 수 있습니다.
* 에이전트가 OpenAI, Anthropic 또는 Google Gen AI SDK로 모델을 호출한다면 [LLM 공급자 SDK 인테그레이션](/ko/products/agent-lens/get-started/integrations#llm-provider-sdks)을 참조하세요.
* 널리 쓰이는 에이전트 SDK로 에이전트를 구축한다면 [지원되는 에이전트 SDK 인테그레이션](/ko/products/agent-lens/get-started/integrations#agent-sdks)을 참조하세요.
* 맞춤형 에이전트를 구축 중이며 계측에 도움이 필요하다면 [맞춤형 에이전트 퀵스타트](/ko/products/agent-lens/get-started/custom-agents)를 참조하세요.

<h2 id="agent-lens-and-weights-biases-weave">
  Agent Lens와 Weights & Biases Weave
</h2>

Agent Lens는 [Weights & Biases Weave](/ko/products/wandb/weave)를 구축한 팀이 새롭게 선보이는 에이전트 관측성 제품입니다. 두 제품 모두 CoreWeave Forge에 속하며 함께 사용할 수 있습니다. 두 제품은 동일한 트레이스 데이터를 공유하므로 한쪽으로 보낸 에이전트 트레이스는 다른 쪽에도 표시되며, 데이터를 복사하거나 마이그레이션할 필요가 없습니다.

에이전트를 트레이스, 모니터링, 분석하려면 Agent Lens를 사용하는 것이 좋습니다. Agent Lens는 에이전트 실패와 사용자 의도에 대한 [인사이트](/ko/products/agent-lens/insights), 대화, 턴, span을 간결하게 보여 주는 뷰 등 Weave에 없는 기능을 제공합니다. 이미 Weave로 에이전트를 트레이스하고 있다면 Agent Lens에서 같은 프로젝트를 열어 기존 대화를 확인하세요.

Agent Lens가 아직 지원하지 않는 다음과 같은 워크플로는 계속 Weave에서 사용할 수 있습니다.

* 평가
* Op 및 Call을 사용한 함수별 트레이스
* 가드레일

이러한 워크플로 중 상당수는 향후 Agent Lens에도 추가될 예정입니다. 지금 바로 필요하다면 Agent Lens와 Weave를 함께 사용하여 부족한 부분을 보완하세요.

두 제품은 Forge에서 서로 다른 SDK와 애플리케이션을 사용합니다.

| | Agent Lens | Weights & Biases Weave |
| - | - | - |
| SDK | [CoreWeave Forge SDK](/ko/products/agent-lens/get-started/custom-agents) | [Weights & Biases Weave SDK](/ko/products/wandb/weave/guides/integrations) |
| UI | [Agent Lens 애플리케이션](https://forge.coreweave.com/agent-lens) | [Weights & Biases 애플리케이션](https://forge.coreweave.com/wandb/home) |

CoreWeave Forge 콘솔 왼쪽 상단의 App Launcher에서 **Agent Lens** 또는 **Weights & Biases**를 선택하세요.

Agent Lens와 Weave는 동일한 백엔드를 공유하므로 일부 설정 이름에는 Weights & Biases 명칭이 그대로 남아 있습니다.

* `WANDB_API_KEY`: Forge SDK가 CoreWeave Forge API 키를 읽어 오는 환경 변수입니다.
* `trace.wandb.ai`: 트레이스를 수신하는 엔드포인트입니다.
* `wandb.entity` 및 `wandb.project`: span을 프로젝트로 라우팅하는 OpenTelemetry 리소스 속성입니다.

하니스 인테그레이션은 Weave 플러그인(`weave-claude-code`, `weave-codex`, `weave-openclaw`)으로 제공됩니다. 이 플러그인이 보내는 트레이스는 Agent Lens와 Weave 모두에 표시됩니다.