qanswer-sdk 0.46.0.dev0__py3-none-any.whl

qanswer_sdk/models/content_item.py

@@ -0,0 +1,130 @@
+# coding: utf-8
+
+"""
+    free-text-client
+
+    QAnswer 2.0 API
+
+    The version of the OpenAPI document: 2.0.0
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+from __future__ import annotations
+import pprint
+import re  # noqa: F401
+import json
+
+from pydantic import BaseModel, ConfigDict, StrictStr, field_validator
+from typing import Any, ClassVar, Dict, List, Optional
+from typing import Optional, Set
+from typing_extensions import Self
+
+class ContentItem(BaseModel):
+    """
+    ContentItem
+    """ # noqa: E501
+    content_item_type: StrictStr
+    text: Optional[StrictStr] = None
+    url: Optional[StrictStr] = None
+    image_detail: Optional[StrictStr] = None
+    audio_data: Optional[StrictStr] = None
+    audio_format: Optional[StrictStr] = None
+    file_id: Optional[StrictStr] = None
+    file_data: Optional[StrictStr] = None
+    file_name: Optional[StrictStr] = None
+    __properties: ClassVar[List[str]] = ["content_item_type", "text", "url", "image_detail", "audio_data", "audio_format", "file_id", "file_data", "file_name"]
+
+    @field_validator('content_item_type')
+    def content_item_type_validate_enum(cls, value):
+        """Validates the enum"""
+        if value not in set(['text', 'image_url', 'file', 'input_audio']):
+            raise ValueError("must be one of enum values ('text', 'image_url', 'file', 'input_audio')")
+        return value
+
+    @field_validator('image_detail')
+    def image_detail_validate_enum(cls, value):
+        """Validates the enum"""
+        if value is None:
+            return value
+
+        if value not in set(['low', 'high', 'auto']):
+            raise ValueError("must be one of enum values ('low', 'high', 'auto')")
+        return value
+
+    @field_validator('audio_format')
+    def audio_format_validate_enum(cls, value):
+        """Validates the enum"""
+        if value is None:
+            return value
+
+        if value not in set(['wav', 'mp3']):
+            raise ValueError("must be one of enum values ('wav', 'mp3')")
+        return value
+
+    model_config = ConfigDict(
+        populate_by_name=True,
+        validate_assignment=True,
+        protected_namespaces=(),
+    )
+
+
+    def to_str(self) -> str:
+        """Returns the string representation of the model using alias"""
+        return pprint.pformat(self.model_dump(by_alias=True))
+
+    def to_json(self) -> str:
+        """Returns the JSON representation of the model using alias"""
+        # TODO: pydantic v2: use .model_dump_json(by_alias=True, exclude_unset=True) instead
+        return json.dumps(self.to_dict())
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Optional[Self]:
+        """Create an instance of ContentItem from a JSON string"""
+        return cls.from_dict(json.loads(json_str))
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Return the dictionary representation of the model using alias.
+
+        This has the following differences from calling pydantic's
+        `self.model_dump(by_alias=True)`:
+
+        * `None` is only added to the output dict for nullable fields that
+          were set at model initialization. Other fields with value `None`
+          are ignored.
+        """
+        excluded_fields: Set[str] = set([
+        ])
+
+        _dict = self.model_dump(
+            by_alias=True,
+            exclude=excluded_fields,
+            exclude_none=True,
+        )
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
+        """Create an instance of ContentItem from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return cls.model_validate(obj)
+
+        _obj = cls.model_validate({
+            "content_item_type": obj.get("content_item_type"),
+            "text": obj.get("text"),
+            "url": obj.get("url"),
+            "image_detail": obj.get("image_detail"),
+            "audio_data": obj.get("audio_data"),
+            "audio_format": obj.get("audio_format"),
+            "file_id": obj.get("file_id"),
+            "file_data": obj.get("file_data"),
+            "file_name": obj.get("file_name")
+        })
+        return _obj
+
+

qanswer_sdk/models/content_item_type.py

@@ -0,0 +1,39 @@
+# coding: utf-8
+
+"""
+    free-text-client
+
+    QAnswer 2.0 API
+
+    The version of the OpenAPI document: 2.0.0
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+from __future__ import annotations
+import json
+from enum import Enum
+from typing_extensions import Self
+
+
+class ContentItemType(str, Enum):
+    """
+    ContentItemType
+    """
+
+    """
+    allowed enum values
+    """
+    TEXT = 'text'
+    IMAGE_URL = 'image_url'
+    FILE = 'file'
+    INPUT_AUDIO = 'input_audio'
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Self:
+        """Create an instance of ContentItemType from a JSON string"""
+        return cls(json.loads(json_str))
+
+

