Python AI SDK 릴리즈 노트

릴리즈 노트amplitude-ai. Node SDK에 대해서는 Node AI SDK 릴리즈 노트를 참조하십시오.

1.18.0

2026년 10월 릴리즈됨. 이 릴리즈는 개인정보 보호 처리, 공급자 래퍼, MCP 서버, CLI 도구 및 릴리스 파이프라인을 강화합니다. Amplitude는 모든 사용자에게 다음 업그레이드를 권장합니다python3 -m pip install --upgrade "amplitude-ai>=1.18.0".

동작 변경

  • @tool 는 활성 개인정보 보호 구성을 상속합니다. 데코레이터, AmplitudeAI클라이언트 또는 ToolCallTracker.set_amplitude()에서 제공하는 것이 없으면 메타데이터만 전송하고 경고를 한 번만 기록합니다. 도구 입력 및 출력을 캡처하려면 privacy_config=를 전달합니다.
  • custom_redaction_fn이 발생하면 SDK는 영향을 받는 콘텐츠를 삭제합니다. custom_redaction_patterns항목이 유효하지 않은 경우 SDK는 오류를 기록하고 사용자가 수정할 때까지 메시지 콘텐츠를 보류합니다.
  • wrap()는 전달된 클라이언트를 재사용하므로 base_url, http_client, 헤더 및 시간 초과 설정을 유지합니다. with_options()에 전달하는 클라이언트 옵션은 wrap()를 통해 적용됩니다.
  • validate=True래핑된 공급자 호출 내에서 더 이상 발생하지 않습니다.
  • 기본적으로 gen_ai.*또는 amplitude.*속성이 있는 enable_otel()범위만 매핑합니다. HTTP 및 데이터베이스 범위와 같은 다른 범위도 이벤트로 매핑하려면 [Agent] Span를 전달합니다otel_span_filter="all".
  • MCP scan_project 도구는 클라이언트의 MCP 루트 또는 서버의 작업 디렉토리만 읽습니다. 다른 디렉토리를 허용하려면 AMPLITUDE_AI_MCP_ROOTS에 나열하십시오.
  • MCP instrument_file 도구는 bootstrap_import에서 import 문만 허용합니다. MCP 도구 입력이 100만 자를 초과하면 거부됩니다.
  • 종속성 범위에는 fastmcp<5및 starlette<2와 같이 상한이 있습니다.
  • 사용자 지정 x-trace-id 값은 Node SDK와 일치하는 64자로 제한됩니다. 더 긴 값은 인바운드 요청에서 무시되며 아웃바운드 요청에서는 전송되지 않습니다.
  • enable_otel()와 함께 사용하면, OpenTelemetry가 없을 때와 마찬가지로, SDK 자체 범위에 대해 호출당 amplitude_user_id가 세션 사용자보다 우선적으로 적용됩니다.

