本文へスキップ
このページは英語からの機械翻訳を使用しており、誤りや不明瞭な表現が含まれている可能性があります。最も正確な情報については、オリジナルの英語版をご覧ください。頻繁な更新のため、一部のコンテンツはオリジナルの英語になっている可能性があります。Crowdinでの取り組みに参加して、このページの翻訳改善にご協力ください。 (Crowdin translation page, Contributing guide)

ラングチェーン

概要​

カイア・エージェント・キットは、いくつかの一般的なAIフレームワークと統合されており、お好みの開発ツールを使って自律的にオンチェーンアクションを実行するエージェントを構築することができます。 このガイドでは、Kaia Agent Kitをオンチェーンアクションに使用するLangChainでAIエージェントを作成する方法を学びます。 .

前提条件​

はじめに​

このガイドでは、LangChainとKaia Agent Kitを使って、AIエージェントを構築します：

  • ネイティブトークン、ファンジブルトークン（FT）、NFTを送信する。
  • ネイティブトークン、FT、NFTの残高を確認する。
  • ブロックチェーンデータを取得 Kaiascan APIは、ネットワークサマリー、カイアの価格、アドレスのトークン残高などを取得します。

AIエージェントスタックを理解する​

コードに飛び込む前に、主要なテクノロジーを理解しよう：

**ラングチェーン

LangChainは、大規模言語モデル（LLM）を利用したアプリケーションを構築するための強力なフレームワークです。 言語モデルによる外部ツールの利用や意思決定を可能にするエージェント・アーキテクチャ、複数のインタラクションにまたがるコンテキスト認識のためのメモリ管理、エージェントがステップを踏む前に情報を考え抜くことを可能にする推論・行動パターンなどを提供する。

**カイア・エージェント・キット

一方、カイア・エージェント・キットは、AIエージェントにオンチェーンツールを接続するためのツールで、AIエージェントがカイア・ブロックチェーンとシームレスにやり取りできるようにする。 これにより、エージェントはオンチェーンでアクションを実行し、オンチェーン情報を取得し、トランザクションを自律的に検証できるようになる。

プロジェクト設定​

  1. 新しいプロジェクト・ディレクトリを作成する：

mkdir kaia-agentkit-langchain-example
cd kaia-agentkit-langchain-example

  1. Node.jsプロジェクトを初期化します：

pnpm init

  1. 依存関係をインストールします：

pnpm add @kaiachain/kaia-agent-kit @langchain/core @langchain/langgraph @langchain/google-genai @goat-sdk/adapter-langchain @goat-sdk/wallet-viem viem tsx

  1. プロジェクトのルートに.envファイルを作成する。

touch .env

新しく作成した.envファイルに以下を追加し、ダミーの値を実際の値に置き換えてください：


GOOGLE_API_KEY=your_google_api_key
WALLET_PRIVATE_KEY=your_wallet_private_key
RPC_PROVIDER_URL=your_rpc_url
KAIASCAN_API_KEY=your_kaiascan_api

警告

.envファイルや秘密鍵は決して公開リポジトリにコミットしないでください。また、使用する鍵は実際の資金とは関係なく、開発用に保管してください。 最終的には、.gitignoreファイルに.envを追加する。

**プロジェクトの構成


kaia-agentkit-langchain-example/
|── agent.ts <- create the main agent file
├── .env <- environment variables
├── package.json
├── pnpm-lock.yaml

コードの実装​

エージェント​

これはLangChain ReActエージェント、Kaiaエージェントキット、ウォレット、対話型プロンプトをセットアップするメインアプリケーションファイルです。


