<p align="center">
    <img alt="OpenInference" src="https://raw.githubusercontent.com/Arize-ai/phoenix-assets/main/logos/OpenInference/Full%20color/OI-full-horiz.svg" width="40%" height="100%" />
</p>
<p align="center">
    <a href="../../README.md">🇺🇸 English</a> • <a href="README.zh.md">🇨🇳 中文</a> • <a href="README.zh-TW.md">🇹🇼 繁體中文</a> • <a href="README.ja.md">🇯🇵 日本語</a> • <a href="README.pt-PT.md">🇵🇹 Português</a> • <a href="README.pt-BR.md">🇧🇷 Português</a> • <b>🇰🇷 한국어</b> • <a href="README.es.md">🇪🇸 Español</a> • <a href="README.de.md">🇩🇪 Deutsch</a> • <a href="README.fr.md">🇫🇷 Français</a> • <a href="README.he.md">🇮🇱 עברית</a> • <a href="README.ar.md">🇸🇦 العربية</a> • <a href="README.ru.md">🇷🇺 Русский</a> • <a href="README.pl.md">🇵🇱 Polski</a> • <a href="README.cs.md">🇨🇿 Čeština</a> • <a href="README.nl.md">🇳🇱 Nederlands</a> • <a href="README.tr.md">🇹🇷 Türkçe</a> • <a href="README.uk.md">🇺🇦 Українська</a> • <a href="README.vi.md">🇻🇳 Tiếng Việt</a> • <a href="README.tl.md">🇵🇭 Tagalog</a> • <a href="README.id.md">🇮🇩 Indonesia</a> • <a href="README.th.md">🇹🇭 ไทย</a> • <a href="README.hi.md">🇮🇳 हिन्दी</a> • <a href="README.bn.md">🇧🇩 বাংলা</a> • <a href="README.ur.md">🇵🇰 اردو</a> • <a href="README.ro.md">🇷🇴 Română</a> • <a href="README.sv.md">🇸🇪 Svenska</a> • <a href="README.it.md">🇮🇹 Italiano</a> • <a href="README.el.md">🇬🇷 Ελληνικά</a> • <a href="README.hu.md">🇭🇺 Magyar</a> • <a href="README.fi.md">🇫🇮 Suomi</a> • <a href="README.da.md">🇩🇰 Dansk</a> • <a href="README.no.md">🇳🇴 Norsk</a>
</p>
<p align="center">
    <a href="https://arize-ai.github.io/openinference/spec/">
        <img src="https://img.shields.io/static/v1?message=Spec&logo=data:image/png;base64,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&labelColor=grey&color=blue&logoColor=white&label=%20"/>
    </a>
    <a target="_blank" href="https://join.slack.com/t/arize-ai/shared_invite/zt-1px8dcmlf-fmThhDFD_V_48oU7ALan4Q">
        <img src="https://img.shields.io/static/v1?message=Community&logo=slack&labelColor=grey&color=blue&logoColor=white&label=%20"/>
    </a>
</p>

