Node AI SDK 릴리즈 노트

npmv0.31.0164.0 kB gzip

@amplitude/ai에 대한 릴리즈 노트. 전체 엔지니어링 변경 로그를 보려면 GitHub의 Amplitude-AI-Node CHANGELOG로 이동하십시오. Python SDK의 경우 Python AI SDK 릴리즈 노트를 참조하십시오.

0.24.1

2026년 10월 26일 출시됨.

수정

  • 구조화된 콘텐츠 채널 내에서 직렬화된 JSON 객체 및 배열에서 숫자 값과 유효한 JSON 이스케이프를 유지합니다. 내장된 편집은 디코딩된 문자열 값과 키를 스캔하고, 인식된 전화, 카드 및 SSN 필드 아래에서 숫자 값을 마스킹하며, 다른 숫자 토큰을 그대로 보존합니다. 하나의 편집된 키로 축소되는 고유의 원본 키가 있으면 직렬화된 문서가 안전하게 차단됩니다.

0.24.0

2026년 10월 릴리즈됨.

기능

  • 인라인 메시지 첨부에 선택적 $agent_artifactTypeScript 유형을 추가하여 런타임 캡처를 변경하거나 아티팩트 스키마에 대한 유효성 검사를 수행하지 않고도 유형 추론을 개선합니다.
  • 에이전트 위임을 통해 다중 에이전트 계통을 보존하여 한 에이전트가 다른 에이전트에게 위임할 때 전체 에이전트 체인이 기록되도록 하십시오.
  • 공급자 발신의 사용자 메시지가 추적되는 방식에 따라 명시적 사용자 역할로 생성하는 범위에 [Agent] Source를 설정합니다.

수정

  • 회귀(regression) 후 도구 및 스팬 입력/출력과 AI 및 사용자 메시지 첨부에 대한 아티팩트 캡처를 복원합니다.
  • 아티팩트 개인정보 보호 강화: 지원되지 않는 MathML 스냅샷을 거부하고, CSS 인용문 유출을 차단하며, 정적 아티팩트 텍스트 가시성을 제한하여 콘텐츠가 활성 콘텐츠 모드 외부에 나타나지 않도록 합니다. 원시 HTML 아티팩트 스냅샷은 생산자가 소유하며, 기존 콘텐츠 캡처 설정, 최선의 노력으로 수행하는 문자열 편집 및 크기 제한이 적용됩니다.
  • 이전 턴을 모두 다시 기록하는 대신 LangChain 대화에서 새로운 사용자 턴만 기록하여 중복 [Agent] User Message 이벤트를 방지하십시오.
  • Envelope가 원시 페이로드일 때 플래그로 제거할 수 없는 콘텐츠를 자동으로 포함하는 대신, 전달하기 전에 resourceSpansOTLP 리플레이 스크립트가 거부하도록 --metadata-only수정하십시오.

0.23.0

2026년 10월 릴리즈됨. 이제 공개 가이드 URL은 main를 추적하므로 이후 SDK 릴리스에는 새 링크가 필요하지 않습니다. 이 릴리즈는 AWS Strands 가이드, HTTP, OpenTelemetry, Batch, S3 및 웨어하우스 가져오기에 대한 개인정보 보호 계약을 추가하며, 이를 선택 사항이며 [Agent] Session End권장한다고 명시합니다.

0.22.0

2026년 10월 릴리즈됨.

기능

  • 검토 모드(reviewMode: true)를 추가합니다. SDK는 각 편집 후 이벤트를 기록하고 Amplitude로 전송하지 않으면서 삭제/편집된 상태의 전송 전 업로드 미리 보기를 출력합니다. getReviewTraffic()로 미리 보기를 확인하십시오. 제로 코드 계측의 경우 AMPLITUDE_AI_REVIEW=true를 설정합니다. 프롬프트 및 메시지 콘텐츠는 그대로 유지되며, Envelope API 키는 [REDACTED]입니다. AMPLITUDE_AI_DEBUG 는 검토 모드를 활성화하지 않습니다.
typescript
const ai = new AmplitudeAI({
  apiKey: process.env.AMPLITUDE_AI_API_KEY!,
  config: new AIConfig({ reviewMode: true }),
});
// Exercise a representative session, then:
await ai.flush();
console.log(ai.getReviewTraffic());

0.21.0

2026년 10월 릴리즈됨. 이 릴리즈는 개인정보 보호 처리, 공급자 래퍼, MCP 서버, CLI 도구 및 릴리즈 파이프라인을 강화합니다. Amplitude는 모든 사용자가 다음을 업그레이드할 것을 권장합니다.npm install @amplitude/ai@^0.21.0

