mirror of
https://github.com/hwchase17/langchain.git
synced 2025-06-26 16:43:35 +00:00
docs: Add GOAT integration to docs (#30478)
This PR adds: 1. Docs for the GOAT integration 2. An "Agentic Finance" table to the Tools page that includes GOAT **Twitter handle**: @0xaguspunk
This commit is contained in:
Agus
GitHub
parent
94a7fd2497
commit
47d50f49d9
39
docs/docs/integrations/providers/goat.mdx
Normal file
39
docs/docs/integrations/providers/goat.mdx
Normal file
@ -0,0 +1,39 @@
|
||||
# GOAT
|
||||
|
||||
[GOAT](https://github.com/goat-sdk/goat) is the finance toolkit for AI agents.
|
||||
|
||||
Create agents that can:
|
||||
|
||||
- Send and receive payments
|
||||
- Purchase physical and digital goods and services
|
||||
- Engage in various investment strategies:
|
||||
- Earn yield
|
||||
- Bet on prediction markets
|
||||
- Purchase crypto assets
|
||||
- Tokenize any asset
|
||||
- Get financial insights
|
||||
|
||||
### How it works
|
||||
GOAT leverages blockchains, cryptocurrencies (such as stablecoins), and wallets as the infrastructure to enable agents to become economic actors:
|
||||
|
||||
1. Give your agent a [wallet](https://github.com/goat-sdk/goat/tree/main#chains-and-wallets)
|
||||
2. Allow it to transact [anywhere](https://github.com/goat-sdk/goat/tree/main#chains-and-wallets)
|
||||
3. Use more than [+200 tools](https://github.com/goat-sdk/goat/tree/main#tools)
|
||||
|
||||
See everything GOAT supports [here](https://github.com/goat-sdk/goat/tree/main#chains-and-wallets).
|
||||
|
||||
**Lightweight and extendable**
|
||||
Different from other toolkits, GOAT is designed to be lightweight and extendable by keeping its core minimal and allowing you to install only the tools you need.
|
||||
|
||||
If you don't find what you need on our more than 200 integrations you can easily:
|
||||
|
||||
- Create your own plugin
|
||||
- Integrate a new chain
|
||||
- Integrate a new wallet
|
||||
- Integrate a new agent framework
|
||||
|
||||
See how to do it [here](https://github.com/goat-sdk/goat/tree/main#-contributing).
|
||||
|
||||
## Installation and Setup
|
||||
|
||||
Check out our [quickstart](https://github.com/goat-sdk/goat/tree/main/python/examples/by-framework/langchain) to see how to set up and install GOAT.
|
||||
217
docs/docs/integrations/tools/goat.ipynb
Normal file
217
docs/docs/integrations/tools/goat.ipynb
Normal file
@ -0,0 +1,217 @@
|
||||
{
|
||||
"cells": [
|
||||
{
|
||||
"cell_type": "raw",
|
||||
"id": "afaf8039",
|
||||
"metadata": {
|
||||
"vscode": {
|
||||
"languageId": "raw"
|
||||
}
|
||||
},
|
||||
"source": [
|
||||
"---\n",
|
||||
"sidebar_label: GOAT\n",
|
||||
"---"
|
||||
]
|
||||
},
|
||||
{
|
||||
"cell_type": "markdown",
|
||||
"id": "e49f1e0d",
|
||||
"metadata": {},
|
||||
"source": [
|
||||
"# GOAT\n",
|
||||
"\n",
|
||||
"[GOAT](https://github.com/goat-sdk/goat) is the finance toolkit for AI agents.\n",
|
||||
"\n",
|
||||
"## Overview\n",
|
||||
"\n",
|
||||
"Create agents that can:\n",
|
||||
"\n",
|
||||
"- Send and receive payments\n",
|
||||
"- Purchase physical and digital goods and services\n",
|
||||
"- Engage in various investment strategies:\n",
|
||||
" - Earn yield\n",
|
||||
" - Bet on prediction markets\n",
|
||||
"- Purchase crypto assets\n",
|
||||
"- Tokenize any asset\n",
|
||||
"- Get financial insights\n",
|
||||
"\n",
|
||||
"### How it works\n",
|
||||
"GOAT leverages blockchains, cryptocurrencies (such as stablecoins), and wallets as the infrastructure to enable agents to become economic actors:\n",
|
||||
"\n",
|
||||
"1. Give your agent a [wallet](https://github.com/goat-sdk/goat/tree/main#chains-and-wallets)\n",
|
||||
"2. Allow it to transact [anywhere](https://github.com/goat-sdk/goat/tree/main#chains-and-wallets)\n",
|
||||
"3. Use more than [+200 tools](https://github.com/goat-sdk/goat/tree/main#tools)\n",
|
||||
"\n",
|
||||
"See everything GOAT supports [here](https://github.com/goat-sdk/goat/tree/main#chains-and-wallets).\n",
|
||||
"\n",
|
||||
"**Lightweight and extendable**\n",
|
||||
"Different from other toolkits, GOAT is designed to be lightweight and extendable by keeping its core minimal and allowing you to install only the tools you need.\n",
|
||||
"\n",
|
||||
"If you don't find what you need on our more than 200 integrations you can easily:\n",
|
||||
"\n",
|
||||
"- Create your own plugin\n",
|
||||
"- Integrate a new chain\n",
|
||||
"- Integrate a new wallet\n",
|
||||
"- Integrate a new agent framework\n",
|
||||
"\n",
|
||||
"See how to do it [here](https://github.com/goat-sdk/goat/tree/main#-contributing)."
|
||||
]
|
||||
},
|
||||
{
|
||||
"cell_type": "markdown",
|
||||
"id": "0730d6a1-c893-4840-9817-5e5251676d5d",
|
||||
"metadata": {},
|
||||
"source": [
|
||||
"### Quickstarts\n",
|
||||
"\n",
|
||||
"The best way to get started is by using the quickstarts below. See how you can configure GOAT to achieve any of the use cases below.\n",
|
||||
"\n",
|
||||
"- **By use case**\n",
|
||||
" - **Money transmission**\n",
|
||||
" - Send and receive payments [[EVM](https://github.com/goat-sdk/goat/tree/main/python/examples/by-use-case/evm-send-and-receive-tokens), [Solana](https://github.com/goat-sdk/goat/tree/main/python/examples/by-use-case/solana-send-and-receive-tokens)]\n",
|
||||
" - **Investing**\n",
|
||||
" - Generate yield [[Solana](https://github.com/goat-sdk/goat/tree/main/python/examples/by-use-case/solana-usdc-yield-deposit)]\n",
|
||||
" - Purchase crypto assets [[EVM](https://github.com/goat-sdk/goat/tree/main/python/examples/by-use-case/evm-swap-tokens), [Solana](https://github.com/goat-sdk/goat/tree/main/python/examples/by-use-case/solana-swap-tokens)]\n",
|
||||
"- **By wallet**\n",
|
||||
" - [Crossmint](https://github.com/goat-sdk/goat/tree/main/python/examples/by-wallet/crossmint)\n",
|
||||
"- **See all python quickstarts [here](https://github.com/goat-sdk/goat/tree/main/python/examples).**\n"
|
||||
]
|
||||
},
|
||||
{
|
||||
"cell_type": "markdown",
|
||||
"id": "abd26764",
|
||||
"metadata": {},
|
||||
"source": [
|
||||
"## Setup\n",
|
||||
"\n",
|
||||
"1. Install the core package and langchain adapter:\n",
|
||||
"\n",
|
||||
"```bash\n",
|
||||
"pip install goat-sdk goat-sdk-adapter-langchain\n",
|
||||
"```\n",
|
||||
"\n",
|
||||
"2. Install the type of wallet you want to use (e.g solana):\n",
|
||||
"\n",
|
||||
"```bash\n",
|
||||
"pip install goat-sdk-wallet-solana\n",
|
||||
"```\n",
|
||||
"\n",
|
||||
"3. Install the plugins you want to use in that chain:\n",
|
||||
"\n",
|
||||
"```bash\n",
|
||||
"pip install goat-sdk-plugin-spl-token\n",
|
||||
"```\n",
|
||||
"\n",
|
||||
"## Instantiation\n",
|
||||
"\n",
|
||||
"Now we can instantiate our toolkit:\n",
|
||||
"\n",
|
||||
"```python\n",
|
||||
"from goat_adapters.langchain import get_on_chain_tools\n",
|
||||
"from goat_wallets.solana import solana, send_solana\n",
|
||||
"from goat_plugins.spl_token import spl_token, SplTokenPluginOptions\n",
|
||||
"from goat_plugins.spl_token.tokens import SPL_TOKENS\n",
|
||||
"\n",
|
||||
"# Initialize Solana client\n",
|
||||
"client = SolanaClient(os.getenv(\"SOLANA_RPC_ENDPOINT\"))\n",
|
||||
"\n",
|
||||
"# Initialize regular Solana wallet\n",
|
||||
"keypair = Keypair.from_base58_string(os.getenv(\"SOLANA_WALLET_SEED\") or \"\")\n",
|
||||
"wallet = solana(client, keypair)\n",
|
||||
"\n",
|
||||
"tools = get_on_chain_tools(\n",
|
||||
" wallet=wallet,\n",
|
||||
" plugins=[\n",
|
||||
" send_solana(),\n",
|
||||
" spl_token(SplTokenPluginOptions(\n",
|
||||
" network=\"mainnet\", # Using devnet as specified in .env\n",
|
||||
" tokens=SPL_TOKENS\n",
|
||||
" )),\n",
|
||||
" ],\n",
|
||||
" )\n",
|
||||
"```\n",
|
||||
"\n",
|
||||
"## Invocation\n",
|
||||
"```python\n",
|
||||
"tools[\"get_balance\"].invoke({ \"address\": \"0x1234567890123456789012345678901234567890\" })\n",
|
||||
"```\n",
|
||||
"\n",
|
||||
"## Use within an agent\n",
|
||||
"\n",
|
||||
"```python\n",
|
||||
"import os\n",
|
||||
"import asyncio\n",
|
||||
"from dotenv import load_dotenv\n",
|
||||
"\n",
|
||||
"# Load environment variables\n",
|
||||
"load_dotenv()\n",
|
||||
"\n",
|
||||
"from solana.rpc.api import Client as SolanaClient\n",
|
||||
"from solders.keypair import Keypair\n",
|
||||
"\n",
|
||||
"from goat_adapters.langchain import get_on_chain_tools\n",
|
||||
"from goat_wallets.solana import solana, send_solana\n",
|
||||
"from goat_plugins.spl_token import spl_token, SplTokenPluginOptions\n",
|
||||
"from goat_plugins.spl_token.tokens import SPL_TOKENS\n",
|
||||
"\n",
|
||||
"# Initialize Solana client\n",
|
||||
"client = SolanaClient(os.getenv(\"SOLANA_RPC_ENDPOINT\"))\n",
|
||||
"\n",
|
||||
"# Initialize regular Solana wallet\n",
|
||||
"keypair = Keypair.from_base58_string(os.getenv(\"SOLANA_WALLET_SEED\") or \"\")\n",
|
||||
"wallet = solana(client, keypair)\n",
|
||||
"\n",
|
||||
"# Initialize LLM\n",
|
||||
"llm = ChatOpenAI(model=\"gpt-4o-mini\")\n",
|
||||
"\n",
|
||||
"def main():\n",
|
||||
" # Initialize tools with Solana wallet\n",
|
||||
" tools = get_on_chain_tools(\n",
|
||||
" wallet=wallet,\n",
|
||||
" plugins=[\n",
|
||||
" send_solana(),\n",
|
||||
" spl_token(SplTokenPluginOptions(\n",
|
||||
" network=\"mainnet\", # Using devnet as specified in .env\n",
|
||||
" tokens=SPL_TOKENS\n",
|
||||
" )),\n",
|
||||
" ],\n",
|
||||
" )\n",
|
||||
"\n",
|
||||
" # Initialize agent\n",
|
||||
" # Your agent code here\n",
|
||||
"\n",
|
||||
"\n",
|
||||
"if __name__ == \"__main__\":\n",
|
||||
" main()\n",
|
||||
"```\n",
|
||||
"\n",
|
||||
"## API reference\n",
|
||||
"\n",
|
||||
"- For a complete list of tools, see the [GOAT SDK documentation](https://github.com/goat-sdk/goat).\n",
|
||||
"\n"
|
||||
]
|
||||
}
|
||||
],
|
||||
"metadata": {
|
||||
"kernelspec": {
|
||||
"display_name": "Python 3 (ipykernel)",
|
||||
"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.10.4"
|
||||
}
|
||||
},
|
||||
"nbformat": 4,
|
||||
"nbformat_minor": 5
|
||||
}
|
||||
@ -169,6 +169,14 @@ DATABASE_TOOL_FEAT_TABLE = {
|
||||
},
|
||||
}
|
||||
|
||||
FINANCE_TOOL_FEAT_TABLE = {
|
||||
"GOAT": {
|
||||
"link": "/docs/integrations/tools/goat",
|
||||
"pricing": "Free",
|
||||
"capabilities": "Create and receive payments, purchase physical goods, make investments, and more.",
|
||||
},
|
||||
}
|
||||
|
||||
TOOLS_TEMPLATE = """\
|
||||
---
|
||||
sidebar_position: 0
|
||||
@ -220,6 +228,12 @@ The following table shows tools that can be used to automate tasks in databases:
|
||||
|
||||
{database_table}
|
||||
|
||||
## Finance
|
||||
|
||||
The following table shows tools that can be used to execute financial transactions such as payments, purchases, and more:
|
||||
|
||||
{finance_table}
|
||||
|
||||
## All tools
|
||||
|
||||
import {{ IndexTable }} from "@theme/FeatureTables";
|
||||
@ -290,6 +304,22 @@ def get_database_table() -> str:
|
||||
return "\n".join(["|".join(row) for row in rows])
|
||||
|
||||
|
||||
def get_finance_table() -> str:
|
||||
"""Get the table of finance tools."""
|
||||
header = ["tool", "pricing", "capabilities"]
|
||||
title = ["Tool/Toolkit", "Pricing", "Capabilities"]
|
||||
rows = [title, [":-"] + [":-:"] * (len(title) - 1)]
|
||||
for finance_tool, feats in sorted(FINANCE_TOOL_FEAT_TABLE.items()):
|
||||
# Fields are in the order of the header
|
||||
row = [
|
||||
f"[{finance_tool}]({feats['link']})",
|
||||
]
|
||||
for h in header[1:]:
|
||||
row.append(feats.get(h))
|
||||
rows.append(row)
|
||||
return "\n".join(["|".join(row) for row in rows])
|
||||
|
||||
|
||||
def get_search_tools_table() -> str:
|
||||
"""Get the table of search tools."""
|
||||
header = ["tool", "pricing", "available_data"]
|
||||
@ -355,6 +385,7 @@ if __name__ == "__main__":
|
||||
productivity_table=get_productivity_table(),
|
||||
webbrowsing_table=get_webbrowsing_table(),
|
||||
database_table=get_database_table(),
|
||||
finance_table=get_finance_table(),
|
||||
)
|
||||
with open(output_integrations_dir / "tools" / "index.mdx", "w") as f:
|
||||
f.write(tools_page)
|
||||
|
||||
@ -2,6 +2,11 @@
|
||||
# it is EXPERIMENTAL and may be removed in the future
|
||||
|
||||
packages:
|
||||
- name: goat-sdk-adapter-langchain
|
||||
path: python/src/adapters/langchain
|
||||
repo: goat-sdk/goat
|
||||
name_title: GOAT SDK
|
||||
provider_page: goat
|
||||
- name: langchain-core
|
||||
path: libs/core
|
||||
repo: langchain-ai/langchain
|
||||
|
||||
Loading…
Reference in New Issue
Block a user