lingya-agents-sdk 0.4.0__tar.gz

lingya_agents_sdk-0.4.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Lingya AI
+
+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.

lingya_agents_sdk-0.4.0/MANIFEST.in

@@ -0,0 +1,4 @@
+prune test
+prune build
+prune dist
+global-exclude __pycache__ *.py[cod]

lingya_agents_sdk-0.4.0/PKG-INFO

@@ -0,0 +1,99 @@
+Metadata-Version: 2.4
+Name: lingya-agents-sdk
+Version: 0.4.0
+Summary: Strongly typed Python SDK for Lingya Agents OpenAPI
+Author: Lingya AI
+License-Expression: MIT
+Project-URL: Repository, https://github.com/lingya-ai/lingya-agents-sdk-python
+Project-URL: Issues, https://github.com/lingya-ai/lingya-agents-sdk-python/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx<1,>=0.28
+Requires-Dist: pydantic<3,>=2.11
+Requires-Dist: python-dateutil>=2.8.2
+Requires-Dist: typing-extensions>=4.12
+Provides-Extra: test
+Requires-Dist: build>=1.2; extra == "test"
+Requires-Dist: mypy>=1.17; extra == "test"
+Requires-Dist: pytest>=8.4; extra == "test"
+Requires-Dist: ruff>=0.12; extra == "test"
+Requires-Dist: setuptools>=75; extra == "test"
+Requires-Dist: wheel; extra == "test"
+Dynamic: license-file
+
+# 灵涯 Agents Python SDK
+Lingya Agents SDK for Python
+
+用于在 Python 可信服务端调用灵涯 Agents OpenAPI。
+Use this SDK to call Lingya Agents OpenAPI from a trusted Python server.
+
+## 安装
+Installation
+
+```bash
+pip install lingya-agents-sdk==0.4.0
+```
+
+## 快速开始
+Quick start
+
+```python
+import os
+
+from lingya_agents_sdk import AgentsClient, OpenApiCredentials
+from lingya_agents_sdk.models.ai_chat_input import AiChatInput
+
+client = AgentsClient(
+    "https://lingtong.lingya.tech/",
+    os.environ["OPENAPI_CHANNEL_ID"],
+    OpenApiCredentials(
+        os.environ["OPENAPI_AK"],
+        os.environ["OPENAPI_SK"],
+    ),
+)
+
+with client.for_user("external-user-id") as user:
+    submission = user.chat.create_chat(AiChatInput(query="你好"))
+```
+
+`channel_id` 只在创建 `AgentsClient` 时提供，业务方法不再接收它。
+Provide `channel_id` only when creating `AgentsClient`; business methods do not accept it.
+
+## SSE 事件流
+SSE event stream
+
+```python
+from lingya_agents_sdk.models.ai_chat_stream_input import AiChatStreamInput
+
+with client.for_user("external-user-id") as user:
+    for event in user.chat.stream_chat_events(
+        submission.conversation_id,
+        AiChatStreamInput(message_id=submission.message_id),
+    ):
+        print(event.type)
+```
+
+## API 分组
+API groups
+
+可用分组为 `chat`、`configuration`、`conversations`、`events`、`files`、`interactions`、`knowledge`、`messages`、`sql` 和 `workspace`。
+Available groups are `chat`, `configuration`, `conversations`, `events`, `files`, `interactions`, `knowledge`, `messages`, `sql`, and `workspace`.
+
+## 错误处理
+Error handling
+
+```python
+from lingya_agents_sdk import ApiError
+
+try:
+    user.conversations.get_conversation_title("conversation-id")
+except ApiError as error:
+    print(error.status_code, error.response_body)
+```
+
+请只在可信服务端保存 `secret_key`，不要将其放入浏览器、移动端、桌面端或日志。
+Keep `secret_key` on trusted servers only; never put it in browsers, mobile apps, desktop apps, or logs.

lingya_agents_sdk-0.4.0/README.md

