Skip to main content

Ionic Shopping Tool

Ionic is a plug and play ecommerce marketplace for AI Assistants. By including the Ionic Tool in your agent, you are effortlessly providing your users with the ability to shop and transact directly within your agent, and you'll get a cut of the transaction.

This is a basic jupyter notebook demonstrating how to integrate the Ionic Tool into your agent. For more information on setting up your Agent with Ionic, see the Ionic documentation.

This Jupyter Notebook demonstrates how to use the Ionic tool with an Agent.

Note: The ionic-langchain package is maintained by the Ionic Commerce team, not the LangChain maintainers.


pip install langchain langchain_openai langchainhub
pip install ionic-langchain

Setup Agent

from ionic_langchain.tool import Ionic, IonicTool
from langchain import hub
from langchain.agents import AgentExecutor, Tool, create_react_agent
from langchain_openai import OpenAI

# Based on ReAct Agent
# See the paper "ReAct: Synergizing Reasoning and Acting in Language Models" (
# Please reach out to for help with add'l agent types.

open_ai_key = "YOUR KEY HERE"
model = "gpt-3.5-turbo-instruct"
temperature = 0.6

llm = OpenAI(openai_api_key=open_ai_key, model_name=model, temperature=temperature)

ionic_tool = IonicTool().tool()

# The tool comes with its own prompt,
# but you may also update it directly via the description attribute:

ionic_tool.description = str(
Ionic is an e-commerce shopping tool. Assistant uses the Ionic Commerce Shopping Tool to find, discover, and compare products from thousands of online retailers. Assistant should use the tool when the user is looking for a product recommendation or trying to find a specific product.

The user may specify the number of results, minimum price, and maximum price for which they want to see results.
Ionic Tool input is a comma-separated string of values:
- query string (required, must not include commas)
- number of results (default to 4, no more than 10)
- minimum price in cents ($5 becomes 500)
- maximum price in cents
For example, if looking for coffee beans between 5 and 10 dollars, the tool input would be `coffee beans, 5, 500, 1000`.

Return them as a markdown formatted list with each recommendation from tool results, being sure to include the full PDP URL. For example:

1. Product 1: [Price] -- link
2. Product 2: [Price] -- link
3. Product 3: [Price] -- link
4. Product 4: [Price] -- link

tools = [ionic_tool]

# default prompt for create_react_agent
prompt = hub.pull("hwchase17/react")

agent = create_react_agent(

agent_executor = AgentExecutor(
agent=agent, tools=tools, handle_parsing_errors=True, verbose=True, max_iterations=5


input = (
"I'm looking for a new 4k monitor can you find me some options for less than $1000"
agent_executor.invoke({"input": input})

Was this page helpful?

You can leave detailed feedback on GitHub.