{"id":13421816,"url":"https://github.com/microsoft/semantic-kernel","last_synced_at":"2026-02-10T12:01:14.398Z","repository":{"id":95349847,"uuid":"607289185","full_name":"microsoft/semantic-kernel","owner":"microsoft","description":"Integrate cutting-edge LLM technology quickly and easily into your apps","archived":false,"fork":false,"pushed_at":"2026-02-09T14:28:12.000Z","size":94601,"stargazers_count":27198,"open_issues_count":542,"forks_count":4464,"subscribers_count":288,"default_branch":"main","last_synced_at":"2026-02-09T16:15:53.679Z","etag":null,"topics":["ai","artificial-intelligence","llm","openai","sdk"],"latest_commit_sha":null,"homepage":"https://aka.ms/semantic-kernel","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/microsoft.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-02-27T17:39:42.000Z","updated_at":"2026-02-09T15:23:49.000Z","dependencies_parsed_at":"2023-09-23T09:47:35.196Z","dependency_job_id":"82753b52-30e5-4134-88f5-74e37d251c0f","html_url":"https://github.com/microsoft/semantic-kernel","commit_stats":null,"previous_names":[],"tags_count":1049,"template":false,"template_full_name":null,"purl":"pkg:github/microsoft/semantic-kernel","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microsoft%2Fsemantic-kernel","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microsoft%2Fsemantic-kernel/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microsoft%2Fsemantic-kernel/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microsoft%2Fsemantic-kernel/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/microsoft","download_url":"https://codeload.github.com/microsoft/semantic-kernel/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microsoft%2Fsemantic-kernel/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29298522,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-10T10:40:02.018Z","status":"ssl_error","status_checked_at":"2026-02-10T10:38:28.459Z","response_time":65,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","artificial-intelligence","llm","openai","sdk"],"created_at":"2024-07-30T23:00:30.850Z","updated_at":"2026-02-10T12:01:14.339Z","avatar_url":"https://github.com/microsoft.png","language":"C#","readme":"# Semantic Kernel\n\n**Build intelligent AI agents and multi-agent systems with this enterprise-ready orchestration framework**\n\n[![License: MIT](https://img.shields.io/github/license/microsoft/semantic-kernel)](https://github.com/microsoft/semantic-kernel/blob/main/LICENSE)\n[![Python package](https://img.shields.io/pypi/v/semantic-kernel)](https://pypi.org/project/semantic-kernel/)\n[![Nuget package](https://img.shields.io/nuget/vpre/Microsoft.SemanticKernel)](https://www.nuget.org/packages/Microsoft.SemanticKernel/)\n[![Discord](https://img.shields.io/discord/1063152441819942922?label=Discord\u0026logo=discord\u0026logoColor=white\u0026color=d82679)](https://aka.ms/SKDiscord)\n\n\n## What is Semantic Kernel?\n\nSemantic Kernel is a model-agnostic SDK that empowers developers to build, orchestrate, and deploy AI agents and multi-agent systems. Whether you're building a simple chatbot or a complex multi-agent workflow, Semantic Kernel provides the tools you need with enterprise-grade reliability and flexibility.\n\n## System Requirements\n\n- **Python**: 3.10+\n- **.NET**: .NET 10.0+ \n- **Java**: JDK 17+\n- **OS Support**: Windows, macOS, Linux\n\n## Key Features\n\n- **Model Flexibility**: Connect to any LLM with built-in support for [OpenAI](https://platform.openai.com/docs/introduction), [Azure OpenAI](https://azure.microsoft.com/en-us/products/ai-services/openai-service), [Hugging Face](https://huggingface.co/), [NVidia](https://www.nvidia.com/en-us/ai-data-science/products/nim-microservices/) and more\n- **Agent Framework**: Build modular AI agents with access to tools/plugins, memory, and planning capabilities\n- **Multi-Agent Systems**: Orchestrate complex workflows with collaborating specialist agents\n- **Plugin Ecosystem**: Extend with native code functions, prompt templates, OpenAPI specs, or Model Context Protocol (MCP)\n- **Vector DB Support**: Seamless integration with [Azure AI Search](https://learn.microsoft.com/en-us/azure/search/search-what-is-azure-search), [Elasticsearch](https://www.elastic.co/), [Chroma](https://docs.trychroma.com/getting-started), and more\n- **Multimodal Support**: Process text, vision, and audio inputs\n- **Local Deployment**: Run with [Ollama](https://ollama.com/), [LMStudio](https://lmstudio.ai/), or [ONNX](https://onnx.ai/)\n- **Process Framework**: Model complex business processes with a structured workflow approach\n- **Enterprise Ready**: Built for observability, security, and stable APIs\n\n## Installation\n\nFirst, set the environment variable for your AI Services:\n\n**Azure OpenAI:**\n```bash\nexport AZURE_OPENAI_API_KEY=AAA....\n```\n\n**or OpenAI directly:**\n```bash\nexport OPENAI_API_KEY=sk-...\n```\n\n### Python\n\n```bash\npip install semantic-kernel\n```\n\n### .NET\n\n```bash\ndotnet add package Microsoft.SemanticKernel\ndotnet add package Microsoft.SemanticKernel.Agents.Core\n```\n\n### Java\n\nSee [semantic-kernel-java build](https://github.com/microsoft/semantic-kernel-java/blob/main/BUILD.md) for instructions.\n\n## Quickstart\n\n### Basic Agent - Python\n\nCreate a simple assistant that responds to user prompts:\n\n```python\nimport asyncio\nfrom semantic_kernel.agents import ChatCompletionAgent\nfrom semantic_kernel.connectors.ai.open_ai import AzureChatCompletion\n\nasync def main():\n    # Initialize a chat agent with basic instructions\n    agent = ChatCompletionAgent(\n        service=AzureChatCompletion(),\n        name=\"SK-Assistant\",\n        instructions=\"You are a helpful assistant.\",\n    )\n\n    # Get a response to a user message\n    response = await agent.get_response(messages=\"Write a haiku about Semantic Kernel.\")\n    print(response.content)\n\nasyncio.run(main()) \n\n# Output:\n# Language's essence,\n# Semantic threads intertwine,\n# Meaning's core revealed.\n```\n\n### Basic Agent - .NET\n\n```csharp\nusing Microsoft.SemanticKernel;\nusing Microsoft.SemanticKernel.Agents;\n\nvar builder = Kernel.CreateBuilder();\nbuilder.AddAzureOpenAIChatCompletion(\n                Environment.GetEnvironmentVariable(\"AZURE_OPENAI_DEPLOYMENT\"),\n                Environment.GetEnvironmentVariable(\"AZURE_OPENAI_ENDPOINT\"),\n                Environment.GetEnvironmentVariable(\"AZURE_OPENAI_API_KEY\")\n                );\nvar kernel = builder.Build();\n\nChatCompletionAgent agent =\n    new()\n    {\n        Name = \"SK-Agent\",\n        Instructions = \"You are a helpful assistant.\",\n        Kernel = kernel,\n    };\n\nawait foreach (AgentResponseItem\u003cChatMessageContent\u003e response \n    in agent.InvokeAsync(\"Write a haiku about Semantic Kernel.\"))\n{\n    Console.WriteLine(response.Message);\n}\n\n// Output:\n// Language's essence,\n// Semantic threads intertwine,\n// Meaning's core revealed.\n```\n\n### Agent with Plugins - Python\n\nEnhance your agent with custom tools (plugins) and structured output:\n\n```python\nimport asyncio\nfrom typing import Annotated\nfrom pydantic import BaseModel\nfrom semantic_kernel.agents import ChatCompletionAgent\nfrom semantic_kernel.connectors.ai.open_ai import AzureChatCompletion, OpenAIChatPromptExecutionSettings\nfrom semantic_kernel.functions import kernel_function, KernelArguments\n\nclass MenuPlugin:\n    @kernel_function(description=\"Provides a list of specials from the menu.\")\n    def get_specials(self) -\u003e Annotated[str, \"Returns the specials from the menu.\"]:\n        return \"\"\"\n        Special Soup: Clam Chowder\n        Special Salad: Cobb Salad\n        Special Drink: Chai Tea\n        \"\"\"\n\n    @kernel_function(description=\"Provides the price of the requested menu item.\")\n    def get_item_price(\n        self, menu_item: Annotated[str, \"The name of the menu item.\"]\n    ) -\u003e Annotated[str, \"Returns the price of the menu item.\"]:\n        return \"$9.99\"\n\nclass MenuItem(BaseModel):\n    price: float\n    name: str\n\nasync def main():\n    # Configure structured output format\n    settings = OpenAIChatPromptExecutionSettings()\n    settings.response_format = MenuItem\n\n    # Create agent with plugin and settings\n    agent = ChatCompletionAgent(\n        service=AzureChatCompletion(),\n        name=\"SK-Assistant\",\n        instructions=\"You are a helpful assistant.\",\n        plugins=[MenuPlugin()],\n        arguments=KernelArguments(settings)\n    )\n\n    response = await agent.get_response(messages=\"What is the price of the soup special?\")\n    print(response.content)\n\n    # Output:\n    # The price of the Clam Chowder, which is the soup special, is $9.99.\n\nasyncio.run(main()) \n```\n\n### Agent with Plugin - .NET\n\n```csharp\nusing System.ComponentModel;\nusing Microsoft.SemanticKernel;\nusing Microsoft.SemanticKernel.Agents;\nusing Microsoft.SemanticKernel.ChatCompletion;\n\nvar builder = Kernel.CreateBuilder();\nbuilder.AddAzureOpenAIChatCompletion(\n                Environment.GetEnvironmentVariable(\"AZURE_OPENAI_DEPLOYMENT\"),\n                Environment.GetEnvironmentVariable(\"AZURE_OPENAI_ENDPOINT\"),\n                Environment.GetEnvironmentVariable(\"AZURE_OPENAI_API_KEY\")\n                );\nvar kernel = builder.Build();\n\nkernel.Plugins.Add(KernelPluginFactory.CreateFromType\u003cMenuPlugin\u003e());\n\nChatCompletionAgent agent =\n    new()\n    {\n        Name = \"SK-Assistant\",\n        Instructions = \"You are a helpful assistant.\",\n        Kernel = kernel,\n        Arguments = new KernelArguments(new PromptExecutionSettings() { FunctionChoiceBehavior = FunctionChoiceBehavior.Auto() })\n\n    };\n\nawait foreach (AgentResponseItem\u003cChatMessageContent\u003e response \n    in agent.InvokeAsync(\"What is the price of the soup special?\"))\n{\n    Console.WriteLine(response.Message);\n}\n\nsealed class MenuPlugin\n{\n    [KernelFunction, Description(\"Provides a list of specials from the menu.\")]\n    public string GetSpecials() =\u003e\n        \"\"\"\n        Special Soup: Clam Chowder\n        Special Salad: Cobb Salad\n        Special Drink: Chai Tea\n        \"\"\";\n\n    [KernelFunction, Description(\"Provides the price of the requested menu item.\")]\n    public string GetItemPrice(\n        [Description(\"The name of the menu item.\")]\n        string menuItem) =\u003e\n        \"$9.99\";\n}\n```\n\n### Multi-Agent System - Python\n\nBuild a system of specialized agents that can collaborate:\n\n```python\nimport asyncio\nfrom semantic_kernel.agents import ChatCompletionAgent, ChatHistoryAgentThread\nfrom semantic_kernel.connectors.ai.open_ai import AzureChatCompletion, OpenAIChatCompletion\n\nbilling_agent = ChatCompletionAgent(\n    service=AzureChatCompletion(), \n    name=\"BillingAgent\", \n    instructions=\"You handle billing issues like charges, payment methods, cycles, fees, discrepancies, and payment failures.\"\n)\n\nrefund_agent = ChatCompletionAgent(\n    service=AzureChatCompletion(),\n    name=\"RefundAgent\",\n    instructions=\"Assist users with refund inquiries, including eligibility, policies, processing, and status updates.\",\n)\n\ntriage_agent = ChatCompletionAgent(\n    service=OpenAIChatCompletion(),\n    name=\"TriageAgent\",\n    instructions=\"Evaluate user requests and forward them to BillingAgent or RefundAgent for targeted assistance.\"\n    \" Provide the full answer to the user containing any information from the agents\",\n    plugins=[billing_agent, refund_agent],\n)\n\nthread: ChatHistoryAgentThread = None\n\nasync def main() -\u003e None:\n    print(\"Welcome to the chat bot!\\n  Type 'exit' to exit.\\n  Try to get some billing or refund help.\")\n    while True:\n        user_input = input(\"User:\u003e \")\n\n        if user_input.lower().strip() == \"exit\":\n            print(\"\\n\\nExiting chat...\")\n            return False\n\n        response = await triage_agent.get_response(\n            messages=user_input,\n            thread=thread,\n        )\n\n        if response:\n            print(f\"Agent :\u003e {response}\")\n\n# Agent :\u003e I understand that you were charged twice for your subscription last month, and I'm here to assist you with resolving this issue. Here’s what we need to do next:\n\n# 1. **Billing Inquiry**:\n#    - Please provide the email address or account number associated with your subscription, the date(s) of the charges, and the amount charged. This will allow the billing team to investigate the discrepancy in the charges.\n\n# 2. **Refund Process**:\n#    - For the refund, please confirm your subscription type and the email address associated with your account.\n#    - Provide the dates and transaction IDs for the charges you believe were duplicated.\n\n# Once we have these details, we will be able to:\n\n# - Check your billing history for any discrepancies.\n# - Confirm any duplicate charges.\n# - Initiate a refund for the duplicate payment if it qualifies. The refund process usually takes 5-10 business days after approval.\n\n# Please provide the necessary details so we can proceed with resolving this issue for you.\n\n\nif __name__ == \"__main__\":\n    asyncio.run(main())\n```\n\n\n\n## Where to Go Next\n\n1. 📖 Try our [Getting Started Guide](https://learn.microsoft.com/en-us/semantic-kernel/get-started/quick-start-guide) or learn about [Building Agents](https://learn.microsoft.com/en-us/semantic-kernel/frameworks/agent/)\n2. 🔌 Explore over 100 [Detailed Samples](https://learn.microsoft.com/en-us/semantic-kernel/get-started/detailed-samples)\n3. 💡 Learn about core Semantic Kernel [Concepts](https://learn.microsoft.com/en-us/semantic-kernel/concepts/kernel)\n\n### API References\n\n- [C# API reference](https://learn.microsoft.com/en-us/dotnet/api/microsoft.semantickernel?view=semantic-kernel-dotnet)\n- [Python API reference](https://learn.microsoft.com/en-us/python/api/semantic-kernel/semantic_kernel?view=semantic-kernel-python)\n\n## Troubleshooting\n\n### Common Issues\n\n- **Authentication Errors**: Check that your API key environment variables are correctly set\n- **Model Availability**: Verify your Azure OpenAI deployment or OpenAI model access\n\n### Getting Help\n\n- Check our [GitHub issues](https://github.com/microsoft/semantic-kernel/issues) for known problems\n- Search the [Discord community](https://aka.ms/SKDiscord) for solutions\n- Include your SDK version and full error messages when asking for help\n\n\n## Join the community\n\nWe welcome your contributions and suggestions to the SK community! One of the easiest ways to participate is to engage in discussions in the GitHub repository. Bug reports and fixes are welcome!\n\nFor new features, components, or extensions, please open an issue and discuss with us before sending a PR. This is to avoid rejection as we might be taking the core in a different direction, but also to consider the impact on the larger ecosystem.\n\nTo learn more and get started:\n\n- Read the [documentation](https://aka.ms/sk/learn)\n- Learn how to [contribute](https://learn.microsoft.com/en-us/semantic-kernel/support/contributing) to the project\n- Ask questions in the [GitHub discussions](https://github.com/microsoft/semantic-kernel/discussions)\n- Ask questions in the [Discord community](https://aka.ms/SKDiscord)\n\n- Attend [regular office hours and SK community events](COMMUNITY.md)\n- Follow the team on our [blog](https://aka.ms/sk/blog)\n\n## Contributor Wall of Fame\n\n[![semantic-kernel contributors](https://contrib.rocks/image?repo=microsoft/semantic-kernel)](https://github.com/microsoft/semantic-kernel/graphs/contributors)\n\n## Code of Conduct\n\nThis project has adopted the\n[Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information, see the\n[Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/)\nor contact [opencode@microsoft.com](mailto:opencode@microsoft.com)\nwith any additional questions or comments.\n\n## License\n\nCopyright (c) Microsoft Corporation. All rights reserved.\n\nLicensed under the [MIT](LICENSE) license.\n","funding_links":[],"categories":["Applications","LLM Frameworks","Projects","C# #","ai","Prompting libraries \u0026 tools","NLP","Patterns","Large Language Models (LLMs)","C\\#","A01_文本生成_文本对话","LLM Applications","App","Agents \u0026 Orchestration","Other LLM Frameworks","Prompting libraries \u0026 tools (in alphabetical order)","Frameworks","Projects and Tools","Semantic Kernel","🤖 AI Agents","C#","其他LLM框架","Building","Industry Strength Natural Language Processing","Repos","🧰 Frameworks that Facilitate RAG","Evaluation","🧱 Agent Frameworks","Plugins","AI Frameworks and SDKs","Tool Integration","Related Technologies","Tools \u0026 Frameworks","AI Agent Frameworks \u0026 SDKs","🛠 Development Frameworks","🤖 Autonomous AI Agents","AI Frameworks \u0026 SDKs","🚀 Specialized Agents","Table of Open-Source AI Agents Projects","Orchestration","Tools and Code","Agent Frameworks","📋 List of Open-Source Projects","Frameworks \u0026 Libraries","Open Source Tools","🧩 Agent Frameworks \u0026 Dev Libraries","🛠️ Agentic AI Frameworks"],"sub_categories":["Standalone App","Contribute to our Repository","大语言对话模型及数据","Agent Frameworks","Videos Playlists","LLM (Large Language Model)","Teams","Frameworks \u0026 Libraries","文章","LLM Models","Industry Products","General Purpose","Common Lisp","LangManus","Microsoft AI Ecosystem","Development Tools","Orchestration Frameworks","High-Level Application Frameworks","Prompt Generator","🗣️ Programming Language Agents","Application Frameworks","Agents","Multi-Agent Orchestration","Agent Framework","🤖 Multi-Agent Platforms"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmicrosoft%2Fsemantic-kernel","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmicrosoft%2Fsemantic-kernel","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmicrosoft%2Fsemantic-kernel/lists"}