@@ -0,0 +1,72 @@
+# 灵涯 Agents Python SDK
+Lingya Agents SDK for Python
+
+用于在 Python 可信服务端调用灵涯 Agents OpenAPI。
+Use this SDK to call Lingya Agents OpenAPI from a trusted Python server.
+
+## 安装
+Installation
+
+```bash
+pip install lingya-agents-sdk==0.4.0
+```
+
+## 快速开始
+Quick start
+
+```python
+import os
+
+from lingya_agents_sdk import AgentsClient, OpenApiCredentials
+from lingya_agents_sdk.models.ai_chat_input import AiChatInput
+
+client = AgentsClient(
+    "https://lingtong.lingya.tech/",
+    os.environ["OPENAPI_CHANNEL_ID"],
+    OpenApiCredentials(
+        os.environ["OPENAPI_AK"],
+        os.environ["OPENAPI_SK"],
+    ),
+)
+
+with client.for_user("external-user-id") as user:
+    submission = user.chat.create_chat(AiChatInput(query="你好"))
+```
+
+`channel_id` 只在创建 `AgentsClient` 时提供，业务方法不再接收它。
+Provide `channel_id` only when creating `AgentsClient`; business methods do not accept it.
+
+## SSE 事件流
+SSE event stream
+
+```python
+from lingya_agents_sdk.models.ai_chat_stream_input import AiChatStreamInput
+
+with client.for_user("external-user-id") as user:
+    for event in user.chat.stream_chat_events(
+        submission.conversation_id,
+        AiChatStreamInput(message_id=submission.message_id),
+    ):
+        print(event.type)
+```
+
+## API 分组
+API groups
+
+可用分组为 `chat`、`configuration`、`conversations`、`events`、`files`、`interactions`、`knowledge`、`messages`、`sql` 和 `workspace`。
+Available groups are `chat`, `configuration`, `conversations`, `events`, `files`, `interactions`, `knowledge`, `messages`, `sql`, and `workspace`.
+
+## 错误处理
+Error handling
+
+```python
+from lingya_agents_sdk import ApiError
+
+try:
+    user.conversations.get_conversation_title("conversation-id")
+except ApiError as error:
+    print(error.status_code, error.response_body)
+```
+
+请只在可信服务端保存 `secret_key`，不要将其放入浏览器、移动端、桌面端或日志。
+Keep `secret_key` on trusted servers only; never put it in browsers, mobile apps, desktop apps, or logs.

lingya_agents_sdk-0.4.0/lingya_agents_sdk/__init__.py

@@ -0,0 +1,72 @@
+"""Lingya Agents Python SDK public API."""
+
+from lingya_agents_sdk.bound_api import (
+    ChatApi,
+    ConfigurationApi,
+    ConversationsApi,
+    EventsApi,
+    FilesApi,
+    InteractionsApi,
+    KnowledgeApi,
+    MessagesApi,
+    SqlApi,
+    WorkspaceApi,
+)
+from lingya_agents_sdk.client import (
+    AgentsClient,
+    AgentsUserClient,
+    ApiError,
+    OpenApiCredentials,
+    QueryParameter,
+)
+from lingya_agents_sdk.events import AiChatBriefEvent, ToolExtension, decode_ai_chat_brief_event, decode_tool_extension
+
+LingyaAgentsClient = AgentsClient
+LingyaAgentsUserClient = AgentsUserClient
+LingyaApiError = ApiError
+LingyaChatApi = ChatApi
+LingyaConfigurationApi = ConfigurationApi
+LingyaConversationsApi = ConversationsApi
+LingyaEventsApi = EventsApi
+LingyaFilesApi = FilesApi
+LingyaInteractionsApi = InteractionsApi
+LingyaKnowledgeApi = KnowledgeApi
+LingyaMessagesApi = MessagesApi
+LingyaSqlApi = SqlApi
+LingyaWorkspaceApi = WorkspaceApi
+
+__version__ = "0.4.0"
+__all__ = [
+    "AgentsClient",
+    "AgentsUserClient",
+    "AiChatBriefEvent",
+    "ApiError",
+    "ChatApi",
+    "ConfigurationApi",
+    "ConversationsApi",
+    "EventsApi",
+    "FilesApi",
+    "InteractionsApi",
+    "KnowledgeApi",
+    "MessagesApi",
+    "SqlApi",
+    "WorkspaceApi",
+    "LingyaAgentsClient",
+    "LingyaAgentsUserClient",
+    "LingyaChatApi",
+    "LingyaConfigurationApi",
+    "LingyaConversationsApi",
+    "LingyaEventsApi",
+    "LingyaFilesApi",
+    "LingyaInteractionsApi",
+    "LingyaKnowledgeApi",
+    "LingyaMessagesApi",
+    "LingyaSqlApi",
+    "LingyaWorkspaceApi",
+    "LingyaApiError",
+    "OpenApiCredentials",
+    "QueryParameter",
+    "ToolExtension",
+    "decode_ai_chat_brief_event",
+    "decode_tool_extension",
+]