agent-lab-sdk 0.1.15__tar.gz → 0.1.16__tar.gz

{agent_lab_sdk-0.1.15 → agent_lab_sdk-0.1.16}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-lab-sdk
-Version: 0.1.15
+Version: 0.1.16
 Summary: SDK для работы с Agent Lab
 Author-email: Andrew Ohurtsov <andermirik@yandex.com>
 License: Proprietary and Confidential — All Rights Reserved
@@ -68,8 +68,6 @@ model = get_model(
 
 > если не передавать access_token, токен будет выбран через GigaChatTokenManager
 
-> планы на ближайшее будущее: get_model оборачивает внутри себя throttled классы.
-
 ### 1.2. Менеджеры токенов
 
 | Класс                  | Описание                                                                                | Пример использования                            |
@@ -95,8 +93,6 @@ model = get_model(
 
 ---
 
-<a name="throttled"></a>
-
 ## 2. Модуль `agent_lab_sdk.llm.throttled`
 
 Позволяет ограничивать число одновременных вызовов к GigaChat и сервису эмбеддингов, автоматически собирая соответствующие метрики.
@@ -139,8 +135,6 @@ vectors = emb.embed_documents(["Text1", "Text2"])
 
 ---
 
-<a name="metrics"></a>
-
 ## 3. Модуль `agent_lab_sdk.metrics`
 
 Предоставляет удобный интерфейс для создания и управления метриками через Prometheus-клиент.
@@ -211,6 +205,126 @@ AGW поддерживает langgraph checkpoint API и в SDK представ
 
 ## 5. Схема
 
+### 5.1. Типы входных данных
+
+Модуль `agent_lab_sdk.schema.input_types` предоставляет фабричные функции для создания аннотированных типов полей, которые могут использоваться в Pydantic моделях для описания интерфейса агентов.
+
+#### Основные типы полей
+
+```python
+from typing import List, Annotated
+from pydantic import BaseModel, Field
+from agent_lab_sdk.schema import (
+    MainInput, StringInput, StringArrayInput, NumberInput,
+    SelectInput, CheckboxInput, FileInput, FilesInput, SelectOption
+)
+
+class AgentState(BaseModel):
+    # Основное поле ввода
+    query: Annotated[str, MainInput(placeholder="Введите ваш запрос")]
+    
+    # Строковое поле
+    title: Annotated[str, StringInput(
+        default="Без названия",
+        title="Заголовок",
+        description="Название для вашего запроса"
+    )]
+    
+    # Массив строк
+    keywords: Annotated[List[str], StringArrayInput(
+        placeholder="Добавьте ключевые слова...",
+        title="Ключевые слова",
+        description="Список ключевых слов для поиска",
+        group="Параметры"
+    )]
+    
+    # Числовое поле
+    temperature: Annotated[float, NumberInput(
+        default=0.7,
+        title="Температура",
+        description="Параметр креативности модели (0.0 - 1.0)",
+        hidden=True
+    )]
+    
+    # Выпадающий список
+    mode: Annotated[str, SelectInput(
+        title="Режим работы",
+        items=[
+            SelectOption(label="Быстрый", value="fast").model_dump(),
+            SelectOption(label="Точный", value="precise").model_dump()
+        ],
+        default="fast",
+        group="Настройки"
+    )]
+    
+    # Чекбокс
+    save_history: Annotated[bool, CheckboxInput(
+        title="Сохранять историю",
+        description="Сохранять диалог для последующего анализа",
+        default=True,
+        group="Опции"
+    )]
+    
+    # Загрузка одного файла
+    document: Annotated[str, FileInput(
+        title="Документ",
+        file_extensions=".pdf,.docx,.txt"
+    )]
+    
+    # Загрузка нескольких файлов
+    attachments: Annotated[List[str], FilesInput(
+        title="Прикрепленные файлы",
+        file_extensions=".pdf,.csv,.xlsx",
+        group="Файлы"
+    )]
+```
+
+#### Доступные фабричные функции
+
+| Тип                | Описание                              | Основные параметры                                    |
+|--------------------| ------------------------------------- | ----------------------------------------------------- |
+| `MainInput`        | Основное поле ввода                   | `placeholder`                                         |
+| `StringInput`      | Текстовое поле                        | `default`, `title`, `description`, `hidden`          |
+| `StringArrayInput` | Массив строк                          | `placeholder`, `title`, `description`, `group`, `hidden` |
+| `NumberInput`      | Числовое поле                         | `default`, `title`, `description`, `hidden`          |
+| `SelectInput`      | Выпадающий список                     | `items`, `title`, `group`, `default`, `hidden`        |
+| `CheckboxInput`    | Чекбокс                               | `title`, `group`, `description`, `default`, `hidden`  |
+| `FileInput`        | Загрузка одного файла                 | `title`, `file_extensions`, `group`, `hidden`         |
+| `FilesInput`       | Загрузка нескольких файлов            | `title`, `file_extensions`, `group`, `hidden`         |
+
+#### Группировка полей
+
+Используйте параметр `group` для логической группировки полей в интерфейсе:
+
+```python
+class TaskConfig(BaseModel):
+    # Группа "Основные параметры"
+    task_type: Annotated[str, SelectInput(
+        title="Тип задачи",
+        items=[...],
+        group="Основные параметры"
+    )]
+    
+    priority: Annotated[str, SelectInput(
+        title="Приоритет",
+        items=[...],
+        group="Основные параметры"
+    )]
+    
+    # Группа "Дополнительно"
+    notifications: Annotated[bool, CheckboxInput(
+        title="Уведомления",
+        group="Дополнительно"
+    )]
+    
+    tags: Annotated[List[str], StringArrayInput(
+        placeholder="Теги...",
+        group="Дополнительно"
+    )]
+```
+
+### 5.2. LogMessage
+
 TODO: описание LogMessage
 
 ## 6. Сборка и публикация
@@ -236,7 +350,3 @@ python -m build && python -m twine upload dist/*
 ```bash
 pip install -e .
 ```
-
-# Примеры использования
-
-TBD

{agent_lab_sdk-0.1.15 → agent_lab_sdk-0.1.16}/README.md

@@ -39,8 +39,6 @@ model = get_model(
 
 > если не передавать access_token, токен будет выбран через GigaChatTokenManager
 
-> планы на ближайшее будущее: get_model оборачивает внутри себя throttled классы.
-
 ### 1.2. Менеджеры токенов
 
 | Класс                  | Описание                                                                                | Пример использования                            |
@@ -66,8 +64,6 @@ model = get_model(
 
 ---
 
-<a name="throttled"></a>
-
 ## 2. Модуль `agent_lab_sdk.llm.throttled`
 
 Позволяет ограничивать число одновременных вызовов к GigaChat и сервису эмбеддингов, автоматически собирая соответствующие метрики.
@@ -110,8 +106,6 @@ vectors = emb.embed_documents(["Text1", "Text2"])
 
 ---
 
-<a name="metrics"></a>
-
 ## 3. Модуль `agent_lab_sdk.metrics`
 
 Предоставляет удобный интерфейс для создания и управления метриками через Prometheus-клиент.
@@ -182,6 +176,126 @@ AGW поддерживает langgraph checkpoint API и в SDK представ
 
 ## 5. Схема
 
+### 5.1. Типы входных данных
+
+Модуль `agent_lab_sdk.schema.input_types` предоставляет фабричные функции для создания аннотированных типов полей, которые могут использоваться в Pydantic моделях для описания интерфейса агентов.
+
+#### Основные типы полей
+
+```python
+from typing import List, Annotated
+from pydantic import BaseModel, Field
+from agent_lab_sdk.schema import (
+    MainInput, StringInput, StringArrayInput, NumberInput,
+    SelectInput, CheckboxInput, FileInput, FilesInput, SelectOption
+)
+
+class AgentState(BaseModel):
+    # Основное поле ввода
+    query: Annotated[str, MainInput(placeholder="Введите ваш запрос")]
+    
+    # Строковое поле
+    title: Annotated[str, StringInput(
+        default="Без названия",
+        title="Заголовок",
+        description="Название для вашего запроса"
+    )]
+    
+    # Массив строк
+    keywords: Annotated[List[str], StringArrayInput(
+        placeholder="Добавьте ключевые слова...",
+        title="Ключевые слова",
+        description="Список ключевых слов для поиска",
+        group="Параметры"
+    )]
+    
+    # Числовое поле
+    temperature: Annotated[float, NumberInput(
+        default=0.7,
+        title="Температура",
+        description="Параметр креативности модели (0.0 - 1.0)",
+        hidden=True
+    )]
+    
+    # Выпадающий список
+    mode: Annotated[str, SelectInput(
+        title="Режим работы",
+        items=[
+            SelectOption(label="Быстрый", value="fast").model_dump(),
+            SelectOption(label="Точный", value="precise").model_dump()
+        ],
+        default="fast",
+        group="Настройки"
+    )]
+    
+    # Чекбокс
+    save_history: Annotated[bool, CheckboxInput(
+        title="Сохранять историю",
+        description="Сохранять диалог для последующего анализа",
+        default=True,
+        group="Опции"
+    )]
+    
+    # Загрузка одного файла
+    document: Annotated[str, FileInput(
+        title="Документ",
+        file_extensions=".pdf,.docx,.txt"
+    )]
+    
+    # Загрузка нескольких файлов
+    attachments: Annotated[List[str], FilesInput(
+        title="Прикрепленные файлы",
+        file_extensions=".pdf,.csv,.xlsx",
+        group="Файлы"
+    )]
+```
+
+#### Доступные фабричные функции
+
+| Тип                | Описание                              | Основные параметры                                    |
+|--------------------| ------------------------------------- | ----------------------------------------------------- |
+| `MainInput`        | Основное поле ввода                   | `placeholder`                                         |
+| `StringInput`      | Текстовое поле                        | `default`, `title`, `description`, `hidden`          |
+| `StringArrayInput` | Массив строк                          | `placeholder`, `title`, `description`, `group`, `hidden` |
+| `NumberInput`      | Числовое поле                         | `default`, `title`, `description`, `hidden`          |
+| `SelectInput`      | Выпадающий список                     | `items`, `title`, `group`, `default`, `hidden`        |
+| `CheckboxInput`    | Чекбокс                               | `title`, `group`, `description`, `default`, `hidden`  |
+| `FileInput`        | Загрузка одного файла                 | `title`, `file_extensions`, `group`, `hidden`         |
+| `FilesInput`       | Загрузка нескольких файлов            | `title`, `file_extensions`, `group`, `hidden`         |
+
+#### Группировка полей
+
+Используйте параметр `group` для логической группировки полей в интерфейсе:
+
+```python
+class TaskConfig(BaseModel):
+    # Группа "Основные параметры"
+    task_type: Annotated[str, SelectInput(
+        title="Тип задачи",
+        items=[...],
+        group="Основные параметры"
+    )]
+    
+    priority: Annotated[str, SelectInput(
+        title="Приоритет",
+        items=[...],
+        group="Основные параметры"
+    )]
+    
+    # Группа "Дополнительно"
+    notifications: Annotated[bool, CheckboxInput(
+        title="Уведомления",
+        group="Дополнительно"
+    )]
+    
+    tags: Annotated[List[str], StringArrayInput(
+        placeholder="Теги...",
+        group="Дополнительно"
+    )]
+```
+
+### 5.2. LogMessage
+
 TODO: описание LogMessage
 
 ## 6. Сборка и публикация
@@ -207,7 +321,3 @@ python -m build && python -m twine upload dist/*
 ```bash
 pip install -e .
 ```
-
-# Примеры использования
-
-TBD

agent_lab_sdk-0.1.16/agent_lab_sdk/schema/__init__.py

@@ -0,0 +1,25 @@
+from .log_message import LogMessage
+from .input_types import (
+    MainInput,
+    StringInput,
+    StringArrayInput,
+    NumberInput,
+    SelectInput,
+    CheckboxInput,
+    FileInput,
+    FilesInput,
+    SelectOption
+)
+
+__all__ = [
+    "LogMessage",
+    "MainInput",
+    "StringInput", 
+    "StringArrayInput",
+    "NumberInput",
+    "SelectInput",
+    "CheckboxInput",
+    "FileInput",
+    "FilesInput",
+    "SelectOption"
+]

agent_lab_sdk-0.1.16/agent_lab_sdk/schema/input_types.py

@@ -0,0 +1,193 @@
+from typing import List, Optional, Any
+from pydantic import BaseModel
+from pydantic.json_schema import WithJsonSchema
+
+
+def MainInput(placeholder: str | None = None) -> type:
+    """
+    Factory function for creating a main input type with optional placeholder.
+    
+    Args:
+        placeholder: Optional placeholder text for the input field
+        
+    Returns:
+        Type annotation for main input field
+    """
+    return WithJsonSchema({
+        "type": "main-input",
+        "placeholder": placeholder,
+    })
+
+
+def StringInput(default: str | None = None, title: str | None = None, description: str | None = None, hidden: bool | None = False) -> type:
+    """
+    Factory function for creating a string input type.
+    
+    Args:
+        default: Default value for the string input
+        title: Title for the string input
+        description: Description text for the string input
+        hidden: Whether the input should be hidden in the UI
+        
+    Returns:
+        Type annotation for string input field
+    """
+    return WithJsonSchema({
+        "type": "input-string",
+        "default": default,
+        "title": title,
+        "description": description,
+        "hidden": hidden,
+    })
+
+
+def StringArrayInput(placeholder: str | None = None, title: str | None = None, description: str | None = None, group: str | None = None, hidden: bool | None = False) -> type:
+    """
+    Factory function for creating a string array input type.
+    
+    Args:
+        placeholder: Placeholder text for the input field
+        title: Title for the string array input
+        description: Description text for the string array input
+        group: Group name for organizing inputs in the UI
+        hidden: Whether the input should be hidden in the UI
+        
+    Returns:
+        Type annotation for string array input field
+    """
+    return WithJsonSchema({
+        "type": "string[]-inline",
+        "placeholder": placeholder,
+        "title": title,
+        "description": description,
+        "group": group,
+        "hidden": hidden,
+    })
+
+
+def NumberInput(default: float | None = None, title: str | None = None, description: str | None = None, hidden: bool | None = False) -> type:
+    """
+    Factory function for creating a number input type.
+    
+    Args:
+        default: Default value for the number input
+        title: Title for the number input
+        description: Description text for the number input
+        hidden: Whether the input should be hidden in the UI
+        
+    Returns:
+        Type annotation for number input field
+    """
+    return WithJsonSchema({
+        "type": "input-number",
+        "default": default,
+        "title": title,
+        "description": description,
+        "hidden": hidden,
+    })
+
+
+class SelectOption(BaseModel):
+    """
+    Model representing an option in a select input.
+    
+    Attributes:
+        label: Display label for the option
+        value: Actual value of the option
+        description: Optional description for the option
+    """
+    label: str
+    value: str
+    description: Optional[str] = None
+
+
+def SelectInput(items: List[Any] = [], title: str | None = None, group: str | None = None, default: str | None = None, hidden: bool | None = False) -> type:
+    """
+    Factory function for creating a select input type.
+    
+    Args:
+        items: List of SelectOption objects or dictionaries
+        title: Title for the select input
+        group: Group name for organizing inputs in the UI
+        default: Default selected value
+        hidden: Whether the input should be hidden in the UI
+        
+    Returns:
+        Type annotation for select input field
+    """
+    return WithJsonSchema({
+        "type": "select",
+        "title": title,
+        "items": items,
+        "group": group,
+        "default": default,
+        "hidden": hidden,
+    })
+
+
+def CheckboxInput(title: str | None = None, group: str | None = None, description: str | None = None, default: bool | None = False, hidden: bool | None = False) -> type:
+    """
+    Factory function for creating a checkbox input type.
+    
+    Args:
+        title: Title for the checkbox
+        group: Group name for organizing inputs in the UI
+        description: Description text for the checkbox
+        default: Default checked state
+        hidden: Whether the input should be hidden in the UI
+        
+    Returns:
+        Type annotation for checkbox input field
+    """
+    return WithJsonSchema({
+        "type": "checkbox",
+        "title": title,
+        "group": group,
+        "description": description,
+        "default": default,
+        "hidden": hidden,
+    })
+
+
+def FileInput(title: str | None = None, file_extensions: str | None = None, group: str | None = None, hidden: bool | None = False) -> type:
+    """
+    Factory function for creating a single file input type.
+    
+    Args:
+        title: Title for the file input
+        file_extensions: Comma-separated list of allowed file extensions (e.g., ".pdf,.txt")
+        group: Group name for organizing inputs in the UI
+        hidden: Whether the input should be hidden in the UI
+        
+    Returns:
+        Type annotation for file input field
+    """
+    return WithJsonSchema({
+        "type": "files",
+        "title": title,
+        "fileExtensions": file_extensions,
+        "group": group,
+        "hidden": hidden,
+    })
+
+
+def FilesInput(title: str | None = None, file_extensions: str | None = None, group: str | None = None, hidden: bool | None = False) -> type:
+    """
+    Factory function for creating a multiple files input type.
+    
+    Args:
+        title: Title for the files input
+        file_extensions: Comma-separated list of allowed file extensions (e.g., ".pdf,.txt")
+        group: Group name for organizing inputs in the UI
+        hidden: Whether the input should be hidden in the UI
+        
+    Returns:
+        Type annotation for files input field
+    """
+    return WithJsonSchema({
+        "type": "files",
+        "title": title,
+        "fileExtensions": file_extensions,
+        "group": group,
+        "hidden": hidden,
+    })

{agent_lab_sdk-0.1.15 → agent_lab_sdk-0.1.16}/agent_lab_sdk.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-lab-sdk
-Version: 0.1.15
+Version: 0.1.16
 Summary: SDK для работы с Agent Lab
 Author-email: Andrew Ohurtsov <andermirik@yandex.com>
 License: Proprietary and Confidential — All Rights Reserved
@@ -68,8 +68,6 @@ model = get_model(
 
 > если не передавать access_token, токен будет выбран через GigaChatTokenManager
 
-> планы на ближайшее будущее: get_model оборачивает внутри себя throttled классы.
-
 ### 1.2. Менеджеры токенов
 
 | Класс                  | Описание                                                                                | Пример использования                            |
@@ -95,8 +93,6 @@ model = get_model(
 
 ---
 
-<a name="throttled"></a>
-
 ## 2. Модуль `agent_lab_sdk.llm.throttled`
 
 Позволяет ограничивать число одновременных вызовов к GigaChat и сервису эмбеддингов, автоматически собирая соответствующие метрики.
@@ -139,8 +135,6 @@ vectors = emb.embed_documents(["Text1", "Text2"])
 
 ---
 
-<a name="metrics"></a>
-
 ## 3. Модуль `agent_lab_sdk.metrics`
 
 Предоставляет удобный интерфейс для создания и управления метриками через Prometheus-клиент.
@@ -211,6 +205,126 @@ AGW поддерживает langgraph checkpoint API и в SDK представ
 
 ## 5. Схема
 
+### 5.1. Типы входных данных
+
+Модуль `agent_lab_sdk.schema.input_types` предоставляет фабричные функции для создания аннотированных типов полей, которые могут использоваться в Pydantic моделях для описания интерфейса агентов.
+
+#### Основные типы полей
+
+```python
+from typing import List, Annotated
+from pydantic import BaseModel, Field
+from agent_lab_sdk.schema import (
+    MainInput, StringInput, StringArrayInput, NumberInput,
+    SelectInput, CheckboxInput, FileInput, FilesInput, SelectOption
+)
+
+class AgentState(BaseModel):
+    # Основное поле ввода
+    query: Annotated[str, MainInput(placeholder="Введите ваш запрос")]
+    
+    # Строковое поле
+    title: Annotated[str, StringInput(
+        default="Без названия",
+        title="Заголовок",
+        description="Название для вашего запроса"
+    )]
+    
+    # Массив строк
+    keywords: Annotated[List[str], StringArrayInput(
+        placeholder="Добавьте ключевые слова...",
+        title="Ключевые слова",
+        description="Список ключевых слов для поиска",
+        group="Параметры"
+    )]
+    
+    # Числовое поле
+    temperature: Annotated[float, NumberInput(
+        default=0.7,
+        title="Температура",
+        description="Параметр креативности модели (0.0 - 1.0)",
+        hidden=True
+    )]
+    
+    # Выпадающий список
+    mode: Annotated[str, SelectInput(
+        title="Режим работы",
+        items=[
+            SelectOption(label="Быстрый", value="fast").model_dump(),
+            SelectOption(label="Точный", value="precise").model_dump()
+        ],
+        default="fast",
+        group="Настройки"
+    )]
+    
+    # Чекбокс
+    save_history: Annotated[bool, CheckboxInput(
+        title="Сохранять историю",
+        description="Сохранять диалог для последующего анализа",
+        default=True,
+        group="Опции"
+    )]
+    
+    # Загрузка одного файла
+    document: Annotated[str, FileInput(
+        title="Документ",
+        file_extensions=".pdf,.docx,.txt"
+    )]
+    
+    # Загрузка нескольких файлов
+    attachments: Annotated[List[str], FilesInput(
+        title="Прикрепленные файлы",
+        file_extensions=".pdf,.csv,.xlsx",
+        group="Файлы"
+    )]
+```
+
+#### Доступные фабричные функции
+
+| Тип                | Описание                              | Основные параметры                                    |
+|--------------------| ------------------------------------- | ----------------------------------------------------- |
+| `MainInput`        | Основное поле ввода                   | `placeholder`                                         |
+| `StringInput`      | Текстовое поле                        | `default`, `title`, `description`, `hidden`          |
+| `StringArrayInput` | Массив строк                          | `placeholder`, `title`, `description`, `group`, `hidden` |
+| `NumberInput`      | Числовое поле                         | `default`, `title`, `description`, `hidden`          |
+| `SelectInput`      | Выпадающий список                     | `items`, `title`, `group`, `default`, `hidden`        |
+| `CheckboxInput`    | Чекбокс                               | `title`, `group`, `description`, `default`, `hidden`  |
+| `FileInput`        | Загрузка одного файла                 | `title`, `file_extensions`, `group`, `hidden`         |
+| `FilesInput`       | Загрузка нескольких файлов            | `title`, `file_extensions`, `group`, `hidden`         |
+
+#### Группировка полей
+
+Используйте параметр `group` для логической группировки полей в интерфейсе:
+
+```python
+class TaskConfig(BaseModel):
+    # Группа "Основные параметры"
+    task_type: Annotated[str, SelectInput(
+        title="Тип задачи",
+        items=[...],
+        group="Основные параметры"
+    )]
+    
+    priority: Annotated[str, SelectInput(
+        title="Приоритет",
+        items=[...],
+        group="Основные параметры"
+    )]
+    
+    # Группа "Дополнительно"
+    notifications: Annotated[bool, CheckboxInput(
+        title="Уведомления",
+        group="Дополнительно"
+    )]
+    
+    tags: Annotated[List[str], StringArrayInput(
+        placeholder="Теги...",
+        group="Дополнительно"
+    )]
+```
+
+### 5.2. LogMessage
+
 TODO: описание LogMessage
 
 ## 6. Сборка и публикация
@@ -236,7 +350,3 @@ python -m build && python -m twine upload dist/*
 ```bash
 pip install -e .
 ```
-
-# Примеры использования
-
-TBD

{agent_lab_sdk-0.1.15 → agent_lab_sdk-0.1.16}/agent_lab_sdk.egg-info/SOURCES.txt

@@ -17,6 +17,7 @@ agent_lab_sdk/llm/throttled.py
 agent_lab_sdk/metrics/__init__.py
 agent_lab_sdk/metrics/metrics.py
 agent_lab_sdk/schema/__init__.py
+agent_lab_sdk/schema/input_types.py
 agent_lab_sdk/schema/log_message.py
 agent_lab_sdk/storage/__init__.py
 agent_lab_sdk/storage/storage.py

{agent_lab_sdk-0.1.15 → agent_lab_sdk-0.1.16}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "agent-lab-sdk"
-version = "0.1.15"
+version = "0.1.16"
 description = "SDK для работы с Agent Lab"
 readme = "README.md"
 license = { text = "Proprietary and Confidential — All Rights Reserved" }

agent_lab_sdk-0.1.15/agent_lab_sdk/schema/__init__.py

@@ -1,2 +0,0 @@
-from .log_message import LogMessage
-__all__ = ["LogMessage"]