수정

  • 추적 오류는 더 이상 래핑된 공급자 호출에 영향을 주지 않으며, 동기화 스트림은 공급자의 스트림 객체를 반환합니다.
  • API 키를 포함한 업로드는 구성된 HTTPS 오리진으로만 이동하며, 리디렉션을 따르지 않으며, 30초 후에 시간 초과됩니다.
  • PII 편집은 유니코드 텍스트, 악센트/그리스/시릴 문자가 포함된 이메일, 구조화된 페이로드에 적용되며, 패치가 적용된 Gemini 및 Mistral 호출과 보강용 자유 형식 텍스트에도 적용됩니다. 캡처된 콘텐츠는 미디어 부분을 제외합니다.
  • @observe는 @tool와 동일한 순서로 개인정보 보호 설정을 확인하므로 활성 세션의 콘텐츠 모드가 적용됩니다.
  • AIConfig.propagate_context가 적용됩니다. 유효한 HTTP 헤더 값이 아닌 컨텍스트 ID는 요청을 실패로 처리하는 대신 제외됩니다.
  • 오류 로그는 메시지 콘텐츠와 사용자 ID를 생략하며, CLI 및 상태 출력은 키를 마스킹합니다.
  • MCP 서버는 배너나 PyPI 업데이트 확인 없이 시작됩니다. CLI는 설치된 패키지에서만 가이드를 읽으며, 번들로 제공되는 문서는 amplitude_ai/_docs/아래에 제공됩니다.
  • enable_otel()에서 세션 외부의 공급자 호출은 호출당 amplitude_user_id 또는 wrap(user_id=...)기본값을 사용합니다.
  • wrap(wrapped_client, amplitude=other) 는 더 이상 내부 래퍼의 사용자 및 장치 기본값을 상속받지 않습니다.
  • LangChain 및 OpenAI 에이전트 핸들러는 실행당 상태를 10,000개 항목으로 제한하므로 완료되지 않는 실행은 메모리를 증가시키지 않습니다.
  • 이미 패치가 적용된 공급자를 다시 호출하면 경고가 기록됩니다patch(). 첫 번째 설정은 unpatch()를 호출할 때까지 계속 적용됩니다.
  • localhost 업로드 또는 카탈로그 엔드포인트에 대한 요청은 HTTP_PROXY및 HTTPS_PROXY을(를) 건너뜁니다.
  • MCP instrument_file 도구는 많은 라우트 핸들러가 있는 파일에서 선형 시간으로 실행됩니다.
  • AMPLITUDE_AI_API_KEY에 의해 시작된 프로세스는 해당 환경에서 amplitude-ai-instrument을(를) 유지합니다. 이것을 제외한 환경에서 신뢰할 수 없는 하위 프로세스를 시작하세요.

1.17.0

2026년 10월 7일 릴리즈됨.

동작 변경

  • AIConfig.redact_pii 이제 기본값은 True입니다. 이번 릴리즈 AmplitudeAI이전에는, 명시적인 redact_pii 없이 빌드된 PrivacyConfig경우 메시지 콘텐츠가 편집되지 않고 전송되었지만, patch(), 독립형 공급자 래퍼, 그리고 Node SDK는 이미 기본적으로 편집되고 있었습니다. 내장된 비식별화 기능은 이벤트가 프로세스를 떠나기 전에 이메일, 전화 번호, SSN, 신용 카드 번호 및 IP 주소를 마스킹합니다. 원시 콘텐츠를 유지하려면 AIConfig(redact_pii=False)를 전달합니다.

수정

  • PyPI 페이지는 더 이상 개인 저장소로 연결되지 않으며, Documentation 해당 링크는 AI SDK 참조를 가리킵니다.
  • 번들로 제공되는 에이전트 가이드는 올바른 FastAPI amplitude_ai.middleware.AmplitudeAIMiddleware미들웨어 가져오기를 필수 amplitude_ai= 및 user_id_resolver= 인수와 함께 사용합니다.
  • 번들로 제공되는 에이전트 가이드에는 [Agent] Topic ClassificationAmplitude가 더 이상 전송하지 않는 항목이 더 이상 나열되지 않습니다.

1.16.0

2026년 10월 6일 릴리즈됨.

기능

  • 이벤트 카탈로그에 [Agent] Data Quality Rationale및 [Agent] Data Quality Evidence가 추가됩니다.

수정

  • Gemini 호출[Agent] Provider Request ID이 이제 기록됩니다.
  • SDK는 Fireworks 라우터 호출에 대해 라우터가 선택한 모델의 가격을 책정하므로, 더 이상 데이터가 손실되지 않습니다[Agent] Cost USD.

1.15.0

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

기능

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

1.14.0

2026년 9월 19일 릴리즈됨.

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

  • amplitude-ai-register-catalog다른 로컬 사용자가 ps로 인수를 읽을 수 있기 때문에 더 이상 비밀 키를 인수로 허용하지 않습니다. stdin에서 시크릿을 읽으려면 AMPLITUDE_API_KEY및 AMPLITUDE_SECRET_KEY를 설정합니다--secret-key -. --secret-key <value>가 이제 오류와 함께 종료됩니다.

수정

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

이 페이지에서