동작 변경

  • tool()는 활성 콘텐츠 모드를 상속합니다. 데코레이터, 세션의 AmplitudeAI클라이언트 또는 ToolCallTracker.setAmplitude()에서 개인정보 보호 구성이 없는 경우, 메타데이터만 전송합니다. 도구 입력 및 출력을 캡처하려면 privacyConfig를 전달합니다.
  • customRedactionFn가 발생하면 SDK는 영향을 받는 콘텐츠를 삭제합니다. 구성을 빌드할 때 잘못된 customRedactionPatterns이 발생하면 ConfigurationError를 throw합니다.
  • wrap()은(는) 사용자가 전달한 OpenAI, Azure OpenAI 또는 Anthropic 클라이언트를 제자리에서 계측하므로 baseURL, fetch, 헤더 및 시간 초과 설정을 유지합니다. signal, timeout및 headers와 같은 요청 옵션은 공급자에게 전달됩니다.
  • pushContext(ctx, fn) 는 fn가 실행되는 동안만 컨텍스트를 설정합니다. 콜백 없이 호출하는 것은 여전히 작동하지만 더 이상 사용되지 않으며 경고를 한 번 기록합니다. 이는 HTTP 서버에서 컨텍스트가 동일한 연결의 pushContext(ctx)이후 요청으로 이어질 수 있기 때문입니다. 대신 pushContext(ctx, fn), runWithContext()또는 session.run()를 사용하십시오.
  • amplitude-ai-instrument은(는) 실행하는 프로세스만 계측합니다. 자식 Node 프로세스도 계측하려면 AMPLITUDE_AI_INSTRUMENT_CHILDREN=true를 설정합니다.
  • MCP scan_project 도구는 클라이언트의 MCP 루트 또는 서버의 작업 디렉토리만 읽습니다. 다른 디렉토리를 허용하려면 AMPLITUDE_AI_MCP_ROOTS에 나열하십시오.
  • MCP 서버는 번들로 제공되는 사본이 아닌 설치된 @modelcontextprotocol/sdk 및 zod를 사용하며, 누락된 경우 설치해야 할 항목을 알려줍니다.
  • 피어 종속성 범위에는 상한이 있습니다. @amplitude/analytics-node, @opentelemetry/api, tiktoken는 2 미만이어야 하고, @opentelemetry/sdk-trace-base는 3 미만이어야 합니다.
  • 문서 및 번들로 제공되는 가이드는 범위가 지정된 패키지(예: npx -y -p @amplitude/ai <command>)에서 명령을 실행하며, 설치된 패키지(예: node node_modules/@amplitude/ai/docs/integrations/check-agent-events.mjs)에서 연동 스크립트를 실행합니다. 가이드 URL은 main가 아닌 릴리즈 태그를 가리킵니다.
  • patch()를 사용하면 OpenAI 및 Anthropic 호출은 SDK의 고유 유형을 반환합니다. create()는 APIPromise을(를) 반환하므로 .withResponse() 및 .asResponse()가 작동하며, 스트림은 SDK Stream이므로 .tee() 및 .toReadableStream()이 작동합니다.
  • 세션 내에서 패치된 공급자 호출은 다른 인스턴스가 호출하는 경우AmplitudeAI에도 해당 세션을 소유하는 인스턴스로 이동합니다patch().

수정

  • 추적 오류는 더 이상 래핑된 공급자 호출에 영향을 주지 않습니다.
  • 각 AmplitudeAI 인스턴스는 자체 클라이언트 및 컨텍스트 전파를 유지하며, 통합은 실행별로 ID를 확인합니다. 전파된(Propagated) 컨텍스트는 요청 헤더에서만 전송되며, 유효하지 않은 HTTP 헤더 값은 요청을 실패로 처리하는 대신 제외됩니다.
  • 디버그 로그에서는 메시지 콘텐츠를 생략하고, 경고에서는 사용자 ID를 생략합니다. 첨부 파일과 메시지 레이블은 삭제 처리를 거칩니다.
  • OpenTelemetry 스팬 매핑 수정.
  • 오프라인 평가 업로드에는 HTTPS가 필요하며 시간 초과를 사용합니다. 플러시는 제한된 시간 초과를 갖습니다.
  • 이 패키지는 더 이상 선택적 종속성을 번들로 제공하지 않으므로 파일 수가 약 절반으로 줄었습니다.
  • ai.flush({ timeoutMs })타임아웃 후 대기를 중지하고 오류 없이 해결됩니다.ai.flush() 옵션이 없는 경우 변경되지 않습니다.
  • enableOtel()및 AmplitudeAgentExporter 가 모두 한 번으로 기록되는 범위입니다.
  • amplitude-ai-instrument 시작된 앱에 중지 신호를 전달하고 앱의 종료 코드로 종료됩니다. 이 기능은 런처 자체와 마찬가지로 node_modules/.bin/<launcher>를 tsx또는 nodemon와 같이 처리합니다.
  • amplitude-ai-doctor 는 잘못된 형식의 package.json를 충돌이 아니라 검사가 실패한 것으로 보고합니다.
  • MCP 서버는 코드 스니펫에서 더 많은 주요 형식을 마스킹하고 모든 도구 인수의 크기를 제한합니다.