OpenInference는 AI 애플리케이션의 트레이싱을 가능하게 하는, [OpenTelemetry](https://opentelemetry.io/)를 보완하는
컨벤션과 플러그인의 모음입니다. OpenInference는
[Arize Phoenix](https://github.com/Arize-ai/phoenix)와 [Arize AX](https://arize.com/products/ax?utm_source=docs&utm_medium=web&utm_content=openinference)에서 네이티브로 지원되지만, OpenTelemetry 호환 백엔드라면
어디에서든 사용할 수 있습니다.

## 명세

OpenInference 명세는 [spec 디렉터리](../../spec/)에 있는 마크다운 파일로 작성됩니다. 이 명세는
LLM 호출과 그 주변의 애플리케이션 컨텍스트(예: 벡터 저장소에서의 검색
및 검색 엔진이나 API 같은 외부 도구의 사용)에 대한 인사이트를 제공하도록 설계되었습니다. 명세는 전송 방식과 파일 형식에 구애받지 않으며,
JSON, ProtoBuf, DataFrames 등 다른 명세와 함께 사용하도록 만들어졌습니다.

## 계측

OpenInference는 다양한 언어로 인기 있는 머신러닝 SDK 및 프레임워크를 위한
계측 모음을 제공합니다.

## Python

### 라이브러리

| 패키지 | 설명 | 버전 |
|-------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [`openinference-semantic-conventions`](../../python/openinference-semantic-conventions)                                           | LLM 앱 트레이싱을 위한 시맨틱 컨벤션. | [![PyPI Version](https://img.shields.io/pypi/v/openinference-semantic-conventions.svg)](https://pypi.python.org/pypi/openinference-semantic-conventions)                           |
| [`openinference-instrumentation`](../../python/openinference-instrumentation)                                                     | 계측을 위한 재사용 가능한 유틸리티, 데코레이터, 구성 및 헬퍼. | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation.svg)](https://pypi.python.org/pypi/openinference-instrumentation)                                     |
| [`openinference-instrumentation-agno`](../../python/instrumentation/openinference-instrumentation-agno)                           | Agno Agents용 OpenInference 계측.                                   | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-agno.svg)](https://pypi.python.org/pypi/openinference-instrumentation-agno)                           |
| [`openinference-instrumentation-ag2`](../../python/instrumentation/openinference-instrumentation-ag2)                             | AG2용 OpenInference 계측.                                           | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-ag2.svg)](https://pypi.python.org/pypi/openinference-instrumentation-ag2)                             |
| [`openinference-instrumentation-openai`](../../python/instrumentation/openinference-instrumentation-openai)                       | OpenAI SDK용 OpenInference 계측.                                    | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-openai.svg)](https://pypi.python.org/pypi/openinference-instrumentation-openai)                       |
| [`openinference-instrumentation-openai-agents`](../../python/instrumentation/openinference-instrumentation-openai-agents)         | OpenAI Agents SDK용 OpenInference 계측.                             | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-openai-agents.svg)](https://pypi.python.org/pypi/openinference-instrumentation-openai-agents)         |
| [`openinference-instrumentation-claude-agent-sdk`](../../python/instrumentation/openinference-instrumentation-claude-agent-sdk)   | Claude Agent SDK용 OpenInference 계측.                             | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-claude-agent-sdk.svg)](https://pypi.python.org/pypi/openinference-instrumentation-claude-agent-sdk)         |
| [`openinference-instrumentation-llama-index`](../../python/instrumentation/openinference-instrumentation-llama-index)             | LlamaIndex용 OpenInference 계측.                                    | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-llama-index.svg)](https://pypi.python.org/pypi/openinference-instrumentation-llama-index)             |
| [`openinference-instrumentation-dspy`](../../python/instrumentation/openinference-instrumentation-dspy)                           | DSPy용 OpenInference 계측.                                          | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-dspy.svg)](https://pypi.python.org/pypi/openinference-instrumentation-dspy)                           |
| [`openinference-instrumentation-bedrock`](../../python/instrumentation/openinference-instrumentation-bedrock)                     | AWS Bedrock용 OpenInference 계측.                                   | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-bedrock.svg)](https://pypi.python.org/pypi/openinference-instrumentation-bedrock)                     |
| [`openinference-instrumentation-langchain`](../../python/instrumentation/openinference-instrumentation-langchain)                 | LangChain용 OpenInference 계측.                                     | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-langchain.svg)](https://pypi.python.org/pypi/openinference-instrumentation-langchain)                 |
| [`openinference-instrumentation-mcp`](../../python/instrumentation/openinference-instrumentation-mcp)                             | MCP용 OpenInference 계측.                                           | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-mcp.svg)](https://pypi.python.org/pypi/openinference-instrumentation-mcp)                             |
| [`openinference-instrumentation-mistralai`](../../python/instrumentation/openinference-instrumentation-mistralai)                 | MistralAI용 OpenInference 계측.                                     | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-mistralai.svg)](https://pypi.python.org/pypi/openinference-instrumentation-mistralai)                 |
| [`openinference-instrumentation-portkey`](../../python/instrumentation/openinference-instrumentation-portkey)                     | Portkey용 OpenInference 계측.                                       | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-portkey.svg)](https://pypi.python.org/pypi/openinference-instrumentation-portkey)                     |
| [`openinference-instrumentation-guardrails`](../../python/instrumentation/openinference-instrumentation-guardrails)               | Guardrails용 OpenInference 계측.                                    | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-guardrails.svg)](https://pypi.python.org/pypi/openinference-instrumentation-guardrails)               |
| [`openinference-instrumentation-vertexai`](../../python/instrumentation/openinference-instrumentation-vertexai)                   | VertexAI용 OpenInference 계측.                                      | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-vertexai.svg)](https://pypi.python.org/pypi/openinference-instrumentation-vertexai)                   |
| [`openinference-instrumentation-crewai`](../../python/instrumentation/openinference-instrumentation-crewai)                       | CrewAI용 OpenInference 계측.                                        | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-crewai.svg)](https://pypi.python.org/pypi/openinference-instrumentation-crewai)                       |
| [`openinference-instrumentation-haystack`](../../python/instrumentation/openinference-instrumentation-haystack)                   | Haystack용 OpenInference 계측.                                      | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-haystack.svg)](https://pypi.python.org/pypi/openinference-instrumentation-haystack)                   |
| [`openinference-instrumentation-litellm`](../../python/instrumentation/openinference-instrumentation-litellm)                     | liteLLM용 OpenInference 계측.                                       | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-litellm.svg)](https://pypi.python.org/pypi/openinference-instrumentation-litellm)                     |
| [`openinference-instrumentation-groq`](../../python/instrumentation/openinference-instrumentation-groq)                           | Groq용 OpenInference 계측.                                          | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-groq.svg)](https://pypi.python.org/pypi/openinference-instrumentation-groq)                           |
| [`openinference-instrumentation-instructor`](../../python/instrumentation/openinference-instrumentation-instructor)               | Instructor용 OpenInference 계측.                                    | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-instructor.svg)](https://pypi.python.org/pypi/openinference-instrumentation-instructor)               |
| [`openinference-instrumentation-anthropic`](../../python/instrumentation/openinference-instrumentation-anthropic)                 | Anthropic용 OpenInference 계측.                                     | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-anthropic.svg)](https://pypi.python.org/pypi/openinference-instrumentation-anthropic)                 |
| [`openinference-instrumentation-beeai`](../../python/instrumentation/openinference-instrumentation-beeai)                         | BeeAI용 OpenInference 계측.                                         | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-beeai.svg)](https://pypi.python.org/pypi/openinference-instrumentation-beeai)                         |
| [`openinference-instrumentation-google-genai`](../../python/instrumentation/openinference-instrumentation-google-genai)           | Google GenAI용 OpenInference 계측.                                  | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-google-genai.svg)](https://pypi.python.org/pypi/openinference-instrumentation-google-genai)           |
| [`openinference-instrumentation-google-adk`](../../python/instrumentation/openinference-instrumentation-google-adk)               | Google ADK용 OpenInference 계측.                                    | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-google-adk.svg)](https://pypi.python.org/pypi/openinference-instrumentation-google-adk)               |
| [`openinference-instrumentation-autogen-agentchat`](../../python/instrumentation/openinference-instrumentation-autogen-agentchat) | Microsoft Autogen AgentChat용 OpenInference 계측. | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-autogen-agentchat.svg)](https://pypi.python.org/pypi/openinference-instrumentation-autogen-agentchat) |
| [`openinference-instrumentation-pydantic-ai`](../../python/instrumentation/openinference-instrumentation-pydantic-ai)             | PydanticAI용 OpenInference 계측.                                    | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-pydantic-ai.svg)](https://pypi.python.org/pypi/openinference-instrumentation-pydantic-ai)             |
| [`openinference-instrumentation-smolagents`](../../python/instrumentation/openinference-instrumentation-smolagents)               | smolagents용 OpenInference 계측.                                    | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-smolagents.svg)](https://pypi.python.org/pypi/openinference-instrumentation-smolagents)               |
| [`openinference-instrumentation-pipecat`](../../python/instrumentation/openinference-instrumentation-pipecat)                     | Pipecat용 OpenInference 계측.                                       | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-pipecat.svg)](https://pypi.python.org/pypi/openinference-instrumentation-pipecat)                     |
| [`openinference-instrumentation-agentspec`](../../python/instrumentation/openinference-instrumentation-agentspec)                 | Open Agent Specification용 OpenInference 계측.                      | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-agentspec.svg)](https://pypi.python.org/pypi/openinference-instrumentation-agentspec)                 |
| [`openinference-instrumentation-strands-agents`](../../python/instrumentation/openinference-instrumentation-strands-agents)       | Strands Agents용 OpenInference 계측.                                | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-strands-agents.svg)](https://pypi.python.org/pypi/openinference-instrumentation-strands-agents)       |
| [`openinference-instrumentation-together`](../../python/instrumentation/openinference-instrumentation-together)                   | Together AI용 OpenInference 계측.                                   | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-together.svg)](https://pypi.python.org/pypi/openinference-instrumentation-together)                   |
| [`openinference-instrumentation-typesafe`](../../python/instrumentation/openinference-instrumentation-typesafe)                   | TypeSafe AI용 OpenInference 계측.                                   | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-typesafe.svg)](https://pypi.python.org/pypi/openinference-instrumentation-typesafe)                   |
| [`openinference-instrumentation-ollama`](../../python/instrumentation/openinference-instrumentation-ollama)                       | Ollama용 OpenInference 계측.                                        | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-ollama.svg)](https://pypi.python.org/pypi/openinference-instrumentation-ollama)                       |
| [`openinference-instrumentation-cohere`](../../python/instrumentation/openinference-instrumentation-cohere)                       | Cohere용 OpenInference 계측.                                        | [![PyPI Version](https://img.shields.io/pypi/v/openinference-instrumentation-cohere.svg)](https://pypi.python.org/pypi/openinference-instrumentation-cohere)                       |

## 스팬 프로세서

데이터를 통일하는 스팬 프로세서를 추가하여 다른 계측 라이브러리의 데이터를 정규화하고 변환합니다.

| 패키지 | 설명 | 버전 |
| ----------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [`openinference-instrumentation-openlit`](../../python/instrumentation/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`](../../python/instrumentation/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) |

### 예제

| 이름 | 설명 | 난이도 |
| ----------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- | ---------------- |
| [Agno](../../python/instrumentation/openinference-instrumentation-agno/examples/)                           | Agno 에이전트 예제 | 초급 |
| [OpenAI SDK](../../python/instrumentation/openinference-instrumentation-openai/examples/)                   | 채팅 완성 및 임베딩을 포함한 OpenAI Python SDK | 초급 |
| [Claude Agent SDK](../../python/instrumentation/openinference-instrumentation-claude-agent-sdk/examples/)   | Claude Agent SDK                                                                             | 초급         |
| [MistralAI SDK](../../python/instrumentation/openinference-instrumentation-mistralai/examples/)             | MistralAI Python SDK                                                                         | 초급         |
| [VertexAI SDK](../../python/instrumentation/openinference-instrumentation-vertexai/examples/)               | VertexAI Python SDK                                                                          | 초급         |
| [LlamaIndex](../../python/instrumentation/openinference-instrumentation-llama-index/examples/)              | LlamaIndex 쿼리 엔진 | 초급 |
| [DSPy](../../python/instrumentation/openinference-instrumentation-dspy/examples/)                           | DSPy 프리미티브 및 사용자 정의 RAG 모듈 | 초급 |
| [Boto3 Bedrock Client](../../python/instrumentation/openinference-instrumentation-bedrock/examples/)        | Boto3 Bedrock 클라이언트 | 초급 |
| [LangChain](../../python/instrumentation/openinference-instrumentation-langchain/examples/)                 | LangChain 프리미티브 및 간단한 체인 | 초급 |
| [LiteLLM](../../python/instrumentation/openinference-instrumentation-litellm/)                              | 경량 LiteLLM 프레임워크 | 초급 |
| [LiteLLM Proxy](../../python/instrumentation/openinference-instrumentation-litellm/examples/litellm-proxy/) | OpenAI, Azure, Vertex, Bedrock 호출을 로깅하는 LiteLLM Proxy | 초급 |
| [Groq](../../python/instrumentation/openinference-instrumentation-groq/examples/)                           | Groq 및 AsyncGroq 채팅 완성 | 초급 |
| [Together AI](../../python/instrumentation/openinference-instrumentation-together/examples/)                | Together 및 AsyncTogether 채팅 완성, 스트리밍, 도구 호출 | 초급 |
| [TypeSafe AI](../../python/instrumentation/openinference-instrumentation-typesafe/examples/)                | TypeSafeClient 및 AsyncTypeSafeClient System One 호출(Noul, Choice, Score) | 초급 |
| [Anthropic](../../python/instrumentation/openinference-instrumentation-anthropic/examples/)                 | Anthropic Messages 클라이언트 | 초급 |
| [BeeAI](../../python/instrumentation/openinference-instrumentation-beeai/examples/)                         | BeeAI 프레임워크의 에이전트 계측 | 초급 |
| [Haystack](../../python/instrumentation/openinference-instrumentation-haystack/examples/)                   | Haystack QA RAG 애플리케이션 | 중급 |
| [OpenAI Agents](../../python/instrumentation/openinference-instrumentation-openai-agents/examples/)         | 핸드오프를 사용하는 OpenAI Agents | 중급 |
| [Autogen AgentChat](../../python/instrumentation/openinference-instrumentation-autogen-agentchat/examples/) | Microsoft Autogen Assistant Agent 및 Team Chat | 중급 |
| [AG2](../../python/instrumentation/openinference-instrumentation-ag2/examples/)                             | AG2 도구 호출, 그룹 채팅 및 순차 채팅 | 중급 |
| [PydanticAI](../../python/instrumentation/openinference-instrumentation-pydantic-ai/examples/)              | PydanticAI 에이전트 예제 | 중급 |
| [Pipecat](../../python/instrumentation/openinference-instrumentation-pipecat/examples/)                     | Pipecat 애플리케이션 예제 | 중급 |
| [Ollama](../../python/instrumentation/openinference-instrumentation-ollama/examples/)                       | Ollama 채팅, 스트리밍, 도구 호출 | 초급 |
| [Cohere](../../python/instrumentation/openinference-instrumentation-cohere/examples/)                       | Cohere ClientV2 채팅 완성 | 초급 |

## JavaScript

 <a href="https://arize-ai.github.io/openinference/js/">
        <img src="https://img.shields.io/static/v1?message=JavaScript%20Documentation&logo=data:image/png;base64,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&labelColor=grey&color=blue&logoColor=white&label=%20"/>
    </a>

### 라이브러리

| 패키지 | 설명 | 버전 |
| ----------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [`@arizeai/openinference-semantic-conventions`](../../js/packages/openinference-semantic-conventions)                                   | LLM 앱 트레이싱을 위한 시맨틱 컨벤션. | [![NPM Version](https://img.shields.io/npm/v/@arizeai/openinference-semantic-conventions.svg)](https://www.npmjs.com/package/@arizeai/openinference-semantic-conventions)                               |
| [`@arizeai/openinference-core`](../../js/packages/openinference-core)                                                                   | 계측을 위한 재사용 가능한 유틸리티, 구성 및 헬퍼. | [![NPM Version](https://img.shields.io/npm/v/@arizeai/openinference-core.svg)](https://www.npmjs.com/package/@arizeai/openinference-core)                                                               |
| [`@arizeai/openinference-instrumentation-bedrock`](../../js/packages/openinference-instrumentation-bedrock)                             | AWS Bedrock용 OpenInference 계측.                      | [![NPM Version](https://img.shields.io/npm/v/@arizeai/openinference-instrumentation-bedrock)](https://www.npmjs.com/package/@arizeai/openinference-instrumentation-bedrock)                             |
| [`@arizeai/openinference-instrumentation-bedrock-agent-runtime`](../../js/packages/openinference-instrumentation-bedrock-agent-runtime) | AWS Bedrock Agent Runtime용 OpenInference 계측.        | [![NPM Version](https://img.shields.io/npm/v/@arizeai/openinference-instrumentation-bedrock-agent-runtime)](https://www.npmjs.com/package/@arizeai/openinference-instrumentation-bedrock-agent-runtime) |
| [`@arizeai/openinference-instrumentation-beeai`](../../js/packages/openinference-instrumentation-beeai)                                 | BeeAI용 OpenInference 계측.                            | [![NPM Version](https://img.shields.io/npm/v/@arizeai/openinference-instrumentation-beeai)](https://www.npmjs.com/package/@arizeai/openinference-instrumentation-beeai)                                 |
| [`@arizeai/openinference-instrumentation-langchain`](../../js/packages/openinference-instrumentation-langchain)                         | LangChain.js용 OpenInference 계측.                     | [![NPM Version](https://img.shields.io/npm/v/@arizeai/openinference-instrumentation-langchain)](https://www.npmjs.com/package/@arizeai/openinference-instrumentation-langchain)                         |
| [`@arizeai/openinference-instrumentation-mcp`](../../js/packages/openinference-instrumentation-mcp)                                     | MCP용 OpenInference 계측.                              | [![NPM Version](https://img.shields.io/npm/v/@arizeai/openinference-instrumentation-mcp)](https://www.npmjs.com/package/@arizeai/openinference-instrumentation-mcp)                                     |
| [`@arizeai/openinference-instrumentation-openai`](../../js/packages/openinference-instrumentation-openai)                               | OpenAI SDK용 OpenInference 계측.                       | [![NPM Version](https://img.shields.io/npm/v/@arizeai/openinference-instrumentation-openai)](https://www.npmjs.com/package/@arizeai/openinference-instrumentation-openai)                               |
| [`@arizeai/openinference-instrumentation-anthropic`](../../js/packages/openinference-instrumentation-anthropic)                         | Anthropic SDK용 OpenInference 계측.                | [![NPM Version](https://img.shields.io/npm/v/@arizeai/openinference-instrumentation-anthropic)](https://www.npmjs.com/package/@arizeai/openinference-instrumentation-anthropic)                         |
| [`@arizeai/openinference-instrumentation-claude-agent-sdk`](../../js/packages/openinference-instrumentation-claude-agent-sdk)           | Claude Agent SDK용 OpenInference 계측.                 | [![NPM Version](https://img.shields.io/npm/v/@arizeai/openinference-instrumentation-claude-agent-sdk)](https://www.npmjs.com/package/@arizeai/openinference-instrumentation-claude-agent-sdk)           |
| [`@arizeai/openinference-vercel`](../../js/packages/openinference-vercel)                                                               | Vercel AI SDK를 위한 OpenInference 지원. | [![NPM Version](https://img.shields.io/npm/v/@arizeai/openinference-vercel)](https://www.npmjs.com/package/@arizeai/openinference-vercel)                                                               |
| [`@arizeai/openinference-tanstack-ai`](../../js/packages/openinference-tanstack-ai)                                                     | TanStack AI용 OpenInference 미들웨어. | [![NPM Version](https://img.shields.io/npm/v/@arizeai/openinference-tanstack-ai)](https://www.npmjs.com/package/@arizeai/openinference-tanstack-ai)                                                     |
| [`@arizeai/openinference-genai`](../../js/packages/openinference-genai)                                                                 | GenAI 컨벤션을 위한 OpenInference 지원 | [![NPM Version](https://img.shields.io/npm/v/@arizeai/openinference-genai)](https://www.npmjs.com/package/@arizeai/openinference-genai)                                                                 |
| [`@arizeai/openinference-instrumentation-typesafe`](../../js/packages/openinference-instrumentation-typesafe) | TypeSafe AI SDK용 OpenInference 계측. | [![NPM Version](https://img.shields.io/npm/v/@arizeai/openinference-instrumentation-typesafe)](https://www.npmjs.com/package/@arizeai/openinference-instrumentation-typesafe) |

### 예제

| 이름 | 설명 | 난이도 |
| --- | --- | --- |
| [TypeSafe AI](../../js/packages/openinference-instrumentation-typesafe/examples/) | 분류, 구조화된 질문, 신뢰도 기반 LLM 라우팅 | 초급 |

## Java

### 라이브러리

| 패키지 | 설명 | 버전 |
| --------------------------------------------------------------------------------------------------------------- | ---------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [`openinference-semantic-conventions`](../../java/openinference-semantic-conventions)                               | LLM 앱 트레이싱을 위한 시맨틱 컨벤션. | [![Maven Central Version](https://img.shields.io/maven-central/v/com.arize/openinference-semantic-conventions)](https://central.sonatype.com/artifact/com.arize/openinference-semantic-conventions)               |
| [`openinference-instrumentation`](../../java/openinference-instrumentation)                                         | 기본 계측 유틸리티. | [![Maven Central Version](https://img.shields.io/maven-central/v/com.arize/openinference-instrumentation)](https://central.sonatype.com/artifact/com.arize/openinference-instrumentation)                         |
| [`openinference-instrumentation-langchain4j`](../../java/instrumentation/openinference-instrumentation-langchain4j) | LangChain4j용 OpenInference 계측. | [![Maven Central Version](https://img.shields.io/maven-central/v/com.arize/openinference-instrumentation-langchain4j)](https://central.sonatype.com/artifact/com.arize/openinference-instrumentation-langchain4j) |
| [`openinference-instrumentation-springAI`](../../java/instrumentation/openinference-instrumentation-springAI)       | Spring AI용 OpenInference 계측.   | [![Maven Central Version](https://img.shields.io/maven-central/v/com.arize/openinference-instrumentation-springAI)](https://central.sonatype.com/artifact/com.arize/openinference-instrumentation-springAI)       |
| [`openinference-instrumentation-annotation`](../../java/instrumentation/openinference-instrumentation-annotation) | ByteBuddy를 사용한 어노테이션 기반 수동 트레이싱. | [![Maven Central Version](https://img.shields.io/maven-central/v/com.arize/openinference-instrumentation-annotation)](https://central.sonatype.com/artifact/com.arize/openinference-instrumentation-annotation) |
| [`openinference-instrumentation-adk-java`](../../java/instrumentation/openinference-instrumentation-adk-java) | Google ADK Java (`-javaagent`)용 OpenInference 계측. | [![Maven Central Version](https://img.shields.io/maven-central/v/com.arize/openinference-instrumentation-adk-java)](https://central.sonatype.com/artifact/com.arize/openinference-instrumentation-adk-java) |

### 예제

| 이름 | 설명 | 난이도 |
| -------------------------------------------------------- | ---------------------------------------------- | ---------------- |
| [LangChain4j 예제](../../java/examples/langchain4j-example) | OpenAI와 함께 LangChain4j를 사용하는 간단한 예제 | 초급 |
| [Spring AI 예제](../../java/examples/spring-ai-example) | OpenAI 및 도구 호출을 사용하는 Spring AI 예제 | 초급 |
| [어노테이션 예제](../../java/examples/annotation-example) | `@Chain`, `@LLM`, `@Tool`, `@Agent`를 사용한 어노테이션 기반 트레이싱 | 초급 |
| [프로그래밍 방식 예제](../../java/examples/programmatic-example) | 타입이 지정된 스팬 클래스(`LLMSpan`, `AgentSpan` 등)를 사용한 수동 트레이싱 | 초급 |
| [ADK Java 예제](../../java/examples/adk-java-example) | ADK `-javaagent`로 트레이싱되며 함수 도구를 갖춘 Google ADK for Java 에이전트 | 초급 |

## Go

### 라이브러리

| 패키지 | 설명 | 버전 |
| --- | --- | --- |
| [`openinference-semantic-conventions`](../../go/openinference-semantic-conventions) | LLM 앱 트레이싱을 위한 시맨틱 컨벤션. | `go get github.com/Arize-ai/openinference/go/openinference-semantic-conventions` |
| [`openinference-instrumentation`](../../go/openinference-instrumentation) | 억제(suppression), 컨텍스트 속성 전파 및 `TraceConfig` 마스킹. `OPENINFERENCE_HIDE_*` 환경 변수를 따릅니다. | `go get github.com/Arize-ai/openinference/go/openinference-instrumentation` |
| [`openinference-instrumentation-anthropic-sdk-go`](../../go/openinference-instrumentation-anthropic-sdk-go) | Anthropic Go SDK (`anthropics/anthropic-sdk-go`)용 OpenInference 계측. | `go get github.com/Arize-ai/openinference/go/openinference-instrumentation-anthropic-sdk-go` |
| [`openinference-instrumentation-openai-go`](../../go/openinference-instrumentation-openai-go) | 공식 OpenAI Go SDK([`openai/openai-go`](https://github.com/openai/openai-go))용 OpenInference 계측. | `go get github.com/Arize-ai/openinference/go/openinference-instrumentation-openai-go` |

Go 1.25 이상이 필요합니다. [Arize AX](https://arize.com/products/ax?utm_source=docs&utm_medium=web&utm_content=openinference)로의 한 줄 OTLP/HTTP 설정을 위해 [`arize-otel-go`](https://github.com/Arize-ai/arize-otel-go)와 함께 사용하거나, 원하는 OTel 익스포터를 연결하세요(예: `http://localhost:6006/v1/traces`의 [Phoenix](https://github.com/Arize-ai/phoenix)).

## 지원되는 대상

OpenInference는 다음 대상을 스팬 수집기로 지원합니다.

- ✅ [Arize Phoenix](https://github.com/Arize-ai/phoenix)
- ✅ [Arize AX](https://arize.com/products/ax?utm_source=docs&utm_medium=web&utm_content=openinference)
- ✅ 모든 OTEL 호환 수집기

## 커뮤니티

커뮤니티에 참여하여 수천 명의 머신러닝 실무자 및 LLM 관측성 애호가와 교류하세요!

- 🌍 [Slack 커뮤니티](https://join.slack.com/t/arize-ai/shared_invite/zt-3lqwr2oc3-7rhdyYEh82zJL_UhPKrb0A)에 참여하세요.
- 💡 _#phoenix-support_ 채널에서 질문하고 피드백을 남겨 주세요.
- 🌟 [GitHub](https://github.com/Arize-ai/openinference)에 스타를 남겨 주세요.
- 🐞 [GitHub Issues](https://github.com/Arize-ai/openinference/issues)로 버그를 제보해 주세요.
- 𝕏 [X](https://twitter.com/ArizePhoenix)에서 팔로우하세요.
- 🗺️ [로드맵](https://github.com/orgs/Arize-ai/projects/45)에서 앞으로의 계획을 확인하세요.
