Document Python connector extras and optional dependency compatibility
Maintainer thường phản hồi trong vòng 2 ngày
Chưa có ai nhận issue này.
Đánh giá
- Độ khó
- 4/5
- Thời gian dự kiến
- 3-5 ngày
- Mức phù hợp với người mới
- 55/100
- Loại issue
- Tài liệu
- Độ rõ ràng
- Khá rõ ràng
- Mức độ hoạt động
- Sôi nổi
- Công nghệ
- python
- Lĩnh vực
- documentation
Hướng nghiên cứu
Bắt đầu bằng cách xem xét metadata của package Python trong pyproject và tài liệu hiện có dành riêng cho từng connector để liệt kê các connector công khai, đường dẫn import, extras và các package upstream. Sau đó kiểm tra việc xác thực các ràng buộc phiên bản của CI và quá trình build tài liệu. Được xem là hoàn tất khi mọi connector đều được ánh xạ hoặc được đánh dấu là không có extra, các mục khớp với metadata, tài liệu cấu hình được liên kết và build tài liệu thành công.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Mô tả
Summary
Add a single Python contributor/user reference mapping Semantic Kernel connectors to their install extras and important optional dependency constraints.
Current implementation facts
Semantic Kernel's Python package supports multiple connectors with optional third-party SDKs. Import-time failures can otherwise surface far from installation.
Problem
Users and contributors must inspect pyproject metadata and individual connector docs to determine which extra installs a connector and which upstream versions are supported.
Scope
- Add a generated or maintained compatibility table.
- Include connector name, import path, install extra, and upstream package.
- Link to connector-specific configuration docs.
- State how version constraints are validated in CI.
Non-goals
- Do not broaden dependency version ranges.
- Do not combine all connectors into the default install.
Acceptance criteria
- Every public Python connector maps to an extra or explicitly states none.
- Table entries can be checked against package metadata.
- Documentation builds successfully.
I searched Semantic Kernel issues and PRs for Python connector extras, optional dependencies, compatibility matrix, and install guidance before filing this proposal.
- Ngôn ngữ chính
- C#
- Star
- 28.6k
- Fork
- 4.8k
- Merge trung bình
- 13 giờ 24 phút
- Pull request đã merge (30 ngày)
- 11
Chuẩn bị môi trường
Bắt đầu từ đâu
- Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
- Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
- Fork repository và làm thay đổi trên một nhánh.
- Mở pull request có tham chiếu số hiệu của issue.
Issue khác của microsoft/semantic-kernel
-
python triage
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 85/100
microsoft/semantic-kernel#14491 · 1 bình luận ·
Maintainer thường phản hồi trong vòng 2 ngày
-
python triage
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 82/100
microsoft/semantic-kernel#14490 · 1 bình luận ·
Maintainer thường phản hồi trong vòng 2 ngày
-
Python: [Python] structured_outputs_transform reuses ChatHistory across calls (prompt pollution)Đang mởpython triage
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 88/100
microsoft/semantic-kernel#14483 · 2 bình luận ·
Maintainer thường phản hồi trong vòng 2 ngày
-
.NET python triage
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 74/100
microsoft/semantic-kernel#14482 · 3 bình luận ·
Maintainer thường phản hồi trong vòng 2 ngày
-
Python: [Python] as_agent_framework_tool drops parameter defaults (optionals become required)Đang mởpython triage
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 85/100
microsoft/semantic-kernel#14481 ·
Maintainer thường phản hồi trong vòng 2 ngày
Tất cả issue của microsoft/semantic-kernel
Issue tương tự
-
agentic-workflows area/Docs partner/agentic-workflows
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 68/100
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 78/100
microsoft/fluentui-blazor#5364 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
.NET triage
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 74/100
microsoft/agent-framework#8811 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
.NET Docs
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 82/100
getsentry/sentry-dotnet#5637 · 1 bình luận ·
Maintainer thường phản hồi trong vòng 2 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 78/100
QuantConnect/Lean#9842 ·
Maintainer thường phản hồi trong vòng 1 ngày