0.20.1

2026년 10월 7일 릴리즈됨.

수정

  • @google/genai 는 이제 @google/generative-ai와 같이 선택적 피어 종속성입니다. GoogleGenAI래퍼에서 이미 이를 요구했습니다.
  • 번들로 제공되는 README 및 에이전트 가이드는 이제 내장 신호를 [Agent] Session Record의 속성으로, 사용자 지정 평가기를 [Agent] Evaluator Result의 이벤트로 설명합니다. 또한 더 이상 사용되지 않는 이벤트를 나열하지 않습니다.
  • 이제 공급자 매트릭스에 Gemini, Azure OpenAI 및 Bedrock에 대한 캐시 토큰 통계가 표시됩니다. Mistral만 이를 리포트하지 않습니다.
  • 번들로 제공되는 amplitude-ai.md가이드는 올바른 trackToolCall 옵션 input 및 output를 사용합니다.

0.20.0

2026년 10월 6일 릴리즈됨. 이 릴리즈에는 npm에 게시되지 않은 0.19.0에 대해 나열된 변경 사항도 포함됩니다.

기능

  • [Agent] Ingestion Path 및 PROP_SOURCE에 대한 PROP_INGESTION_PATH및 [Agent] Source 상수입니다.
  • amplitude-ai-register-catalog 이제 [Agent] Git SHA는 SDK가 이미 전송한 [Agent] Git Ref, [Agent] Git Repo, [Agent] Provider Request ID및 를 등록합니다.

수정

  • Gemini 호출은 이제 기록됩니다[Agent] Provider Request ID.
  • SDK는 Fireworks 라우터 호출에 대해 라우터가 선택한 모델로 가격을 책정하므로 더 이상 손실이 발생하지 않습니다[Agent] Cost USD.
  • amplitude-ai-register-catalog 는 Amplitude가 더 이상 전송하지 않는 [Agent] Enrichment Cost USD를 등록하지 않습니다.
  • SDK는 @pydantic/genai-prices 값을 ^0.1.3 값으로 고정하므로 향후 주요 버전에서는 비용을 조용히 줄일 수 없습니다.

0.18.0

2026년 9월 24일에 릴리즈되었습니다.

기능

  • 모든 추적된 이벤트는 이제 [Agent] Content Mode(full, metadata_only, 또는 customer_enriched)를 포함하므로 Amplitude는 계측이 메시지 텍스트를 삭제한 세션과 의도적 메타데이터 전용 세션을 구분할 수 있습니다.
  • MockAmplitudeAI.summary() 이제 metadata_only 및 customer_enriched 모드를 제외하고 사용자 메시지에 빈 콘텐츠가 포함된 경우 실패합니다.

0.17.0

2026년 9월 19일 릴리즈됨.

호환성을 깨뜨리는 변경 사항

  • amplitude-ai-register-catalog 는 더 이상 자격 증명을 인수로 허용하지 않습니다. 스크립트가 실행될 때 환경에서 AMPLITUDE_API_KEY및 AMPLITUDE_SECRET_KEY를 읽습니다. 스크립트를 npx -y -p @amplitude/ai amplitude-ai-register-catalog > register.sh로 파일에 기록하고 검토한 다음 두 변수를 모두 내보내는 bash register.sh상태로 실행합니다.

기능

  • OpenRouter, LiteLLM 및 Requesty의 게이트웨이 레시피입니다. 게이트웨이를 참조하십시오.
  • LangChain 핸들러는 채팅 모델에 대한 [Agent] User Message를 추적합니다.
  • OpenTelemetry 엑스포터는 privacyConfig, allowedScopes, 및 blockedScopes를 허용합니다.

수정

  • SDK가 모델의 가격을 조회할 수 없는 경우 이제 $0를 기록하는 대신 생략합니다[Agent] Cost USD.

이 내용이 도움이 되었나요?

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.

이 페이지에서