#!/usr/bin/env node
import readline from 'node:readline';
import { ChatGoogleGenerativeAI } from "@langchain/google-genai";
import { MemorySaver } from "@langchain/langgraph";
import { HumanMessage } from "@langchain/core/messages";
import { createReactAgent } from "@langchain/langgraph/prebuilt";
import { http } from "viem";
import { createWalletClient } from "viem";
import { privateKeyToAccount } from "viem/accounts";
import { kairos } from "viem/chains";
import { getOnChainTools } from "@goat-sdk/adapter-langchain";
import { viem } from "@goat-sdk/wallet-viem";
import { Kaia, PackagesEnum } from '@kaiachain/kaia-agent-kit';
// Load environment variables
import 'dotenv/config'
// Create a wallet client
const account = privateKeyToAccount(process.env.WALLET_PRIVATE_KEY as `0x${string}`);
const walletClient = createWalletClient({
account: account,
transport: http(process.env.RPC_PROVIDER_URL),
chain: kairos,
});
(async () => {
console.log("Initializing AI Agent...");
// Define the tools for the agent to use
const tools = await getOnChainTools({
wallet: viem(walletClient),
plugins: [Kaia({KAIA_KAIASCAN_API_KEY: process.env.KAIASCAN_API_KEY, packages: []})]
});
// Initialize the agent with Google's Generative AI
const agentModel = new ChatGoogleGenerativeAI({ model: "gemini-1.5-pro-latest" });
const agentCheckpointer = new MemorySaver(); // Initialize memory to persist state
const agent = createReactAgent({
llm: agentModel,
tools: tools,
checkpointSaver: agentCheckpointer,
});
console.log("Agent initialized and ready to chat!");
console.log("Type your questions or requests. Type 'exit' to quit.\n");
// Setup readline interface for interactive terminal
const rl = readline.createInterface({
input: process.stdin,
output: process.stdout,
});
// Thread ID to maintain conversation context
const threadId = "interactive-session-" + Date.now();
// Main interaction loop
while (true) {
const userPrompt = await new Promise<string>((resolve) => {
rl.question('You: ', resolve);
});
// Check for exit command
if (userPrompt.toLowerCase() === 'exit') {
console.log("Goodbye!");
rl.close();
break;
}
console.log("\nAgent is thinking...");
try {
// Invoke the agent with the user's message
const agentFinalState = await agent.invoke(
{
messages: [new HumanMessage(userPrompt)],
},
{ configurable: { thread_id: threadId } }
);
// Get the agent's response
const agentResponse = agentFinalState.messages[agentFinalState.messages.length - 1].content;
console.log("\nAgent:\n" + agentResponse + "\n");
} catch (error) {
// @ts-ignore
console.error("Error from agent:", error.message || error);
}
console.log("\n-------------------\n");
}
})().catch(error => {
console.error("Fatal error:", error);
process.exit(1);
});

**コード・チュートリアル

コードの核となる部分を見てみよう：

  • LangChain Components:
    • ChatGoogleGenerativeAI：グーグルのジェネレーティブAIへのインターフェース
    • メモリーセーバー：インタラクション間の会話状態を保存
    • HumanMessage：ユーザーからの入力メッセージを構造化
    • createReactAgent：ReActパターンに従ったエージェントを作成します。
  • **ブロックチェーン・ライブラリ
    • viem：ブロックチェーンと対話するためのEVMライブラリ
    • カイロス：カイロス・ネットワークのチェーン構成
  • **ツールおよびエージェントの初期化。
    • getOnChainTools：ブロックチェーン関数をLangChainツールに変換する
    • カイアKaia特有のブロックチェーンインタラクション用プラグイン
    • 高度なブロックチェーンクエリのためのAPIキー付きKaiaプラグインを組み込む
  • **LLMコンフィギュレーション
    • エージェントのインテリジェンスとしてGoogleのGemini 1.5 Proモデルを使用

エージェントの実行​

セットアップ完了。 エージェントを実行するには、ターミナルで以下のコマンドを実行する：


pnpm tsx agent.ts

AIエージェントと対話し、カイアのオンチェーン・アクションを実行できるようになりました：


What is the current Kaia balance of 0x75Bc50a5664657c869Edc0E058d192EeEfD570eb on kairos?
Please answer in KAIA and its total value in USD.
Check Kaia current price ?
Send test KAIA to this address: 0x75Bc50a5664657c869Edc0E058d192EeEfD570eb
Send 10 UTT tokens to this address: 0xd5c0d9371F3ad9c0d348dC24e17AC691048082e0 on Kairos
Send 1 FM NFT (0x61eaee91759adc35b4665fc589b95f885f685dab) with token id 1 to this address: 0xd5c0d9371F3ad9c0d348dC24e17AC691048082e0 on Kairos

**出力

その他のリソース​

ページを改善してください。