OpenInference 추적을 에이전트 분석으로 전송
Agno, smolagents, DSPy, Haystack, Google GenAI SDK 및 AutoGen AgentChat은 OpenInference 스팬을 방출합니다. 해당 내보내기 도구를 Amplitude로 가리키십시오. 에이전트 프로세스에서 Amplitude AI SDK는 필요하지 않습니다.
이 페이지에서는 agno 3.1.11, smolagents 1.26.0, dspy 3.4.1, haystack-ai 3.4.1, google-genai 2.33.0 및 autogen-agentchat 0.7.5에 대해 설명합니다. Amplitude는 내보낸 스팬을 저장합니다. 개인 데이터가 인프라를 벗어나기 전에 데이터 스크러빙을 수행하십시오. 에이전트 분석 개인정보 보호 모드를 참조하십시오.
사용 중인 AI 코딩 에이전트로 설정(권장)
이 프롬프트를 Cursor, Claude Code, Windsurf, GitHub Copilot 또는 Codex와 같은 AI 코딩 에이전트에 붙여넣으십시오.
Connect this OpenInference agent to Amplitude Agent Analytics with native OpenTelemetry.
Fetch https://raw.githubusercontent.com/amplitude/Amplitude-AI-Node/main/docs/integrations/openinference.md
and follow "Part 2: Coding agent procedure".
If @amplitude/ai is installed, the same file is under node_modules/@amplitude/ai/docs/integrations/.
Also follow https://raw.githubusercontent.com/amplitude/Amplitude-AI-Node/main/docs/integrations/privacy.md
and scrub content before export.
Follow links in the guide. If your source isn't listed, start at https://raw.githubusercontent.com/amplitude/Amplitude-AI-Node/main/docs/integrations/README.md
변경 사항을 검토한 다음 시작하기 단계에 따라 확인하십시오.
이것이 여러분에게 의미하는 바
- 실행 내용: 해당 프레임워크용 OpenInference 인스트루멘터가 Amplitude를 가리키도록 설정된 에이전트 프로세스를 실행합니다.
- 필요한 사항은(는) 위에 고정된 패키지, 일치하는
openinference-instrumentation-*패키지, Amplitude 프로젝트 API 키, 그리고user.id,session.id및gen_ai.agent.id을(를) 설정하는 스팬 프로세서입니다. - 프로토콜: HTTP 기반 OTLP. Amplitude는 protobuf 및 JSON을 허용합니다. Amplitude는 gRPC를 허용하지 않습니다. OTLP 로그를 전송하지 마십시오.
- 개인정보 보호: Amplitude는 콘텐츠 수신 후 데이터를 삭제하지 않습니다. 내보내기 전에 콘텐츠 속성을 마스킹하거나 삭제하십시오.
내보내기
에이전트 프로세스에서 이러한 변수를 설정합니다. 헤더 값이 환경 변수에 있는 경우, 헤더 값의 스페이스를 %20으(로) 인코딩하십시오. Authorization=은(는) 기록된 대로 둡니다.
OTEL_EXPORTER_OTLP_TRACES_ENDPOINT=https://api.amplitude.com/otlp/v1/traces
OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf
OTEL_EXPORTER_OTLP_HEADERS="Authorization=Bearer%20<project API key>"
OTEL_SERVICE_NAME=order-support
EU 데이터 상주는 https://api.eu.amplitude.com/otlp/v1/traces을(를) 사용합니다.
아이덴티티
| 속성 | 값 |
|---|---|
session.id | 대화, 스레드 또는 티켓 ID입니다. 모든 턴에 동일한 값을 사용합니다. |
user.id | 프로덕트 분석에서 이미 사용하고 있는 사용자 ID입니다. Amplitude는 누락된 사용자를 unknown으(로) 저장합니다. |
gen_ai.agent.id | 이 에이전트의 안정적인 이름. Amplitude는 gen_ai.agent.name을(를) 읽지 않습니다. |
이월되는 항목
| 프레임워크 | [Agent] Tool Call | 이 캡처가 보여준 것 |
|---|---|---|
| Agno 3.1.11 | 예 | 도구 이름 및 인수, 그리고 모델 스팬에 대한 응답 |
| smolagents 1.26.0 | 예 | 응답은 final_answer 도구 결과입니다. |
| DSPy 3.4.1 | 네, 내보내기 시 tool.name을(를) 설정하시면 가능합니다 | 모든 모델 호출은 질문을 기록합니다. 모델 이름이 도착합니다. 토큰 수는 그렇지 않습니다 |
| Haystack 3.4.1 | 아니요 | 도구 호출은 모델 스팬 내에 유지됩니다. |
| Google GenAI SDK 2.33.0 | 아니요 | 자동 함수 호출은 SDK 내에 유지됩니다. |
| AutoGen AgentChat 0.7.5 | 예 | 도구 이름 및 인수, 그리고 모델 스팬에 대한 응답 |
Haystack과 Google GenAI SDK는 여전히 세션, 사용자, 모델, 두 토큰 카운트 및 응답 텍스트를 생성합니다.
TraceConfig hide-input 및 hide-output 플래그가 있는 경우 메시지 속성을 생략하므로 프롬프트 및 응답 텍스트가 도착하지 않습니다. input.value 및 output.value은(는) 자리 표시자 __REDACTED__입니다. Amplitude는 해당 자리 표시자를 삭제하므로 도구 인수와 도구 결과는 비어 있습니다. Agno 및 AutoGen은 여전히 tool.parameters에 대해 인수를 전송합니다. Google GenAI는 여전히 message.tool_calls.0.tool_call.function.arguments을(를) 통해 전송합니다. smolagents는 여전히 smolagents.task을(를) 통해 사용자 질문을 전송합니다. Amplitude는 이러한 속성을 저장합니다. 세션, 사용자 및 에이전트는 유지됩니다. Agno, smolagents, Haystack, Google GenAI 및 AutoGen은 모델 이름과 두 토큰 카운트를 유지합니다. DSPy는 모델 이름을 유지하고 토큰 수를 삭제합니다. Agno, smolagents, DSPy 및 AutoGen은 tool.name을(를) 유지합니다. Haystack과 Google GenAI SDK에는 여전히 도구 스팬이 없습니다.
세션 닫기
[Agent] Session End은(는) 선택 사항이며 권장됩니다. 네이티브 OpenInference 내보내기는 이를 전송하지 않습니다. Amplitude는 기본적으로 적합한 에이전트 이벤트 없이 30분 후에 세션을 닫으며, 세션별 재정의가 설정되지 않은 경우 세션 시작 후 24시간 내에 세션을 닫습니다. 첫 번째 닫기가 유효합니다. 세션 레코드와 콘텐츠 기반 신호를 포함한 Enrichment는 해당 시점이 종료된 후 한 번 실행됩니다. OpenTelemetry 변환기는 스팬에서 idle-timeout 속성을 읽지 않습니다. 세션 닫기 방법을 참조하십시오.
시작하기
OpenInference 연동 가이드를 따르십시오. 동일한 세션 id로 두 턴을 전송한 다음 라이브 이벤트에서 확인하십시오:
- 세션 ID는 프로세서 세션 ID이며 추적 ID가 아닙니다.
- 사용자 ID는 product-analytics 사용자이며,
unknown이(가) 아닙니다. - 에이전트 ID는
gen_ai.agent.id입니다. - Agno, smolagents, DSPy 및 AutoGen은 도구 호출을 보여줍니다. Haystack과 Google GenAI SDK는 응답을 표시하며 도구 호출은 표시하지 않습니다.
- AI 응답에는 모델 이름이 있으며 두 토큰 카운트가 모두 있습니다.
가이드는 2026년 10월 28일에 agno 3.1.11, smolagents 1.26.0, dspy 3.4.1, haystack-ai 3.4.1, google-genai 2.33.0 및 autogen-agentchat 0.7.5 기준으로 마지막으로 확인되었습니다. 이러한 이름은 해당 소유자의 상표입니다. Amplitude는 이러한 소유자와 제휴하지 않으며 보증하지 않습니다.
이 내용이 도움이 되었나요?
For AI agents: a documentation index is available at /docs/llms.txt. Append .md to any page URL for markdown, or send Accept: text/markdown.