qanswer_sdk/models/conversation_message.py

@@ -0,0 +1,259 @@
+# coding: utf-8
+
+"""
+    free-text-client
+
+    QAnswer 2.0 API
+
+    The version of the OpenAPI document: 2.0.0
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+from __future__ import annotations
+import pprint
+import re  # noqa: F401
+import json
+
+from pydantic import BaseModel, ConfigDict, Field, StrictBool, StrictInt, StrictStr, field_validator
+from typing import Any, ClassVar, Dict, List, Optional
+from qanswer_sdk.models.aggregations_group import AggregationsGroup
+from qanswer_sdk.models.content_item import ContentItem
+from qanswer_sdk.models.source import Source
+from qanswer_sdk.models.thinking_block import ThinkingBlock
+from qanswer_sdk.models.tool_selection import ToolSelection
+from qanswer_sdk.models.websearch_scraping_site import WebsearchScrapingSite
+from typing import Optional, Set
+from typing_extensions import Self
+
+class ConversationMessage(BaseModel):
+    """
+    ConversationMessage
+    """ # noqa: E501
+    role: StrictStr
+    contents: List[ContentItem]
+    message_id: StrictStr
+    parent_message_id: Optional[StrictStr] = None
+    timestamp: Optional[StrictStr] = '2026-04-14T13:50:20Z'
+    feedback: Optional[StrictInt] = -1
+    origin: Optional[StrictStr] = None
+    sources: Optional[List[Source]] = Field(default=None, description="All sources referenced in the response")
+    all_sources: Optional[List[Source]] = Field(default=None, description="All retrieved sources passed to the llm")
+    task_category: Optional[StrictStr] = None
+    interface_origin: Optional[StrictStr] = None
+    comment: Optional[StrictStr] = None
+    llm_choice: Optional[StrictStr] = None
+    error_key: Optional[StrictStr] = None
+    prompt_used: Optional[StrictStr] = None
+    mode: Optional[StrictStr] = None
+    is_input_data_cropped: Optional[StrictBool] = None
+    aggs: Optional[List[AggregationsGroup]] = None
+    expanded_question: Optional[StrictStr] = None
+    prompt_type: Optional[StrictStr] = None
+    tagged_assistant_name: Optional[StrictStr] = None
+    synonyms_used: Optional[List[StrictStr]] = None
+    tool_calls: Optional[List[Dict[str, Any]]] = None
+    tool_call_id: Optional[StrictStr] = None
+    tool_selections: Optional[List[ToolSelection]] = None
+    server_uids: Optional[List[StrictStr]] = None
+    thinking_blocks: Optional[List[ThinkingBlock]] = None
+    websearch_sites: Optional[List[WebsearchScrapingSite]] = None
+    merge_with_message_id: Optional[StrictStr] = None
+    capability_type: Optional[StrictStr] = None
+    warn_visibility: Optional[StrictStr] = 'none'
+    __properties: ClassVar[List[str]] = ["role", "contents", "message_id", "parent_message_id", "timestamp", "feedback", "origin", "sources", "all_sources", "task_category", "interface_origin", "comment", "llm_choice", "error_key", "prompt_used", "mode", "is_input_data_cropped", "aggs", "expanded_question", "prompt_type", "tagged_assistant_name", "synonyms_used", "tool_calls", "tool_call_id", "tool_selections", "server_uids", "thinking_blocks", "websearch_sites", "merge_with_message_id", "capability_type", "warn_visibility"]
+
+    @field_validator('role')
+    def role_validate_enum(cls, value):
+        """Validates the enum"""
+        if value not in set(['assistant', 'user', 'tool']):
+            raise ValueError("must be one of enum values ('assistant', 'user', 'tool')")
+        return value
+
+    @field_validator('task_category')
+    def task_category_validate_enum(cls, value):
+        """Validates the enum"""
+        if value is None:
+            return value
+
+        if value not in set(['text', 'sparql', 'sql', 'sparql2text', 'sparqlvisualize', 'undefined', 'typing', 'user_joined', 'user_left', 'human_takeover_proposed', 'human_takeover_accepted', 'human_takeover_rejected', 'websearch', 'thinking', 'something_went_wrong', 'mcp_tool_calls', 'mcp_tool_choice_accept', 'mcp_tool_choice_reject', 'mcp_ask_for_connection', 'mcp_tool_choice_ask_confirmation', 'mcp_tool_call_response', 'request_initial_message', 'econsilium-request-for-new-token']):
+            raise ValueError("must be one of enum values ('text', 'sparql', 'sql', 'sparql2text', 'sparqlvisualize', 'undefined', 'typing', 'user_joined', 'user_left', 'human_takeover_proposed', 'human_takeover_accepted', 'human_takeover_rejected', 'websearch', 'thinking', 'something_went_wrong', 'mcp_tool_calls', 'mcp_tool_choice_accept', 'mcp_tool_choice_reject', 'mcp_ask_for_connection', 'mcp_tool_choice_ask_confirmation', 'mcp_tool_call_response', 'request_initial_message', 'econsilium-request-for-new-token')")
+        return value
+
+    @field_validator('error_key')
+    def error_key_validate_enum(cls, value):
+        """Validates the enum"""
+        if value is None:
+            return value
+
+        if value not in set(['authentication_error', 'permission_denied', 'context_window_exceeded', 'content_policy_violation', 'rejected_request', 'bad_request', 'not_found', 'unprocessable_entity', 'rate_limit', 'timeout', 'internal_server_error', 'bad_gateway', 'service_unavailable', 'api_connection_error', 'api_error', 'econsilium_token_error', 'unknown']):
+            raise ValueError("must be one of enum values ('authentication_error', 'permission_denied', 'context_window_exceeded', 'content_policy_violation', 'rejected_request', 'bad_request', 'not_found', 'unprocessable_entity', 'rate_limit', 'timeout', 'internal_server_error', 'bad_gateway', 'service_unavailable', 'api_connection_error', 'api_error', 'econsilium_token_error', 'unknown')")
+        return value
+
+    @field_validator('mode')
+    def mode_validate_enum(cls, value):
+        """Validates the enum"""
+        if value is None:
+            return value
+
+        if value not in set(['rag', 'full-context', 'rag-with-map-reduce', 'full_context_with_map_reduce']):
+            raise ValueError("must be one of enum values ('rag', 'full-context', 'rag-with-map-reduce', 'full_context_with_map_reduce')")
+        return value
+
+    @field_validator('capability_type')
+    def capability_type_validate_enum(cls, value):
+        """Validates the enum"""
+        if value is None:
+            return value
+
+        if value not in set(['web_search', 'retrieve_documents']):
+            raise ValueError("must be one of enum values ('web_search', 'retrieve_documents')")
+        return value
+
+    @field_validator('warn_visibility')
+    def warn_visibility_validate_enum(cls, value):
+        """Validates the enum"""
+        if value is None:
+            return value
+
+        if value not in set(['shared', 'shared_anonymized', 'incognito', 'not_shared', 'none']):
+            raise ValueError("must be one of enum values ('shared', 'shared_anonymized', 'incognito', 'not_shared', 'none')")
+        return value
+
+    model_config = ConfigDict(
+        populate_by_name=True,
+        validate_assignment=True,
+        protected_namespaces=(),
+    )
+
+
+    def to_str(self) -> str:
+        """Returns the string representation of the model using alias"""
+        return pprint.pformat(self.model_dump(by_alias=True))
+
+    def to_json(self) -> str:
+        """Returns the JSON representation of the model using alias"""
+        # TODO: pydantic v2: use .model_dump_json(by_alias=True, exclude_unset=True) instead
+        return json.dumps(self.to_dict())
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Optional[Self]:
+        """Create an instance of ConversationMessage from a JSON string"""
+        return cls.from_dict(json.loads(json_str))
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Return the dictionary representation of the model using alias.
+
+        This has the following differences from calling pydantic's
+        `self.model_dump(by_alias=True)`:
+
+        * `None` is only added to the output dict for nullable fields that
+          were set at model initialization. Other fields with value `None`
+          are ignored.
+        """
+        excluded_fields: Set[str] = set([
+        ])
+
+        _dict = self.model_dump(
+            by_alias=True,
+            exclude=excluded_fields,
+            exclude_none=True,
+        )
+        # override the default output from pydantic by calling `to_dict()` of each item in contents (list)
+        _items = []
+        if self.contents:
+            for _item_contents in self.contents:
+                if _item_contents:
+                    _items.append(_item_contents.to_dict())
+            _dict['contents'] = _items
+        # override the default output from pydantic by calling `to_dict()` of each item in sources (list)
+        _items = []
+        if self.sources:
+            for _item_sources in self.sources:
+                if _item_sources:
+                    _items.append(_item_sources.to_dict())
+            _dict['sources'] = _items
+        # override the default output from pydantic by calling `to_dict()` of each item in all_sources (list)
+        _items = []
+        if self.all_sources:
+            for _item_all_sources in self.all_sources:
+                if _item_all_sources:
+                    _items.append(_item_all_sources.to_dict())
+            _dict['all_sources'] = _items
+        # override the default output from pydantic by calling `to_dict()` of each item in aggs (list)
+        _items = []
+        if self.aggs:
+            for _item_aggs in self.aggs:
+                if _item_aggs:
+                    _items.append(_item_aggs.to_dict())
+            _dict['aggs'] = _items
+        # override the default output from pydantic by calling `to_dict()` of each item in tool_selections (list)
+        _items = []
+        if self.tool_selections:
+            for _item_tool_selections in self.tool_selections:
+                if _item_tool_selections:
+                    _items.append(_item_tool_selections.to_dict())
+            _dict['tool_selections'] = _items
+        # override the default output from pydantic by calling `to_dict()` of each item in thinking_blocks (list)
+        _items = []
+        if self.thinking_blocks:
+            for _item_thinking_blocks in self.thinking_blocks:
+                if _item_thinking_blocks:
+                    _items.append(_item_thinking_blocks.to_dict())
+            _dict['thinking_blocks'] = _items
+        # override the default output from pydantic by calling `to_dict()` of each item in websearch_sites (list)
+        _items = []
+        if self.websearch_sites:
+            for _item_websearch_sites in self.websearch_sites:
+                if _item_websearch_sites:
+                    _items.append(_item_websearch_sites.to_dict())
+            _dict['websearch_sites'] = _items
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
+        """Create an instance of ConversationMessage from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return cls.model_validate(obj)
+
+        _obj = cls.model_validate({
+            "role": obj.get("role"),
+            "contents": [ContentItem.from_dict(_item) for _item in obj["contents"]] if obj.get("contents") is not None else None,
+            "message_id": obj.get("message_id"),
+            "parent_message_id": obj.get("parent_message_id"),
+            "timestamp": obj.get("timestamp") if obj.get("timestamp") is not None else '2026-04-14T13:50:20Z',
+            "feedback": obj.get("feedback") if obj.get("feedback") is not None else -1,
+            "origin": obj.get("origin"),
+            "sources": [Source.from_dict(_item) for _item in obj["sources"]] if obj.get("sources") is not None else None,
+            "all_sources": [Source.from_dict(_item) for _item in obj["all_sources"]] if obj.get("all_sources") is not None else None,
+            "task_category": obj.get("task_category"),
+            "interface_origin": obj.get("interface_origin"),
+            "comment": obj.get("comment"),
+            "llm_choice": obj.get("llm_choice"),
+            "error_key": obj.get("error_key"),
+            "prompt_used": obj.get("prompt_used"),
+            "mode": obj.get("mode"),
+            "is_input_data_cropped": obj.get("is_input_data_cropped"),
+            "aggs": [AggregationsGroup.from_dict(_item) for _item in obj["aggs"]] if obj.get("aggs") is not None else None,
+            "expanded_question": obj.get("expanded_question"),
+            "prompt_type": obj.get("prompt_type"),
+            "tagged_assistant_name": obj.get("tagged_assistant_name"),
+            "synonyms_used": obj.get("synonyms_used"),
+            "tool_calls": obj.get("tool_calls"),
+            "tool_call_id": obj.get("tool_call_id"),
+            "tool_selections": [ToolSelection.from_dict(_item) for _item in obj["tool_selections"]] if obj.get("tool_selections") is not None else None,
+            "server_uids": obj.get("server_uids"),
+            "thinking_blocks": [ThinkingBlock.from_dict(_item) for _item in obj["thinking_blocks"]] if obj.get("thinking_blocks") is not None else None,
+            "websearch_sites": [WebsearchScrapingSite.from_dict(_item) for _item in obj["websearch_sites"]] if obj.get("websearch_sites") is not None else None,
+            "merge_with_message_id": obj.get("merge_with_message_id"),
+            "capability_type": obj.get("capability_type"),
+            "warn_visibility": obj.get("warn_visibility") if obj.get("warn_visibility") is not None else 'none'
+        })
+        return _obj
+
+

qanswer_sdk/models/conversation_message_error_key.py

@@ -0,0 +1,52 @@
+# coding: utf-8
+
+"""
+    free-text-client
+
+    QAnswer 2.0 API
+
+    The version of the OpenAPI document: 2.0.0
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+from __future__ import annotations
+import json
+from enum import Enum
+from typing_extensions import Self
+
+
+class ConversationMessageErrorKey(str, Enum):
+    """
+    ConversationMessageErrorKey
+    """
+
+    """
+    allowed enum values
+    """
+    AUTHENTICATION_ERROR = 'authentication_error'
+    PERMISSION_DENIED = 'permission_denied'
+    CONTEXT_WINDOW_EXCEEDED = 'context_window_exceeded'
+    CONTENT_POLICY_VIOLATION = 'content_policy_violation'
+    REJECTED_REQUEST = 'rejected_request'
+    BAD_REQUEST = 'bad_request'
+    NOT_FOUND = 'not_found'
+    UNPROCESSABLE_ENTITY = 'unprocessable_entity'
+    RATE_LIMIT = 'rate_limit'
+    TIMEOUT = 'timeout'
+    INTERNAL_SERVER_ERROR = 'internal_server_error'
+    BAD_GATEWAY = 'bad_gateway'
+    SERVICE_UNAVAILABLE = 'service_unavailable'
+    API_CONNECTION_ERROR = 'api_connection_error'
+    API_ERROR = 'api_error'
+    ECONSILIUM_TOKEN_ERROR = 'econsilium_token_error'
+    UNKNOWN = 'unknown'
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Self:
+        """Create an instance of ConversationMessageErrorKey from a JSON string"""
+        return cls(json.loads(json_str))
+
+

