The agent engineering platform.
Python agentsaiai-agentsanthropicchatgptdeepagentsenterpriseframeworkgeminigenerative-ailangchainlanggraphllmmultiagentopen-sourceopenaipydanticpythonragtypescript
docs: add stripe toolkit (#28122)
Erick Friis97dc906a18b4
diff --git a/docs/docs/integrations/tools/stripe.ipynb b/docs/docs/integrations/tools/stripe.ipynbnew file mode 100644index 0000000000..0edc4cdd6d--- /dev/null+++ b/docs/docs/integrations/tools/stripe.ipynb@@ -0,0 +1,196 @@+{+ "cells": [+ {+ "cell_type": "raw",+ "id": "10238e62-3465-4973-9279-606cbb7ccf16",+ "metadata": {},+ "source": [+ "---\n",+ "sidebar_label: Stripe\n",+ "---"+ ]+ },+ {+ "cell_type": "markdown",+ "id": "a6f91f20",+ "metadata": {},+ "source": [+ "# StripeAgentToolkit\n",+ "\n",+ "This notebook provides a quick overview for getting started with Stripe's agent toolkit.\n",+ "\n",+ "You can read more about `StripeAgentToolkit` in [Stripe's launch blog](https://stripe.dev/blog/adding-payments-to-your-agentic-workflows) or on the project's [PyPi page](https://pypi.org/project/stripe-agent-toolkit/).\n",+ "\n",+ "## Overview\n",+ "\n",+ "### Integration details\n",+ "\n",+ "| Class | Package | Serializable | [JS Support](https://github.com/stripe/agent-toolkit?tab=readme-ov-file#typescript) | Package latest |\n",+ "| :--- | :--- | :---: | :---: | :---: |\n",+ "| StripeAgentToolkit | [stripe-agent-toolkit](https://pypi.org/project/stripe-agent-toolkit) | ❌ | ✅ |  |\n",+ "\n",+ "\n",+ "## Setup\n",+ "\n",+ "This externally-managed package is hosted out of the `stripe-agent-toolkit` project, which is managed by Stripe's team.\n",+ "\n",+ "You can install it, along with langgraph for the following examples, with `pip`:"+ ]+ },+ {+ "cell_type": "code",+ "execution_count": 1,+ "id": "f85b4089",+ "metadata": {},+ "outputs": [+ {+ "name": "stdout",+ "output_type": "stream",+ "text": [+ "\n",+ "\u001b[1m[\u001b[0m\u001b[34;49mnotice\u001b[0m\u001b[1;39;49m]\u001b[0m\u001b[39;49m A new release of pip is available: \u001b[0m\u001b[31;49m24.2\u001b[0m\u001b[39;49m -> \u001b[0m\u001b[32;49m24.3.1\u001b[0m\n",+ "\u001b[1m[\u001b[0m\u001b[34;49mnotice\u001b[0m\u001b[1;39;49m]\u001b[0m\u001b[39;49m To update, run: \u001b[0m\u001b[32;49mpip install --upgrade pip\u001b[0m\n",+ "Note: you may need to restart the kernel to use updated packages.\n"+ ]+ }+ ],+ "source": [+ "%pip install --quiet -U langgraph stripe-agent-toolkit"+ ]+ },+ {+ "cell_type": "markdown",+ "id": "b15e9266",+ "metadata": {},+ "source": [+ "### Credentials\n",+ "\n",+ "In addition to installing the package, you will need to configure the integration with your Stripe account's secret key, which is available in your [Stripe Dashboard](https://dashboard.stripe.com/account/apikeys)."+ ]+ },+ {+ "cell_type": "code",+ "execution_count": null,+ "id": "e0b178a2-8816-40ca-b57c-ccdd86dde9c9",+ "metadata": {},+ "outputs": [],+ "source": [+ "import getpass\n",+ "import os\n",+ "\n",+ "if not os.environ.get(\"STRIPE_SECRET_KEY\"):\n",+ " os.environ[\"STRIPE_SECRET_KEY\"] = getpass.getpass(\"STRIPE API key:\\n\")"+ ]+ },+ {+ "cell_type": "markdown",+ "id": "bc5ab717-fd27-4c59-b912-bdd099541478",+ "metadata": {},+ "source": [+ "It's also helpful (but not needed) to set up [LangSmith](https://smith.langchain.com/) for best-in-class observability:"+ ]+ },+ {+ "cell_type": "code",+ "execution_count": 3,+ "id": "a6c2f136-6367-4f1f-825d-ae741e1bf281",+ "metadata": {},+ "outputs": [],+ "source": [+ "# os.environ[\"LANGCHAIN_TRACING_V2\"] = \"true\"\n",+ "# os.environ[\"LANGCHAIN_API_KEY\"] = getpass.getpass()"+ ]+ },+ {+ "cell_type": "markdown",+ "id": "1c97218f-f366-479d-8bf7-fe9f2f6df73f",+ "metadata": {},+ "source": [+ "## Instantiation\n",+ "\n",+ "Here we show how to create an instance of the Stripe Toolkit"+ ]+ },+ {+ "cell_type": "code",+ "execution_count": null,+ "id": "8b3ddfe9-ca79-494c-a7ab-1f56d9407a64",+ "metadata": {},+ "outputs": [],+ "source": [+ "from stripe_agent_toolkit.crewai.toolkit import StripeAgentToolkit\n",+ "\n",+ "stripe_agent_toolkit = StripeAgentToolkit(\n",+ " secret_key=os.getenv(\"STRIPE_SECRET_KEY\"),\n",+ " configuration={\n",+ " \"actions\": {\n",+ " \"payment_links\": {\n",+ " \"create\": True,\n",+ " },\n",+ " }\n",+ " },\n",+ ")"+ ]+ },+ {+ "cell_type": "markdown",+ "id": "4f53188e",+ "metadata": {},+ "source": [+ "## Agent\n",+ "\n",+ "Here's how to use the toolkit to create a basic agent in langgraph:"+ ]+ },+ {+ "cell_type": "code",+ "execution_count": null,+ "id": "4975924e",+ "metadata": {},+ "outputs": [],+ "source": [+ "from langchain_anthropic import ChatAnthropic\n",+ "from langgraph.prebuilt import create_react_agent\n",+ "\n",+ "llm = ChatAnthropic(\n",+ " model=\"claude-3-5-sonnet-20240620\",\n",+ ")\n",+ "\n",+ "langgraph_agent_executor = create_react_agent(llm, stripe_agent_toolkit.get_tools())\n",+ "\n",+ "input_state = {\n",+ " \"messages\": \"\"\"\n",+ " Create a payment link for a new product called 'test' with a price\n",+ " of $100. Come up with a funny description about buy bots,\n",+ " maybe a haiku.\n",+ " \"\"\",\n",+ "}\n",+ "\n",+ "output_state = langgraph_agent_executor.invoke(input_state)\n",+ "\n",+ "print(output_state[\"messages\"][-1].content)"+ ]+ }+ ],+ "metadata": {+ "kernelspec": {+ "display_name": ".venv",+ "language": "python",+ "name": "python3"+ },+ "language_info": {+ "codemirror_mode": {+ "name": "ipython",+ "version": 3+ },+ "file_extension": ".py",+ "mimetype": "text/x-python",+ "name": "python",+ "nbconvert_exporter": "python",+ "pygments_lexer": "ipython3",+ "version": "3.11.4"+ }+ },+ "nbformat": 4,+ "nbformat_minor": 5+}