.NET: Proposal: add an llms.txt
Maintainer thường phản hồi trong vòng 1 ngày
Chưa có ai nhận issue này.
Đánh giá
- Độ khó
- 1/5
- Thời gian dự kiến
- Dưới một giờ
- Mức phù hợp với người mới
- 85/100
- Loại issue
- Tài liệu
- Độ rõ ràng
- Đặc tả rõ ràng
- Mức độ hoạt động
- Sôi nổi
- Công nghệ
- markdown
- Lĩnh vực
- documentation
Hướng nghiên cứu
Bắt đầu từ thư mục gốc của repository và xem xét nội dung llms.txt được đề xuất trong issue này theo định dạng llms.txt và các tệp README, COMMUNITY.md, docs được liên kết. Thêm hướng dẫn Markdown thuần đã được phê duyệt, gồm phần tóm tắt dự án và các liên kết, sau đó xác minh rằng mọi đường dẫn được tham chiếu đều tồn tại và tài liệu có tên là llms.txt.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Mô tả
Hi! We would like to offer Microsoft Agent Framework an llms.txt: a short, plain-markdown guide at the root of the repository that tells AI assistants what the project is and where its documentation lives (the llms.txt format). We drafted one with our open-source generator brethof-llms-txt; an AI model (GLM 5.3 Flash) wrote the summary and descriptions. It is below.
Would you like it as a pull request? If yes, reply here and we will open one. If not, close this issue and we will not ask again.
The proposed llms.txt (21 links)
# Microsoft Agent Framework
> An open-source, multi-language framework for building production-grade AI agents and multi-agent workflows in .NET, Python, and Go.
Supports Python and C#/.NET with consistent APIs, plus a separate Go SDK in microsoft/agent-framework-go. Provides orchestration patterns (sequential, concurrent, handoff, group collaboration), middleware, OpenTelemetry observability, YAML declarative agents, DevUI, and Foundry hosted agents. Install via Python or .NET packages; docs include quickstart, tutorials, user guide, and migration guides from Semantic Kernel and AutoGen.
## Docs
- [Microsoft Agent Framework README](https://raw.githubusercontent.com/microsoft/agent-framework/main/README.md): Overview of the framework for building production-grade AI agents and multi-agent workflows in .NET and Python.
- [Welcome to the Agent Framework Community](https://raw.githubusercontent.com/microsoft/agent-framework/main/COMMUNITY.md): Ways to get involved: GitHub discussions, issues, pull requests, and public community office hours schedules.
- [Responsible AI Transparency FAQs](https://raw.githubusercontent.com/microsoft/agent-framework/main/TRANSPARENCY_FAQ.md): Answers about what the framework is, its capabilities, and intended uses.
- [Frequently Asked Questions](https://raw.githubusercontent.com/microsoft/agent-framework/main/docs/FAQS.md): Steps to access nightly builds via GitHub Personal Access Token and NuGet configuration.
## Features
- [Durable Agents Have Moved](https://raw.githubusercontent.com/microsoft/agent-framework/main/docs/features/durable-agents/README.md): Links to the new repository location for durable agent source, samples, and documentation.
- [Vector Stores and Embeddings](https://raw.githubusercontent.com/microsoft/agent-framework/main/docs/features/vector-stores-and-embeddings/README.md): Design decisions for ported vector store and embedding abstractions from Semantic Kernel.
- [FIDES Implementation Summary](https://raw.githubusercontent.com/microsoft/agent-framework/main/docs/features/FIDES_IMPLEMENTATION_SUMMARY.md): Deterministic prompt injection defense system using content labels, SecureAgentConfig, MCP auto-labeling, and data exfiltration prevention.
- [CodeAct .NET implementation](https://raw.githubusercontent.com/microsoft/agent-framework/main/docs/features/code_act/dotnet-implementation.md): .NET CodeAct design with HyperlightCodeActProvider, provider-owned tool sets, swappable backends, and execution capability configuration.
- [CodeAct Python implementation](https://raw.githubusercontent.com/microsoft/agent-framework/main/docs/features/code_act/python-implementation.md): Python CodeAct design with HyperlightCodeActProvider, provider-owned tool sets, swappable backends, and execution capability configuration.
## Optional
- [Contributing to Agent Framework](https://raw.githubusercontent.com/microsoft/agent-framework/main/CONTRIBUTING.md): How to report issues, file pull requests, and rules for contributing new language implementations.
- [Architectural Decision Records (ADRs)](https://raw.githubusercontent.com/microsoft/agent-framework/main/docs/decisions/README.md): What ADRs are and how to create, number, and review decision records using the templates.
- [Agent Run Responses Design](https://raw.githubusercontent.com/microsoft/agent-framework/main/docs/decisions/0001-agent-run-response.md): Design of agent run response abstractions covering messages, tool activities, reasoning, handoffs, and streaming updates.
- [Agent Tools](https://raw.githubusercontent.com/microsoft/agent-framework/main/docs/decisions/0002-agent-tools.md): Design decision on a unified tool abstraction, provider-specific tool options, error handling, and fallbacks for custom tools.
- [Agent OpenTelemetry Instrumentation](https://raw.githubusercontent.com/microsoft/agent-framework/main/docs/decisions/0003-agent-opentelemetry-instrumentation.md): Decision on OpenTelemetry instrumentation for agents, covering semantic conventions, token usage, traces, and non-intrusive optional telemetry.
- [Azure.AI.Agents.Persistent` package Extensions Methods for Agent Framework](https://raw.githubusercontent.com/microsoft/agent-framework/main/docs/decisions/0004-foundry-sdk-extensions.md): Decision on where extension methods for creating AIAgent from PersistentAgentsClient should live, comparing package placement options.
- [Python Package design for Agent Framework](https://raw.githubusercontent.com/microsoft/agent-framework/main/docs/design/python-package-setup.md): Python package structure with tier 0, tier 1, and tier 2 components and flat imports from agent_framework.
- [Agent Framework / Foundry SDK Alignment](https://raw.githubusercontent.com/microsoft/agent-framework/main/docs/specs/001-foundry-sdk-alignment.md): Specification clarifying positioning of Foundry SDK versus Agent Framework SDK, their goals, and combining both in orchestrations.
- [Python protocol helpers and optional execution state](https://raw.githubusercontent.com/microsoft/agent-framework/main/docs/specs/002-python-hosting-channels.md): Python implementation plan for protocol helper functions and optional state holders in agent-framework-hosting, with goals and non-goals.
- [NET hosting: OpenAI Responses protocol helpers and optional execution state](https://raw.githubusercontent.com/microsoft/agent-framework/main/docs/specs/003-dotnet-hosting-protocol-helpers.md): Helpers for exposing an AIAgent or workflow over the OpenAI Responses protocol in your own ASP.NET Core routes.
- [Feature-usage telemetry via an accumulating bitmask](https://raw.githubusercontent.com/microsoft/agent-framework/main/docs/specs/004-feature-usage-telemetry.md): Design for feature-usage telemetry via an accumulating bitmask on the User-Agent, with allowlisted pipelines and opt-out.
- [Python function-calling loop contract and validation matrix](https://raw.githubusercontent.com/microsoft/agent-framework/main/docs/specs/004-python-function-calling-loop.md): Required behavior and validation coverage for the Python function-calling loop, including approvals, streaming, errors, and serialization.
— BrethofAI
- Ngôn ngữ chính
- Python
- Star
- 14.2k
- Fork
- 2.5k
- Merge trung bình
- 2 ngày 9 giờ
- Pull request đã merge (30 ngày)
- 392
Chuẩn bị môi trường
Khởi chạy dev container của dự án ngay trên trình duyệt, bằng tài khoản GitHub của bạn.
- Không có Dockerfile hay tệp Docker Compose
- Có mẫu pull request
- Đọc hướng dẫn đóng góp
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/agent-framework
-
Python: foundry-hosting drops request `metadata` from the stored response — `_create_response_event_stream` never passes `request` to `ResponseEventStream`Có thể đã có người làm @its-amann đã nhận 2 ngày trước. Đang mởpython triage
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 78/100
microsoft/agent-framework#9529 · 1 bình luận ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Python: [Bug]: A non-positive MCP request timeout silently disables the timeoutCó thể đã có người làm @jpalvarezl đã nhận 8 ngày trước. Đang mởpython
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 82/100
microsoft/agent-framework#9313 · 1 người được giao ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Python: raw-data content mappings lose annotations and attachment metadataCó thể đã có người làm @moonbox3 đã nhận 22 ngày trước. Đang mởpython triage
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 78/100
microsoft/agent-framework#8632 · 2 bình luận ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Python: Clarify when to use platformCó thể đã có người làm @eavanvalkenburg đã nhận 21 ngày trước. Đang mởpython triage
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 68/100
microsoft/agent-framework#8599 · 1 bình luận ·
Maintainer thường phản hồi trong vòng 1 ngày
-
.NET compaction documentation
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 82/100
microsoft/agent-framework#4629 · 1 bình luận ·
Maintainer thường phản hồi trong vòng 1 ngày
Tất cả issue của microsoft/agent-framework
Issue tương tự
-
bug good first issue
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 78/100
yunaremaia/proto-drift#22 ·
-
bug good first issue
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 82/100
yunaremaia/memwatch#96 ·
-
bug good first issue
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 91/100
yunaremaia/ci-gate-watch#34 ·
-
bug good first issue
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 85/100
yunaremaia/agent-capability-attestation#64 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
bug good first issue
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 86/100
yunaremaia/agent-call-graph#43 ·
Maintainer thường phản hồi trong vòng 1 ngày