qanswer_sdk/models/conversation_message_search_result.py

@@ -0,0 +1,121 @@
+# coding: utf-8
+
+"""
+    free-text-client
+
+    QAnswer 2.0 API
+
+    The version of the OpenAPI document: 2.0.0
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+from __future__ import annotations
+import pprint
+import re  # noqa: F401
+import json
+
+from pydantic import BaseModel, ConfigDict, StrictFloat, StrictInt, StrictStr, field_validator
+from typing import Any, ClassVar, Dict, List, Optional, Union
+from typing import Optional, Set
+from typing_extensions import Self
+
+class ConversationMessageSearchResult(BaseModel):
+    """
+    ConversationMessageSearchResult
+    """ # noqa: E501
+    conversation_id: StrictStr
+    conversation_title: Optional[StrictStr] = None
+    conversation_username: StrictStr
+    dataset: StrictStr
+    conversation_creation_date: Optional[StrictStr] = None
+    conversation_last_updated: Optional[StrictStr] = None
+    message_id: StrictStr
+    message_role: StrictStr
+    message_timestamp: Optional[StrictStr] = None
+    message_origin: Optional[StrictStr] = None
+    interface_origin: Optional[StrictStr] = None
+    snippet: Optional[StrictStr] = None
+    score: Optional[Union[StrictFloat, StrictInt]] = None
+    __properties: ClassVar[List[str]] = ["conversation_id", "conversation_title", "conversation_username", "dataset", "conversation_creation_date", "conversation_last_updated", "message_id", "message_role", "message_timestamp", "message_origin", "interface_origin", "snippet", "score"]
+
+    @field_validator('interface_origin')
+    def interface_origin_validate_enum(cls, value):
+        """Validates the enum"""
+        if value is None:
+            return value
+
+        if value not in set(['search', 'chat', 'widget', 'microsoft_teams', 'discord', 'slack', 'chatbot_playground', 'search_playground', 'report_copilot_playground', 'ai_excel_playground', 'undefined', 'report_copilot', 'ai_excel']):
+            raise ValueError("must be one of enum values ('search', 'chat', 'widget', 'microsoft_teams', 'discord', 'slack', 'chatbot_playground', 'search_playground', 'report_copilot_playground', 'ai_excel_playground', 'undefined', 'report_copilot', 'ai_excel')")
+        return value
+
+    model_config = ConfigDict(
+        populate_by_name=True,
+        validate_assignment=True,
+        protected_namespaces=(),
+    )
+
+
+    def to_str(self) -> str:
+        """Returns the string representation of the model using alias"""
+        return pprint.pformat(self.model_dump(by_alias=True))
+
+    def to_json(self) -> str:
+        """Returns the JSON representation of the model using alias"""
+        # TODO: pydantic v2: use .model_dump_json(by_alias=True, exclude_unset=True) instead
+        return json.dumps(self.to_dict())
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Optional[Self]:
+        """Create an instance of ConversationMessageSearchResult from a JSON string"""
+        return cls.from_dict(json.loads(json_str))
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Return the dictionary representation of the model using alias.
+
+        This has the following differences from calling pydantic's
+        `self.model_dump(by_alias=True)`:
+
+        * `None` is only added to the output dict for nullable fields that
+          were set at model initialization. Other fields with value `None`
+          are ignored.
+        """
+        excluded_fields: Set[str] = set([
+        ])
+
+        _dict = self.model_dump(
+            by_alias=True,
+            exclude=excluded_fields,
+            exclude_none=True,
+        )
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
+        """Create an instance of ConversationMessageSearchResult from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return cls.model_validate(obj)
+
+        _obj = cls.model_validate({
+            "conversation_id": obj.get("conversation_id"),
+            "conversation_title": obj.get("conversation_title"),
+            "conversation_username": obj.get("conversation_username"),
+            "dataset": obj.get("dataset"),
+            "conversation_creation_date": obj.get("conversation_creation_date"),
+            "conversation_last_updated": obj.get("conversation_last_updated"),
+            "message_id": obj.get("message_id"),
+            "message_role": obj.get("message_role"),
+            "message_timestamp": obj.get("message_timestamp"),
+            "message_origin": obj.get("message_origin"),
+            "interface_origin": obj.get("interface_origin"),
+            "snippet": obj.get("snippet"),
+            "score": obj.get("score")
+        })
+        return _obj
+
+