llama-index tools shopify integration
Project description
Shopify Tool
This tool acts as a custom app for Shopify stores, allowing the Agent to execute GraphQL queries to gather information or perform mutations against the Shopify store.
Usage
This tool has more extensive example usage documented in a Jupyter notebook here
In particular, the tool is very effective when combined with a method of retrieving data from the GraphQL schema definition.
pip install llama-index llama-index-readers-file llama-index-tools-shopify unstructured
from llama_index.tools.shopify import ShopifyToolSpec
from llama_index.agent.openai import OpenAIAgent
from llama_index.readers.file import UnstructuredReader
from llama_index.core.tools.ondemand_loader_tool import OnDemandLoaderTool
documentation_tool = OnDemandLoaderTool.from_defaults(
UnstructuredReader(),
name="graphql_writer",
description="""
The GraphQL schema file is located at './data/shopify_graphql.txt', this is always the file argument.
A tool for processing the Shopify GraphQL spec, and writing queries from the documentation.
You should pass a query_str to this tool in the form of a request to write a GraphQL query.
Examples:
file: './data/shopify_graphql.txt', query_str='Write a graphql query to find unshipped orders'
file: './data/shopify_graphql.txt', query_str='Write a graphql query to retrieve the stores products'
file: './data/shopify_graphql.txt', query_str='What fields can you retrieve from the orders object'
""",
)
shopify_tool = ShopifyToolSpec(
"your-store.myshopify.com", "2023-04", "your-api-key"
)
agent = OpenAIAgent.from_tools(
[*shopify_tool.to_tool_list(), documentation_tool],
system_prompt=f"""
You are a specialized Agent with access to the Shopify Admin GraphQL API for this Users online store.
Your job is to chat with store owners and help them run GraphQL queries, interpreting the results for the user
You can use graphql_writer to query the schema and assist in writing queries.
If the GraphQL you execute returns an error, either directly fix the query, or directly ask the graphql_writer questions about the schema instead of writing graphql queries.
Then use that information to write the correct graphql query
""",
verbose=True,
max_function_calls=20,
)
agent.chat("What products are in my store?")
run_graphql_query
: Executes a GraphQL query against the Shopify store
This loader is designed to be used as a way to load data as a Tool in a Agent.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Close
Hashes for llama_index_tools_shopify-0.2.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 70bbb0a7b2224cf8aa00ab8628d5b721113747fce0d6fa20114cdd10f7b51e98 |
|
MD5 | 3141d5205c1188f854f949b8e6b09eee |
|
BLAKE2b-256 | c95ab702745c412cc2b1f81b178ce57c2a39bc0a3126608ed64762b80b1d8f2d |
Close
Hashes for llama_index_tools_shopify-0.2.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 2c19ce0d3f359385819c7037920eb05236361d74083f73c7101199e731ea28cb |
|
MD5 | f83b95c5d106627debe2b987999674ef |
|
BLAKE2b-256 | 61b1bc31bb08358be683832996510f0fc43d5e4e88666737bd88d5bfcff6be2a |