🇺🇸 English • 🇨🇳 中文 • 🇹🇼 繁體中文 • 🇯🇵 日本語 • 🇵🇹 Português • 🇧🇷 Português • 🇰🇷 한국어 • 🇪🇸 Español • 🇩🇪 Deutsch • 🇫🇷 Français • 🇮🇱 עברית • 🇸🇦 العربية • 🇷🇺 Русский • 🇵🇱 Polski • 🇨🇿 Čeština • 🇳🇱 Nederlands • 🇹🇷 Türkçe • 🇺🇦 Українська • 🇻🇳 Tiếng Việt • 🇵🇭 Tagalog • 🇮🇩 Indonesia • 🇹🇭 ไทย • 🇮🇳 हिन्दी • 🇧🇩 বাংলা • 🇵🇰 اردو • 🇷🇴 Română • 🇸🇪 Svenska • 🇮🇹 Italiano • 🇬🇷 Ελληνικά • 🇭🇺 Magyar • 🇫🇮 Suomi • 🇩🇰 Dansk • 🇳🇴 Norsk

Arize Phoenix는 실험, 평가, 문제 해결을 위해 설계된 Arize의 오픈소스 AI 관측성(observability) 플랫폼입니다. 관리형 프로덕션 워크플로가 필요하다면 Arize는 [Arize AX](https://arize.com/products/ax/?utm_source=github&utm_medium=community&utm_campaign=px-to-ax&utm_content=readme-ko)도 제공합니다. Phoenix가 제공하는 기능은 다음과 같습니다: - [**_트레이싱_**](https://arize.com/docs/phoenix/tracing/llm-traces) - OpenTelemetry 기반 계측을 사용하여 LLM 애플리케이션의 런타임을 트레이싱합니다. - [**_평가_**](https://arize.com/docs/phoenix/evaluation/llm-evals) - 응답 및 검색(retrieval) 평가를 통해 LLM을 활용하여 애플리케이션의 성능을 벤치마킹합니다. - [**_데이터셋_**](https://arize.com/docs/phoenix/datasets-and-experiments/overview-datasets) - 실험, 평가, 파인튜닝을 위해 버전 관리되는 예제 데이터셋을 생성합니다. - [**_실험_**](https://arize.com/docs/phoenix/datasets-and-experiments/overview-datasets#experiments) - 프롬프트, LLM, 검색에 대한 변경 사항을 추적하고 평가합니다. - [**_플레이그라운드_**](https://arize.com/docs/phoenix/prompt-engineering/overview-prompts)- 프롬프트를 최적화하고, 모델을 비교하고, 파라미터를 조정하고, 트레이싱된 LLM 호출을 재실행합니다. - [**_프롬프트 관리_**](https://arize.com/docs/phoenix/prompt-engineering/overview-prompts/prompt-management)- 버전 관리, 태깅, 실험을 통해 프롬프트 변경 사항을 체계적으로 관리하고 테스트합니다. - [**_PXI (Phoenix Intelligence)_**](https://arize.com/docs/phoenix/pxi) - 트레이스 디버깅, 프롬프트 반복 개선, 제품 탐색을 위해 Phoenix에 내장된 AI 엔지니어링 에이전트입니다. - [**_원격 MCP 서버_**](https://arize.com/docs/phoenix/integrations/mcp#remote-mcp-server) - Claude Code, Cursor 및 기타 MCP 클라이언트를 Phoenix 인스턴스의 `/mcp` 엔드포인트에 직접 연결하여 트레이스, 데이터셋, 실험 등을 조회할 수 있습니다.

Phoenix는 벤더와 언어에 구애받지 않으며, 인기 있는 프레임워크([OpenAI Agents SDK](https://arize.com/docs/phoenix/tracing/integrations-tracing/openai-agents-sdk), [Claude Agent SDK](https://arize.com/docs/phoenix/integrations/python/claude-agent-sdk), [LangGraph](https://arize.com/docs/phoenix/tracing/integrations-tracing/langchain), [Vercel AI SDK](https://arize.com/docs/phoenix/tracing/integrations-tracing/vercel-ai-sdk), [Mastra](https://arize.com/docs/phoenix/integrations/typescript/mastra), [CrewAI](https://arize.com/docs/phoenix/tracing/integrations-tracing/crewai), [LlamaIndex](https://arize.com/docs/phoenix/tracing/integrations-tracing/llamaindex), [DSPy](https://arize.com/docs/phoenix/tracing/integrations-tracing/dspy))와 LLM 제공업체([OpenAI](https://arize.com/docs/phoenix/tracing/integrations-tracing/openai), [Anthropic](https://arize.com/docs/phoenix/tracing/integrations-tracing/anthropic), [Google GenAI](https://arize.com/docs/phoenix/tracing/integrations-tracing/google-genai), [Google ADK](https://arize.com/docs/phoenix/integrations/llm-providers/google-gen-ai/google-adk-tracing), [AWS Bedrock](https://arize.com/docs/phoenix/tracing/integrations-tracing/bedrock), [OpenRouter](https://arize.com/docs/phoenix/integrations/python/openrouter), [LiteLLM](https://arize.com/docs/phoenix/tracing/integrations-tracing/litellm) 등)를 기본적으로 지원합니다. 자동 계측에 대한 자세한 내용은 [OpenInference](https://github.com/Arize-ai/openinference) 프로젝트를 참고하세요. Phoenix는 로컬 머신, 컨테이너 기반 배포, 클라우드 등 사실상 어디서나 실행됩니다. 각 옵션에 대한 안내는 [환경](https://arize.com/docs/phoenix/self-hosting)을 참고하시거나, 바로 [트레이싱 빠른 시작](https://arize.com/docs/phoenix/get-started/get-started-tracing)으로 이동하세요. > [!NOTE] > Phoenix는 오픈소스이며 자체 호스팅 방식입니다. 관리형 플랫폼이 필요하다면 Arize의 [Arize AX](https://arize.com/products/ax/?utm_source=github&utm_medium=community&utm_campaign=px-to-ax&utm_content=readme-ko)를 이용할 수 있으며, 동일한 OpenTelemetry/OpenInference 계측이 두 플랫폼 모두에서 작동합니다. [전체 비교](https://arize.com/docs/phoenix/resources/frequently-asked-questions/what-is-the-difference-between-phoenix-and-arize)를 참고하세요. ## 목차 - [로컬에서 실행](#로컬에서-실행) - [애플리케이션 트레이싱](#애플리케이션-트레이싱) - [배포](#배포) - [패키지](#패키지) - [트레이싱 통합](#트레이싱-통합) - [샌드박스](#샌드박스) - [사람과 코딩 에이전트를 위한 기능](#사람과-코딩-에이전트를-위한-기능) - [보안 및 개인정보 보호](#보안-및-개인정보-보호) - [커뮤니티](#커뮤니티) ## 로컬에서 실행 `pip` 또는 `conda`로 Phoenix를 설치하면 모든 기능을 갖춘 Phoenix를 사용할 수 있습니다. 모든 설치 및 호스팅 옵션은 [설치 가이드](https://arize.com/docs/phoenix)를 참고하세요. ```shell pip install arize-phoenix phoenix serve ``` 또는 [`uvx`](https://docs.astral.sh/uv/)를 사용하여 설치 없이 실행할 수도 있습니다: ```shell uvx arize-phoenix serve ``` ## 애플리케이션 트레이싱 트레이스를 보내는 가장 빠른 방법은 [코딩 에이전트](https://arize.com/docs/phoenix/integrations/developer-tools/coding-agents)(Claude Code, Codex, Cursor 등)가 앱을 계측하도록 하는 것입니다. 프로젝트 디렉터리에서 다음을 실행하세요: ```shell npx @arizeai/phoenix-cli setup # 또는 Phoenix가 설치되어 있는 경우: px setup ``` 설정 과정에서 프레임워크와 LLM 제공업체를 감지하고, 적합한 [OpenInference](https://github.com/Arize-ai/openinference) 계측을 설치하며, 트레이스 내보내기를 구성합니다. 코드에서 직접 구성하고 싶으신가요? [트레이싱 문서](https://arize.com/docs/phoenix/tracing/llm-traces)를 참고하세요. ## 배포 Phoenix 컨테이너 이미지는 [Docker Hub](https://hub.docker.com/r/arizephoenix/phoenix)에서 제공되며, Docker를 사용하거나 [Helm 차트](https://github.com/Arize-ai/phoenix/tree/main/helm)를 통해 Kubernetes에 배포할 수 있습니다. Docker Compose, Kubernetes/Helm 및 기타 배포 옵션은 [자체 호스팅 문서](https://arize.com/docs/phoenix/self-hosting)를 참고하세요.

> [!NOTE] > Google Cloud 버튼은 사전 빌드된 Docker Hub 이미지를 배포하는 대신 Cloud Shell에서 소스로부터 Phoenix를 빌드합니다. Azure 템플릿은 일반 HTTP로 서비스합니다(Azure Container Instances는 TLS를 종료하지 않습니다). 프로덕션 환경에서 사용하기 전에 Application Gateway와 같은 TLS 프록시를 앞단에 배치하세요. ## 패키지 `arize-phoenix` 패키지에는 Phoenix 플랫폼 전체가 포함되어 있습니다. 다만 Phoenix 플랫폼을 이미 배포했다면, 플랫폼과 함께 사용할 수 있는 경량 Python 하위 패키지와 TypeScript 패키지도 있습니다. ### Python 하위 패키지 | 패키지 | 버전 및 문서 | 설명 | | --------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ | | [arize-phoenix-otel](https://github.com/Arize-ai/phoenix/tree/main/packages/phoenix-otel) | [![PyPI Version](https://img.shields.io/pypi/v/arize-phoenix-otel)](https://pypi.org/project/arize-phoenix-otel/) [![Docs](https://img.shields.io/badge/docs-blue?logo=readthedocs&logoColor=white)](https://arize-phoenix.readthedocs.io/projects/otel/en/latest/index.html) | Phoenix에 맞춘 기본값을 갖춘 OpenTelemetry 프리미티브용 경량 래퍼를 제공합니다 | | [arize-phoenix-client](https://github.com/Arize-ai/phoenix/tree/main/packages/phoenix-client) | [![PyPI Version](https://img.shields.io/pypi/v/arize-phoenix-client)](https://pypi.org/project/arize-phoenix-client/) [![Docs](https://img.shields.io/badge/docs-blue?logo=readthedocs&logoColor=white)](https://arize-phoenix.readthedocs.io/projects/client/en/latest/index.html) | OpenAPI REST 인터페이스를 통해 Phoenix 서버와 상호작용하는 경량 클라이언트 | | [arize-phoenix-evals](https://github.com/Arize-ai/phoenix/tree/main/packages/phoenix-evals) | [![PyPI Version](https://img.shields.io/pypi/v/arize-phoenix-evals)](https://pypi.org/project/arize-phoenix-evals/) [![Docs](https://img.shields.io/badge/docs-blue?logo=readthedocs&logoColor=white)](https://arize-phoenix.readthedocs.io/projects/evals/en/latest/index.html) | RAG 관련성, 답변 관련성 등을 포함해 LLM 애플리케이션을 평가하는 도구 | ### TypeScript 하위 패키지 | 패키지 | 버전 및 문서 | 설명 | | --------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ | | [@arizeai/phoenix-otel](https://github.com/Arize-ai/phoenix/tree/main/js/packages/phoenix-otel) | [![NPM Version](https://img.shields.io/npm/v/%40arizeai%2Fphoenix-otel)](https://www.npmjs.com/package/@arizeai/phoenix-otel) [![Docs](https://img.shields.io/badge/docs-blue?logo=typescript&logoColor=white)](https://arize-ai.github.io/phoenix/) | Phoenix에 맞춘 기본값을 갖춘 OpenTelemetry 프리미티브용 경량 래퍼를 제공합니다 | | [@arizeai/phoenix-client](https://github.com/Arize-ai/phoenix/tree/main/js/packages/phoenix-client) | [![NPM Version](https://img.shields.io/npm/v/%40arizeai%2Fphoenix-client)](https://www.npmjs.com/package/@arizeai/phoenix-client) [![Docs](https://img.shields.io/badge/docs-blue?logo=typescript&logoColor=white)](https://arize-ai.github.io/phoenix/) | Arize Phoenix API용 클라이언트 | | [@arizeai/phoenix-evals](https://github.com/Arize-ai/phoenix/tree/main/js/packages/phoenix-evals) | [![NPM Version](https://img.shields.io/npm/v/%40arizeai%2Fphoenix-evals)](https://www.npmjs.com/package/@arizeai/phoenix-evals) [![Docs](https://img.shields.io/badge/docs-blue?logo=typescript&logoColor=white)](https://arize-ai.github.io/phoenix/) | LLM 애플리케이션을 위한 TypeScript 평가 라이브러리(알파 릴리스) | | [@arizeai/phoenix-cli](https://github.com/Arize-ai/phoenix/tree/main/js/packages/phoenix-cli) | [![NPM Version](https://img.shields.io/npm/v/%40arizeai%2Fphoenix-cli)](https://www.npmjs.com/package/@arizeai/phoenix-cli) [![Docs](https://img.shields.io/badge/docs-blue?logo=typescript&logoColor=white)](https://arize.com/docs/phoenix/sdk-api-reference/typescript/arizeai-phoenix-cli) | Claude Code, Cursor 및 기타 코딩 에이전트에서 사용할 트레이스, 데이터셋, 실험을 가져오는 CLI | ## 트레이싱 통합 Phoenix는 OpenTelemetry 기반으로 구축되었으며 벤더, 언어, 프레임워크에 구애받지 않습니다. 트레이싱 통합 및 예제 애플리케이션에 대한 자세한 내용은 [OpenInference](https://github.com/Arize-ai/openinference) 프로젝트와 [통합 문서](https://arize.com/docs/phoenix/integrations)를 참고하세요. **Python 통합** | | 통합 | 패키지 | 버전 | |:---:|---|---|---| |

| [OpenAI](https://arize.com/docs/phoenix/tracing/integrations-tracing/openai) | `openinference-instrumentation-openai` | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-openai.svg)](https://pypi.python.org/pypi/openinference-instrumentation-openai) | |

| [OpenAI Agents](https://arize.com/docs/phoenix/tracing/integrations-tracing/openai-agents-sdk) | `openinference-instrumentation-openai-agents` | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-openai-agents.svg)](https://pypi.python.org/pypi/openinference-instrumentation-openai-agents) | |

| [LlamaIndex](https://arize.com/docs/phoenix/tracing/integrations-tracing/llamaindex) | `openinference-instrumentation-llama-index` | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-llama-index.svg)](https://pypi.python.org/pypi/openinference-instrumentation-llama-index) | | | [DSPy](https://arize.com/docs/phoenix/tracing/integrations-tracing/dspy) | `openinference-instrumentation-dspy` | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-dspy.svg)](https://pypi.python.org/pypi/openinference-instrumentation-dspy) | |

| [AWS Bedrock](https://arize.com/docs/phoenix/tracing/integrations-tracing/bedrock) | `openinference-instrumentation-bedrock` | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-bedrock.svg)](https://pypi.python.org/pypi/openinference-instrumentation-bedrock) | |

| [LangChain](https://arize.com/docs/phoenix/tracing/integrations-tracing/langchain) | `openinference-instrumentation-langchain` | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-langchain.svg)](https://pypi.python.org/pypi/openinference-instrumentation-langchain) | |

| [LangGraph](https://arize.com/docs/phoenix/integrations/python/langgraph) | `openinference-instrumentation-langchain` | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-langchain.svg)](https://pypi.python.org/pypi/openinference-instrumentation-langchain) | |

| [MistralAI](https://arize.com/docs/phoenix/tracing/integrations-tracing/mistralai) | `openinference-instrumentation-mistralai` | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-mistralai.svg)](https://pypi.python.org/pypi/openinference-instrumentation-mistralai) | |

| [Cohere](https://arize.com/docs/phoenix/integrations/llm-providers/cohere) | `openinference-instrumentation-cohere` | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-cohere.svg)](https://pypi.python.org/pypi/openinference-instrumentation-cohere) | |

| [Together AI](https://arize.com/docs/phoenix/integrations/llm-providers/together) | `openinference-instrumentation-together` | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-together.svg)](https://pypi.python.org/pypi/openinference-instrumentation-together) | |

| [Ollama](https://arize.com/docs/phoenix/integrations/llm-providers/ollama) | `openinference-instrumentation-ollama` | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-ollama.svg)](https://pypi.python.org/pypi/openinference-instrumentation-ollama) | |

| [Google GenAI](https://arize.com/docs/phoenix/tracing/integrations-tracing/google-gen-ai) | `openinference-instrumentation-google-genai` | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-google-genai.svg)](https://pypi.python.org/pypi/openinference-instrumentation-google-genai) | |

| [Google ADK](https://arize.com/docs/phoenix/integrations/llm-providers/google-gen-ai/google-adk-tracing) | `openinference-instrumentation-google-adk` | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-google-adk.svg)](https://pypi.python.org/pypi/openinference-instrumentation-google-adk) | | | [Guardrails](https://arize.com/docs/phoenix/tracing/integrations-tracing/guardrails) | `openinference-instrumentation-guardrails` | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-guardrails.svg)](https://pypi.python.org/pypi/openinference-instrumentation-guardrails) | |

| [VertexAI](https://arize.com/docs/phoenix/tracing/integrations-tracing/vertexai) | `openinference-instrumentation-vertexai` | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-vertexai.svg)](https://pypi.python.org/pypi/openinference-instrumentation-vertexai) | |

| [CrewAI](https://arize.com/docs/phoenix/tracing/integrations-tracing/crewai) | `openinference-instrumentation-crewai` | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-crewai.svg)](https://pypi.python.org/pypi/openinference-instrumentation-crewai) | | | [Haystack](https://arize.com/docs/phoenix/tracing/integrations-tracing/haystack) | `openinference-instrumentation-haystack` | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-haystack.svg)](https://pypi.python.org/pypi/openinference-instrumentation-haystack) | | | [LiteLLM](https://arize.com/docs/phoenix/tracing/integrations-tracing/litellm) | `openinference-instrumentation-litellm` | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-litellm.svg)](https://pypi.python.org/pypi/openinference-instrumentation-litellm) | | | [OpenRouter](https://arize.com/docs/phoenix/integrations/llm-providers/openrouter) | `openinference-instrumentation-openai` | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-openai.svg)](https://pypi.python.org/pypi/openinference-instrumentation-openai) | | | [OrcaRouter](https://arize.com/docs/phoenix/integrations/llm-providers/orcarouter) | `openinference-instrumentation-openai` | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-openai.svg)](https://pypi.python.org/pypi/openinference-instrumentation-openai) | |

| [Groq](https://arize.com/docs/phoenix/tracing/integrations-tracing/groq) | `openinference-instrumentation-groq` | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-groq.svg)](https://pypi.python.org/pypi/openinference-instrumentation-groq) | | | [Instructor](https://arize.com/docs/phoenix/tracing/integrations-tracing/instructor) | `openinference-instrumentation-instructor` | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-instructor.svg)](https://pypi.python.org/pypi/openinference-instrumentation-instructor) | |

| [Anthropic](https://arize.com/docs/phoenix/tracing/integrations-tracing/anthropic) | `openinference-instrumentation-anthropic` | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-anthropic.svg)](https://pypi.python.org/pypi/openinference-instrumentation-anthropic) | |

| [Smolagents](https://huggingface.co/docs/smolagents/en/tutorials/inspect_runs) | `openinference-instrumentation-smolagents` | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-smolagents.svg)](https://pypi.python.org/pypi/openinference-instrumentation-smolagents) | | | [Agno](https://arize.com/docs/phoenix/tracing/integrations-tracing/agno) | `openinference-instrumentation-agno` | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-agno.svg)](https://pypi.python.org/pypi/openinference-instrumentation-agno) | | | [BeeAI](https://arize.com/docs/phoenix/integrations/python/beeai) | `openinference-instrumentation-beeai` | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-beeai.svg)](https://pypi.python.org/pypi/openinference-instrumentation-beeai) | | | [Strands Agents](https://arize.com/docs/phoenix/integrations/python/strands-agents) | `openinference-instrumentation-strands-agents` | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-strands-agents.svg)](https://pypi.python.org/pypi/openinference-instrumentation-strands-agents) | | | [Restate](https://arize.com/docs/phoenix/integrations/python/restate) | `openinference-instrumentation-openai-agents` | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-openai-agents.svg)](https://pypi.python.org/pypi/openinference-instrumentation-openai-agents) | |

| [MCP](https://arize.com/docs/phoenix/tracing/integrations-tracing/model-context-protocol-mcp) | `openinference-instrumentation-mcp` | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-mcp.svg)](https://pypi.python.org/pypi/openinference-instrumentation-mcp) | |

| [Pydantic AI](https://arize.com/docs/phoenix/integrations/python/pydantic) | `openinference-instrumentation-pydantic-ai` | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-pydantic-ai.svg)](https://pypi.python.org/pypi/openinference-instrumentation-pydantic-ai) | | | [AG2](https://arize.com/docs/phoenix/integrations/python/ag2) | `openinference-instrumentation-ag2` | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-ag2.svg)](https://pypi.python.org/pypi/openinference-instrumentation-ag2) | | | [Autogen AgentChat](https://arize.com/docs/phoenix/integrations/frameworks/autogen/autogen-tracing) | `openinference-instrumentation-autogen-agentchat` | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-autogen-agentchat.svg)](https://pypi.python.org/pypi/openinference-instrumentation-autogen-agentchat) | | | [Portkey](https://arize.com/docs/phoenix/integrations/portkey) | `openinference-instrumentation-portkey` | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-portkey.svg)](https://pypi.python.org/pypi/openinference-instrumentation-portkey) | | | [Agent Spec](https://arize.com/docs/phoenix/tracing/integrations-tracing/agentspec) | `openinference-instrumentation-agentspec` | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-agentspec.svg)](https://pypi.python.org/pypi/openinference-instrumentation-agentspec) | |

| [Claude Agent SDK](https://arize.com/docs/phoenix/integrations/python/claude-agent-sdk) | `openinference-instrumentation-claude-agent-sdk` | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-claude-agent-sdk.svg)](https://pypi.python.org/pypi/openinference-instrumentation-claude-agent-sdk) | | | [TypeSafe AI](https://arize.com/docs/phoenix/integrations/llm-providers/typesafe/typesafe-python) | `openinference-instrumentation-typesafe` | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-typesafe.svg)](https://pypi.python.org/pypi/openinference-instrumentation-typesafe) | ## 스팬 프로세서 데이터를 통일하는 스팬 프로세서를 추가하여 다른 계측 라이브러리의 데이터를 정규화하고 변환합니다. | 패키지 | 설명 | 버전 | | ----------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [`openinference-instrumentation-openlit`](https://pypi.org/project/openinference-instrumentation-openlit/) | OpenLIT 트레이스용 OpenInference 스팬 프로세서. | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-openlit.svg)](https://pypi.python.org/pypi/openinference-instrumentation-openlit) | | [`openinference-instrumentation-openllmetry`](https://pypi.org/project/openinference-instrumentation-openllmetry/) | OpenLLMetry(Traceloop) 트레이스용 OpenInference 스팬 프로세서. | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-openllmetry.svg)](https://pypi.python.org/pypi/openinference-instrumentation-openllmetry) | ### JavaScript 통합 | | 통합 | 패키지 | 버전 | | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | ------------------------------------------------------------------------------------------- | --------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | |

| [OpenAI](https://arize.com/docs/phoenix/tracing/integrations-tracing/openai-node-sdk) | `@arizeai/openinference-instrumentation-openai` | [![NPM Version](https://img.shields.io/npm/v/@arizeai/openinference-instrumentation-openai.svg)](https://www.npmjs.com/package/@arizeai/openinference-instrumentation-openai) | |

| [OpenAI Agents](https://arize.com/docs/phoenix/integrations/typescript/openai-agents) | `@arizeai/openinference-instrumentation-openai-agents` | [![NPM Version](https://img.shields.io/npm/v/@arizeai%2Fopeninference-instrumentation-openai-agents.svg)](https://www.npmjs.com/package/@arizeai/openinference-instrumentation-openai-agents) | |

| [LangChain.js](https://arize.com/docs/phoenix/tracing/integrations-tracing/langchain) | `@arizeai/openinference-instrumentation-langchain` | [![NPM Version](https://img.shields.io/npm/v/@arizeai/openinference-instrumentation-langchain.svg)](https://www.npmjs.com/package/@arizeai/openinference-instrumentation-langchain) | | | [TanStack AI](https://arize.com/docs/phoenix/integrations/typescript/tanstack-ai) | `@arizeai/openinference-tanstack-ai` | [![NPM Version](https://img.shields.io/npm/v/@arizeai/openinference-tanstack-ai.svg)](https://www.npmjs.com/package/@arizeai/openinference-tanstack-ai) | |

| [Vercel AI SDK](https://arize.com/docs/phoenix/tracing/integrations-tracing/vercel-ai-sdk) | `@arizeai/openinference-vercel` | [![NPM Version](https://img.shields.io/npm/v/@arizeai/openinference-vercel)](https://www.npmjs.com/package/@arizeai/openinference-vercel) | | | [BeeAI](https://arize.com/docs/phoenix/tracing/integrations-tracing/beeai) | `@arizeai/openinference-instrumentation-beeai` | [![NPM Version](https://img.shields.io/npm/v/@arizeai/openinference-instrumentation-beeai.svg)](https://www.npmjs.com/package/@arizeai/openinference-instrumentation-beeai) | |

| [Claude Agent SDK](https://arize.com/docs/phoenix/integrations/typescript/claude-agent-sdk) | `@arizeai/openinference-instrumentation-claude-agent-sdk` | [![NPM Version](https://img.shields.io/npm/v/@arizeai%2Fopeninference-instrumentation-claude-agent-sdk.svg)](https://www.npmjs.com/package/@arizeai/openinference-instrumentation-claude-agent-sdk) | |

| [Mastra](https://arize.com/docs/phoenix/integrations/typescript/mastra) | `@mastra/arize` | [![NPM Version](https://img.shields.io/npm/v/@mastra/arize.svg)](https://www.npmjs.com/package/@mastra/arize) | |

| [MCP](https://arize.com/docs/phoenix/integrations/typescript/mcp) | `@arizeai/openinference-instrumentation-mcp` | [![NPM Version](https://img.shields.io/npm/v/@arizeai%2Fopeninference-instrumentation-mcp.svg)](https://www.npmjs.com/package/@arizeai/openinference-instrumentation-mcp) | | | [TypeSafe AI](https://arize.com/docs/phoenix/integrations/llm-providers/typesafe/typesafe-typescript) | `@arizeai/openinference-instrumentation-typesafe` | [![NPM Version](https://img.shields.io/npm/v/@arizeai%2Fopeninference-instrumentation-typesafe.svg)](https://www.npmjs.com/package/@arizeai/openinference-instrumentation-typesafe) | ### Java 통합 | | 통합 | 패키지 | 버전 | | :-------------------------------------------------------------------------------------------------: | --------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | |

| [LangChain4j](https://github.com/Arize-ai/openinference/tree/main/java/instrumentation/openinference-instrumentation-langchain4j) | `openinference-instrumentation-langchain4j` | [![Maven Central](https://img.shields.io/maven-central/v/com.arize/openinference-instrumentation-langchain4j.svg)](https://central.sonatype.com/artifact/com.arize/openinference-instrumentation-langchain4j) | | | SpringAI | `openinference-instrumentation-springAI` | [![Maven Central](https://img.shields.io/maven-central/v/com.arize/openinference-instrumentation-springAI.svg)](https://central.sonatype.com/artifact/com.arize/openinference-instrumentation-springAI) | |

| Spring AI용 [Arconia](https://docs.arconia.io/arconia/latest/observability/semantic-conventions/openinference/) | `io.arconia:arconia-openinference-semantic-conventions` | [![Maven Central](https://img.shields.io/maven-central/v/io.arconia/arconia-openinference-ai-semantic-conventions.svg)](https://central.sonatype.com/artifact/io.arconia/arconia-openinference-ai-semantic-conventions) | |

| [Google ADK](https://arize.com/docs/phoenix/integrations/java/google-adk/google-adk-tracing) | `openinference-instrumentation-adk-java` | [![Maven Central](https://img.shields.io/maven-central/v/com.arize/openinference-instrumentation-adk-java.svg)](https://central.sonatype.com/artifact/com.arize/openinference-instrumentation-adk-java) | ### Go 통합 | | 통합 | 패키지 | 버전 | | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | ------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | |

| [OpenAI](https://github.com/Arize-ai/openinference/tree/main/go/openinference-instrumentation-openai-go) | `github.com/Arize-ai/openinference/go/openinference-instrumentation-openai-go` | [![Go Reference](https://pkg.go.dev/badge/github.com/Arize-ai/openinference/go/openinference-instrumentation-openai-go.svg)](https://pkg.go.dev/github.com/Arize-ai/openinference/go/openinference-instrumentation-openai-go) | |

| [Anthropic](https://github.com/Arize-ai/openinference/tree/main/go/openinference-instrumentation-anthropic-sdk-go) | `github.com/Arize-ai/openinference/go/openinference-instrumentation-anthropic-sdk-go` | [![Go Reference](https://pkg.go.dev/badge/github.com/Arize-ai/openinference/go/openinference-instrumentation-anthropic-sdk-go.svg)](https://pkg.go.dev/github.com/Arize-ai/openinference/go/openinference-instrumentation-anthropic-sdk-go) | ### 플랫폼 | | 플랫폼 | 설명 | 문서 | | :----------------------------------------------------------------------------------------------: | -------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | | | [BeeAI](https://docs.beeai.dev/observability/agents-traceability) | 관측성 기능이 내장된 AI 에이전트 프레임워크 | [Integration Guide](https://docs.beeai.dev/observability/agents-traceability) | |

| [Dify](https://docs.dify.ai/en/guides/monitoring/integrate-external-ops-tools/integrate-phoenix) | 오픈소스 LLM 앱 개발 플랫폼 | [Integration Guide](https://docs.dify.ai/en/guides/monitoring/integrate-external-ops-tools/integrate-phoenix) | | | [Envoy AI Gateway](https://github.com/envoyproxy/ai-gateway) | AI 워크로드를 위해 Envoy Proxy 기반으로 구축된 AI 게이트웨이 | [Integration Guide](https://github.com/envoyproxy/ai-gateway/tree/main/cmd/aigw#opentelemetry-setup-with-phoenix) | | | [LangFlow](https://arize.com/docs/phoenix/tracing/integrations-tracing/langflow) | 멀티 에이전트 및 RAG 애플리케이션 구축을 위한 비주얼 프레임워크 | [Integration Guide](https://arize.com/docs/phoenix/tracing/integrations-tracing/langflow) | | | [LiteLLM Proxy](https://docs.litellm.ai/docs/observability/phoenix_integration#using-with-litellm-proxy) | LLM용 프록시 서버 | [Integration Guide](https://docs.litellm.ai/docs/observability/phoenix_integration#using-with-litellm-proxy) | | | [Flowise](https://arize.com/docs/phoenix/integrations/platforms/flowise) | LLM 애플리케이션 구축을 위한 비주얼 프레임워크 | [Integration Guide](https://arize.com/docs/phoenix/integrations/platforms/flowise) | | | [Prompt Flow](https://arize.com/docs/phoenix/integrations/platforms/prompt-flow) | Microsoft의 프롬프트 플로 오케스트레이션 도구 | [Integration Guide](https://arize.com/docs/phoenix/integrations/platforms/prompt-flow) | |

| [NVIDIA NeMo](https://arize.com/docs/phoenix/integrations/python/nvidia) | 엔터프라이즈 에이전트를 위한 NVIDIA NeMo Agent Toolkit | [Integration Guide](https://arize.com/docs/phoenix/integrations/python/nvidia) | | | [Graphite](https://arize.com/docs/phoenix/integrations/python/graphite) | 비주얼 빌더를 갖춘 멀티 에이전트 LLM 워크플로 프레임워크 | [Integration Guide](https://arize.com/docs/phoenix/integrations/python/graphite) | ### 벡터 데이터베이스 | 통합 | 설명 | 문서 | | ----------------------------------------------------------------------------------- | ---------------------------------------------------- | --------------------------------------------------------------------------------------- | | [Qdrant](https://arize.com/docs/phoenix/integrations/vector-databases/qdrant) | dense, sparse, RRF를 활용한 단계적 하이브리드 검색 트레이싱 | [Integration Guide](https://arize.com/docs/phoenix/integrations/vector-databases/qdrant) | ## 샌드박스 호스팅형 샌드박스 제공업체에서 Phoenix [코드 평가기](https://arize.com/docs/phoenix/evaluation/server-evals/code-evaluators)를 실행하여 커널 수준의 격리와 런타임 의존성 설치를 활용할 수 있습니다. | 통합 | 설명 | 문서 | | --------------------------------------------------------------------------------- | ---------------------------------------------------------------- | ---------------------------------------------------------------------------------- | | [E2B](https://arize.com/docs/phoenix/integrations/sandboxes/e2b) | AI가 생성한 코드를 위한 호스팅형 마이크로 VM 샌드박스 | [Integration Guide](https://arize.com/docs/phoenix/integrations/sandboxes/e2b) | | [Daytona](https://arize.com/docs/phoenix/integrations/sandboxes/daytona) | 스냅샷 기반 시작을 지원하는 관리형 개발 샌드박스 | [Integration Guide](https://arize.com/docs/phoenix/integrations/sandboxes/daytona) | | [Vercel Sandbox](https://arize.com/docs/phoenix/integrations/sandboxes/vercel) | Vercel 인프라에서 실행되는 임시(ephemeral) 컴퓨팅 | [Integration Guide](https://arize.com/docs/phoenix/integrations/sandboxes/vercel) | | [Modal](https://arize.com/docs/phoenix/integrations/sandboxes/modal) | 서버리스, Python 중심 컨테이너 플랫폼 | [Integration Guide](https://arize.com/docs/phoenix/integrations/sandboxes/modal) | | [Docker Sandboxes](https://arize.com/docs/phoenix/integrations/sandboxes/docker) | Docker가 호스팅하는 클라우드 샌드박스 | [Integration Guide](https://arize.com/docs/phoenix/integrations/sandboxes/docker) | ## 사람과 코딩 에이전트를 위한 기능 Phoenix는 사람과 AI 코딩 에이전트 모두가 똑같이 활용할 수 있도록 만들어졌습니다. 다음 세 가지 인터페이스를 통해 에이전트(Claude Code, Codex, Cursor 등)가 트레이스, 데이터셋, 실험을 다룰 수 있습니다: - **[CLI](https://arize.com/docs/phoenix/sdk-api-reference/typescript/arizeai-phoenix-cli)** — `npx @arizeai/phoenix-cli`는 트레이스, 데이터셋, 실험을 가져오고 앱을 계측(`setup`)하므로, 에이전트가 터미널에서 컨텍스트를 가져와 이를 바탕으로 작업할 수 있습니다. - **[스킬](https://docs.anthropic.com/en/docs/claude-code/skills)** — [`skills/`](../../skills/)는 Phoenix로 디버깅, 평가, 트레이싱하는 방법을 에이전트에게 알려 주는 워크플로를 패키지로 제공합니다. - **[원격 MCP 서버](https://arize.com/docs/phoenix/integrations/mcp#remote-mcp-server)** — 모든 MCP 클라이언트를 인스턴스의 `/mcp` 엔드포인트에 연결하여 Phoenix를 직접 조회할 수 있습니다. 설정 및 사용 방법은 [코딩 에이전트 문서](https://arize.com/docs/phoenix/integrations/developer-tools/coding-agents)를 참고하세요. | 스킬 | 설명 | | -------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- | | [phoenix-cli](../../skills/phoenix-cli/) | Phoenix CLI를 사용하여 LLM 애플리케이션을 디버깅합니다 — 트레이스 가져오기, 오류 분석, 실험 검토, GraphQL API 조회 | | [phoenix-evals](../../skills/phoenix-evals/) | Phoenix를 사용하여 AI/LLM 애플리케이션용 평가기를 구축하고 실행합니다 | | [phoenix-tracing](../../skills/phoenix-tracing/) | LLM 애플리케이션 트레이싱을 위한 OpenInference 시맨틱 컨벤션 및 계측 | ## 보안 및 개인정보 보호 저희는 데이터 보안과 개인정보 보호를 매우 중요하게 생각합니다. 자세한 내용은 [보안 및 개인정보 보호 문서](https://arize.com/docs/phoenix/self-hosting/security/privacy)를 참고하세요. ### 텔레메트리 기본적으로 Phoenix는 Phoenix의 사용 방식을 파악하고 제품을 개선하기 위해 기본적인 웹 분석 데이터(예: 페이지 조회, UI 상호작용)를 수집합니다. **트레이스 데이터, 평가 결과 및 기타 민감한 정보는 절대 수집하지 않습니다.** 다음 환경 변수를 설정하여 텔레메트리를 비활성화할 수 있습니다: `PHOENIX_TELEMETRY_ENABLED=false` ## 커뮤니티 커뮤니티에 참여하여 수천 명의 AI 빌더와 교류하세요. - 🌍 [Slack 커뮤니티](https://join.slack.com/t/arize-ai/shared_invite/zt-3r07iavnk-ammtATWSlF0pSrd1DsMW7g)에 참여하세요. - 📚 [문서](https://arize.com/docs/phoenix)를 읽어 보세요. - 💡 _#phoenix-support_ 채널에서 질문하고 피드백을 남겨 주세요. - 🌟 [GitHub](https://github.com/Arize-ai/phoenix)에 스타를 남겨 주세요. - 🐞 [GitHub Issues](https://github.com/Arize-ai/phoenix/issues)로 버그를 제보해 주세요. - 𝕏 [𝕏](https://twitter.com/ArizePhoenix)에서 팔로우하세요. - 💼 [LinkedIn](https://www.linkedin.com/showcase/113218220)에서 팔로우하세요. - 🗺️ [로드맵](https://github.com/orgs/Arize-ai/projects/45)에서 앞으로의 계획을 확인하세요. - 🧑‍🏫 Arize 학습 허브에서 [에이전트](http://arize.com/ai-agents/)와 [LLM 평가](https://arize.com/llm-evaluation)에 관한 모든 것을 깊이 있게 알아보세요. ## 호환성이 깨지는 변경 사항 호환성이 깨지는 변경 사항 목록은 [마이그레이션 가이드](../../MIGRATION.md)를 참고하세요. ## 저작권, 특허 및 라이선스 Copyright 2025 Arize AI, Inc. All Rights Reserved. 이 코드의 일부는 하나 이상의 미국 특허로 보호됩니다. [IP_NOTICE](https://github.com/Arize-ai/phoenix/blob/main/IP_NOTICE)를 참고하세요. 이 소프트웨어는 Elastic License 2.0 (ELv2) 조건에 따라 라이선스가 부여됩니다. [LICENSE](https://github.com/Arize-ai/phoenix/blob/main/LICENSE)를 참고하세요. ## Star History Phoenix is fully open source and built in the open. If it helps you, please [⭐ star the repo](https://github.com/Arize-ai/phoenix) to support the project.