semantic-kernel 1.8.3__zip

semantic_kernel-1.8.3/LICENSE

@@ -0,0 +1,21 @@
+    MIT License
+
+    Copyright (c) Microsoft Corporation.
+
+    Permission is hereby granted, free of charge, to any person obtaining a copy
+    of this software and associated documentation files (the "Software"), to deal
+    in the Software without restriction, including without limitation the rights
+    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+    copies of the Software, and to permit persons to whom the Software is
+    furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in all
+    copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+    SOFTWARE

semantic_kernel-1.8.3/PKG-INFO

@@ -0,0 +1,101 @@
+Metadata-Version: 2.1
+Name: semantic-kernel
+Version: 1.8.3
+Summary: Semantic Kernel Python SDK
+Author-email: Microsoft <SK-Support@microsoft.com>
+Requires-Python: >=3.10,<3.13
+Description-Content-Type: text/markdown
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Framework :: Pydantic :: 2
+Classifier: Typing :: Typed
+Requires-Dist: aiohttp ~= 3.8
+Requires-Dist: pydantic ~= 2.0
+Requires-Dist: pydantic-settings ~= 2.0
+Requires-Dist: defusedxml ~= 0.7
+Requires-Dist: numpy ~= 1.25.0; python_version < '3.12'
+Requires-Dist: numpy ~= 1.26.0; python_version >= '3.12'
+Requires-Dist: openai ~= 1.0
+Requires-Dist: openapi_core >= 0.18,<0.20
+Requires-Dist: opentelemetry-api ~= 1.24
+Requires-Dist: opentelemetry-sdk ~= 1.24
+Requires-Dist: prance ~= 23.6.21.0
+Requires-Dist: pybars4 ~= 0.9
+Requires-Dist: jinja2 ~= 3.1
+Requires-Dist: nest-asyncio ~= 1.6
+Requires-Dist: anthropic ~= 0.32 ; extra == "anthropic"
+Requires-Dist: azure-ai-inference >= 1.0.0b3 ; extra == "azure"
+Requires-Dist: azure-search-documents >= 11.6.0b4 ; extra == "azure"
+Requires-Dist: azure-identity ~= 1.13 ; extra == "azure"
+Requires-Dist: azure-cosmos ~= 4.7 ; extra == "azure"
+Requires-Dist: chromadb >= 0.4,<0.6 ; extra == "chroma"
+Requires-Dist: google-cloud-aiplatform ~= 1.60 ; extra == "google"
+Requires-Dist: google-generativeai ~= 0.7 ; extra == "google"
+Requires-Dist: transformers[torch] ~= 4.28 ; extra == "hugging_face"
+Requires-Dist: sentence-transformers ~= 2.2 ; extra == "hugging_face"
+Requires-Dist: torch == 2.2.2 ; extra == "hugging_face"
+Requires-Dist: pymilvus >= 2.3,<2.4 ; extra == "milvus"
+Requires-Dist: milvus >= 2.3,<2.3.8 ; extra == "milvus" and ( platform_system != 'Windows')
+Requires-Dist: mistralai ~= 0.4 ; extra == "mistralai"
+Requires-Dist: motor ~= 3.3.2 ; extra == "mongo"
+Requires-Dist: ipykernel ~= 6.29 ; extra == "notebooks"
+Requires-Dist: ollama ~= 0.2 ; extra == "ollama"
+Requires-Dist: pandas ~= 2.2 ; extra == "pandas"
+Requires-Dist: pinecone-client ~= 5.0 ; extra == "pinecone"
+Requires-Dist: psycopg[binary,pool] ~= 3.2 ; extra == "postgres"
+Requires-Dist: qdrant-client ~= 1.9 ; extra == "qdrant"
+Requires-Dist: redis[hiredis] ~= 5.0 ; extra == "redis"
+Requires-Dist: types-redis ~= 4.6.0.20240425 ; extra == "redis"
+Requires-Dist: usearch ~= 2.9 ; extra == "usearch"
+Requires-Dist: pyarrow >= 12.0,<18.0 ; extra == "usearch"
+Requires-Dist: weaviate-client >= 3.18,<5.0 ; extra == "weaviate"
+Project-URL: homepage, https://learn.microsoft.com/en-us/semantic-kernel/overview/
+Project-URL: issues, https://github.com/microsoft/semantic-kernel/issues
+Project-URL: release_notes, https://github.com/microsoft/semantic-kernel/releases?q=tag%3Apython-1&expanded=true
+Project-URL: source, https://github.com/microsoft/semantic-kernel/tree/main/python
+Provides-Extra: anthropic
+Provides-Extra: azure
+Provides-Extra: chroma
+Provides-Extra: google
+Provides-Extra: hugging_face
+Provides-Extra: milvus
+Provides-Extra: mistralai
+Provides-Extra: mongo
+Provides-Extra: notebooks
+Provides-Extra: ollama
+Provides-Extra: pandas
+Provides-Extra: pinecone
+Provides-Extra: postgres
+Provides-Extra: qdrant
+Provides-Extra: redis
+Provides-Extra: usearch
+Provides-Extra: weaviate
+
+# About Semantic Kernel
+
+**Semantic Kernel (SK)** is a lightweight SDK enabling integration of AI Large
+Language Models (LLMs) with conventional programming languages. The SK
+extensible programming model combines natural language **semantic functions**,
+traditional code **native functions**, and **embeddings-based memory** unlocking
+new potential and adding value to applications with AI.
+
+Semantic Kernel incorporates cutting-edge design patterns from the latest in AI
+research. This enables developers to augment their applications with advanced
+capabilities, such as prompt engineering, prompt chaining, retrieval-augmented
+generation, contextual and long-term vectorized memory, embeddings,
+summarization, zero or few-shot learning, semantic indexing, recursive
+reasoning, intelligent planning, and access to external knowledge stores and
+proprietary data.
+
+# Getting Started ⚡
+
+- Learn more at the [documentation site](https://aka.ms/SK-Docs).
+- Join the [Discord community](https://aka.ms/SKDiscord).
+- Follow the team on [Semantic Kernel blog](https://aka.ms/sk/blog).
+- Check out the [GitHub repository](https://github.com/microsoft/semantic-kernel) for the latest updates.
+

semantic_kernel-1.8.3/pip/README.md

@@ -0,0 +1,22 @@
+# About Semantic Kernel
+
+**Semantic Kernel (SK)** is a lightweight SDK enabling integration of AI Large
+Language Models (LLMs) with conventional programming languages. The SK
+extensible programming model combines natural language **semantic functions**,
+traditional code **native functions**, and **embeddings-based memory** unlocking
+new potential and adding value to applications with AI.
+
+Semantic Kernel incorporates cutting-edge design patterns from the latest in AI
+research. This enables developers to augment their applications with advanced
+capabilities, such as prompt engineering, prompt chaining, retrieval-augmented
+generation, contextual and long-term vectorized memory, embeddings,
+summarization, zero or few-shot learning, semantic indexing, recursive
+reasoning, intelligent planning, and access to external knowledge stores and
+proprietary data.
+
+# Getting Started ⚡
+
+- Learn more at the [documentation site](https://aka.ms/SK-Docs).
+- Join the [Discord community](https://aka.ms/SKDiscord).
+- Follow the team on [Semantic Kernel blog](https://aka.ms/sk/blog).
+- Check out the [GitHub repository](https://github.com/microsoft/semantic-kernel) for the latest updates.

semantic_kernel-1.8.3/pyproject.toml

@@ -0,0 +1,200 @@
+[project]
+name = "semantic-kernel"
+description = "Semantic Kernel Python SDK"
+authors = [{ name = "Microsoft", email = "SK-Support@microsoft.com"}]
+readme = "pip/README.md"
+# Version read from __version__ field in __init__.py by Flit
+dynamic = ["version"]
+requires-python = ">=3.10,<3.13"
+license = {file = "LICENSE"}
+urls.homepage = "https://learn.microsoft.com/en-us/semantic-kernel/overview/"
+urls.source = "https://github.com/microsoft/semantic-kernel/tree/main/python"
+urls.release_notes = "https://github.com/microsoft/semantic-kernel/releases?q=tag%3Apython-1&expanded=true"
+urls.issues = "https://github.com/microsoft/semantic-kernel/issues"
+classifiers = [
+  "License :: OSI Approved :: MIT License",
+  "Development Status :: 5 - Production/Stable",
+  "Intended Audience :: Developers",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Framework :: Pydantic :: 2",
+  "Typing :: Typed",
+]
+dependencies = [
+    "aiohttp ~= 3.8",
+    "pydantic ~= 2.0",
+    "pydantic-settings ~= 2.0",
+    "defusedxml ~= 0.7",
+
+    # embeddings
+    "numpy ~= 1.25.0; python_version < '3.12'",
+    "numpy ~= 1.26.0; python_version >= '3.12'",
+
+    # openai connector
+    "openai ~= 1.0",
+
+    # openapi and swagger
+    "openapi_core >= 0.18,<0.20",
+
+    # OpenTelemetry
+    "opentelemetry-api ~= 1.24",
+    "opentelemetry-sdk ~= 1.24",
+
+    "prance ~= 23.6.21.0",
+
+    # templating
+    "pybars4 ~= 0.9",
+    "jinja2 ~= 3.1",
+    "nest-asyncio ~= 1.6"
+]
+
+### Optional dependencies
+[project.optional-dependencies]
+azure = [
+    "azure-ai-inference >= 1.0.0b3",
+    "azure-search-documents >= 11.6.0b4",
+    "azure-identity ~= 1.13",
+    "azure-cosmos ~= 4.7"
+]
+chroma = [
+    "chromadb >= 0.4,<0.6"
+]
+google = [
+    "google-cloud-aiplatform ~= 1.60",
+    "google-generativeai ~= 0.7"
+]
+hugging_face = [
+    "transformers[torch] ~= 4.28",
+    "sentence-transformers ~= 2.2",
+    "torch == 2.2.2"
+]
+mongo = [
+    "motor ~= 3.3.2"
+]
+notebooks = [
+    "ipykernel ~= 6.29"
+]
+milvus = [
+    "pymilvus >= 2.3,<2.4",
+    "milvus >= 2.3,<2.3.8; platform_system != 'Windows'"
+]
+mistralai = [
+    "mistralai ~= 0.4"
+]
+ollama = [
+    "ollama ~= 0.2"
+]
+anthropic = [
+    "anthropic ~= 0.32"
+]
+pinecone = [
+    "pinecone-client ~= 5.0"
+]
+postgres = [
+    "psycopg[binary,pool] ~= 3.2"
+]
+qdrant = [
+    "qdrant-client ~= 1.9"
+]
+redis = [
+    "redis[hiredis] ~= 5.0",
+    "types-redis ~= 4.6.0.20240425"
+]
+usearch = [
+    "usearch ~= 2.9",
+    "pyarrow >= 12.0,<18.0"
+]
+weaviate = [
+    "weaviate-client >= 3.18,<5.0"
+]
+pandas = [
+    "pandas ~= 2.2"
+]
+
+[tool.uv]
+prerelease = "if-necessary-or-explicit"
+dev-dependencies = [
+    "pre-commit ~= 3.7",
+    "ipykernel ~= 6.29",
+    "nbconvert ~= 7.16",
+    "pytest ~= 8.2",
+    "pytest-xdist[psutil] ~= 3.6",
+    "pytest-cov >= 5.0",
+    "pytest-asyncio ~= 0.23",
+    "snoop ~= 0.4",
+    "mypy >= 1.10",
+    "types-PyYAML ~= 6.0.12.20240311",
+    "ruff ~= 0.5"
+]
+environments = [
+    "sys_platform == 'darwin'",
+    "sys_platform == 'linux'",
+    "sys_platform == 'win32'"
+]
+
+[tool.pytest.ini_options]
+addopts = "-ra -q -r fEX"
+
+[tool.ruff]
+line-length = 120
+target-version = "py310"
+include = ["*.py", "*.pyi", "**/pyproject.toml", "*.ipynb"]
+preview = true
+
+[tool.ruff.lint]
+fixable = ["ALL"]
+unfixable = []
+select = [
+    "D", #pydocstyle checks
+    "E", #error checks
+    "F", #pyflakes checks
+    "I", #isort
+    "CPY", #copyright
+    "ISC", #implicit string concat
+    "INP", #implicit namespace package
+    "RSE", #raise exception parantheses check
+    "RET", #flake8-return check
+    "SIM", #flake8-simplify check
+    "TD", #todos
+    "FIX", #fixme checks 
+    "ERA", #remove connected out code
+    "RUF" #RUF specific rules
+]
+ignore = [
+    "D100", #allow missing docstring in public module
+    "D104", #allow missing docstring in public package
+    "TD003", #allow missing link to todo issue
+    "FIX002" #allow todo
+]
+
+[tool.ruff.format]
+docstring-code-format = true
+
+[tool.ruff.lint.pydocstyle]
+convention = "google"
+
+[tool.ruff.lint.per-file-ignores]
+# Ignore all directories named `tests` and `samples`.
+"tests/**" = ["D", "INP", "TD", "ERA001", "RUF"]
+"samples/**" = ["D", "INP", "ERA001", "RUF"]
+# Ignore all files that end in `_test.py`.
+"*_test.py" = ["D"]
+"*.ipynb" = ["CPY", "E501"]
+
+[tool.ruff.lint.flake8-copyright]
+notice-rgx = "^# Copyright \\(c\\) Microsoft\\. All rights reserved\\."
+min-file-size = 1
+
+[tool.bandit]
+targets = ["semantic_kernel"]
+exclude_dirs = ["tests"]
+
+[tool.flit.module]
+name = "semantic_kernel"
+
+[build-system]
+requires = ["flit-core >= 3.9,<4.0"]
+build-backend = "flit_core.buildapi"
+

semantic_kernel-1.8.3/semantic_kernel/__init__.py

@@ -0,0 +1,6 @@
+# Copyright (c) Microsoft. All rights reserved.
+
+from semantic_kernel.kernel import Kernel
+
+__version__ = "1.8.3"
+__all__ = ["Kernel", "__version__"]

semantic_kernel-1.8.3/semantic_kernel/agents/__init__.py

@@ -0,0 +1,13 @@
+# Copyright (c) Microsoft. All rights reserved.
+
+from semantic_kernel.agents.agent import Agent
+from semantic_kernel.agents.chat_completion.chat_completion_agent import ChatCompletionAgent
+from semantic_kernel.agents.group_chat.agent_chat import AgentChat
+from semantic_kernel.agents.group_chat.agent_group_chat import AgentGroupChat
+
+__all__ = [
+    "Agent",
+    "AgentChat",
+    "AgentGroupChat",
+    "ChatCompletionAgent",
+]

semantic_kernel-1.8.3/semantic_kernel/agents/agent.py

@@ -0,0 +1,74 @@
+# Copyright (c) Microsoft. All rights reserved.
+
+import uuid
+from collections.abc import Iterable
+from typing import ClassVar
+
+from pydantic import Field
+
+from semantic_kernel.agents.channels.agent_channel import AgentChannel
+from semantic_kernel.kernel import Kernel
+from semantic_kernel.kernel_pydantic import KernelBaseModel
+from semantic_kernel.utils.experimental_decorator import experimental_class
+from semantic_kernel.utils.naming import generate_random_ascii_name
+
+
+@experimental_class
+class Agent(KernelBaseModel):
+    """Base abstraction for all Semantic Kernel agents.
+
+    An agent instance may participate in one or more conversations.
+    A conversation may include one or more agents.
+    In addition to identity and descriptive meta-data, an Agent
+    must define its communication protocol, or AgentChannel.
+
+    Attributes:
+        name: The name of the agent (optional).
+        description: The description of the agent (optional).
+        id: The unique identifier of the agent (optional). If no id is provided,
+            a new UUID will be generated.
+        instructions: The instructions for the agent (optional
+    """
+
+    id: str = Field(default_factory=lambda: str(uuid.uuid4()))
+    description: str | None = None
+    name: str = Field(default_factory=lambda: f"agent_{generate_random_ascii_name()}")
+    instructions: str | None = None
+    kernel: Kernel = Field(default_factory=Kernel)
+    channel_type: ClassVar[type[AgentChannel] | None] = None
+
+    def get_channel_keys(self) -> Iterable[str]:
+        """Get the channel keys.
+
+        Returns:
+            A list of channel keys.
+        """
+        if not self.channel_type:
+            raise NotImplementedError("Unable to get channel keys. Channel type not configured.")
+        return [self.channel_type.__name__]
+
+    async def create_channel(self) -> AgentChannel:
+        """Create a channel.
+
+        Returns:
+            An instance of AgentChannel.
+        """
+        if not self.channel_type:
+            raise NotImplementedError("Unable to create channel. Channel type not configured.")
+        return self.channel_type()
+
+    def __eq__(self, other):
+        """Check if two agents are equal."""
+        if isinstance(other, Agent):
+            return (
+                self.id == other.id
+                and self.name == other.name
+                and self.description == other.description
+                and self.instructions == other.instructions
+                and self.channel_type == other.channel_type
+            )
+        return False
+
+    def __hash__(self):
+        """Get the hash of the agent."""
+        return hash((self.id, self.name, self.description, self.instructions, self.channel_type))

semantic_kernel-1.8.3/semantic_kernel/agents/channels/agent_channel.py

@@ -0,0 +1,64 @@
+# Copyright (c) Microsoft. All rights reserved.
+
+from abc import ABC, abstractmethod
+from collections.abc import AsyncIterable
+from typing import TYPE_CHECKING
+
+from semantic_kernel.utils.experimental_decorator import experimental_class
+
+if TYPE_CHECKING:
+    from semantic_kernel.agents.agent import Agent
+    from semantic_kernel.contents.chat_message_content import ChatMessageContent
+
+
+@experimental_class
+class AgentChannel(ABC):
+    """Defines the communication protocol for a particular Agent type.
+
+    An agent provides it own AgentChannel via CreateChannel.
+    """
+
+    @abstractmethod
+    async def receive(
+        self,
+        history: list["ChatMessageContent"],
+    ) -> None:
+        """Receive the conversation messages.
+
+        Used when joining a conversation and also during each agent interaction.
+
+        Args:
+            history: The history of messages in the conversation.
+        """
+        ...
+
+    @abstractmethod
+    def invoke(
+        self,
+        agent: "Agent",
+    ) -> AsyncIterable[tuple[bool, "ChatMessageContent"]]:
+        """Perform a discrete incremental interaction between a single Agent and AgentChat.
+
+        Args:
+            agent: The agent to interact with.
+
+        Returns:
+            A async iterable of a bool, ChatMessageContent.
+        """
+        ...
+
+    @abstractmethod
+    def get_history(
+        self,
+    ) -> AsyncIterable["ChatMessageContent"]:
+        """Retrieve the message history specific to this channel.
+
+        Returns:
+            An async iterable of ChatMessageContent.
+        """
+        ...
+
+    @abstractmethod
+    async def reset(self) -> None:
+        """Reset any persistent state associated with the channel."""
+        ...