跳到内容

Ionic shopping

IonicShoppingToolSpec #

基础: BaseToolSpec

Ionic Shopping 工具规范。

此工具可用于使用大型语言模型构建电子商务体验。

源代码位于 llama-index-integrations/tools/llama-index-tools-ionic-shopping/llama_index/tools/ionic_shopping/base.py 
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
class IonicShoppingToolSpec(BaseToolSpec):
    """
    Ionic Shopping tool spec.

    This tool can be used to build e-commerce experiences with LLMs.
    """

    spec_functions = ["query"]

    def __init__(self, api_key: Optional[str] = None) -> None:
        """
        Ionic API Key.

        Learn more about attribution with Ionic API Keys
        https://docs.ioniccommerce.com/guides/attribution
        """
        from ionic import Ionic as IonicSDK

        if api_key:
            self.client = IonicSDK(api_key_header=api_key)
        else:
            self.client = IonicSDK()

    def query(
        self,
        query: str,
        num_results: Optional[int] = 5,
        min_price: Optional[int] = None,
        max_price: Optional[int] = None,
    ) -> list[Product]:
        """
        Use this function to search for products and to get product recommendations.

        Args:
            query (str): A precise query of a product name or product category
            num_results (Optional[int]): Defaults to 5. The number of product results to return.
            min_price (Option[int]): The minimum price in cents the requester is willing to pay
            max_price (Option[int]): The maximum price in cents the requester is willing to pay

        """
        request = QueryAPIRequest(
            query=SDKQuery(
                query=query,
                num_results=num_results,
                min_price=min_price,
                max_price=max_price,
            )
        )
        response: QueryResponse = self.client.query(
            request=request,
            security=QuerySecurity(),
        )

        return [
            product
            for result in response.query_api_response.results
            for product in result.products
        ]

query #

query(query: str, num_results: Optional[int] = 5, min_price: Optional[int] = None, max_price: Optional[int] = None) -> list[Product]

使用此函数搜索产品并获取产品推荐。

参数

名称 类型 描述 默认值
query str

精确的产品名称或产品类别查询

 必需
num_results Optional[int]

默认为 5。要返回的产品结果数量。

 5
min_price Option[int]

请求者愿意支付的最低价格（以分为单位）

 无
max_price Option[int]

请求者愿意支付的最高价格（以分为单位）

 无
源代码位于 llama-index-integrations/tools/llama-index-tools-ionic-shopping/llama_index/tools/ionic_shopping/base.py 
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
def query(
    self,
    query: str,
    num_results: Optional[int] = 5,
    min_price: Optional[int] = None,
    max_price: Optional[int] = None,
) -> list[Product]:
    """
    Use this function to search for products and to get product recommendations.

    Args:
        query (str): A precise query of a product name or product category
        num_results (Optional[int]): Defaults to 5. The number of product results to return.
        min_price (Option[int]): The minimum price in cents the requester is willing to pay
        max_price (Option[int]): The maximum price in cents the requester is willing to pay

    """
    request = QueryAPIRequest(
        query=SDKQuery(
            query=query,
            num_results=num_results,
            min_price=min_price,
            max_price=max_price,
        )
    )
    response: QueryResponse = self.client.query(
        request=request,
        security=QuerySecurity(),
    )

    return [
        product
        for result in response.query_api_response.results
        for product in result.products
    ]