跳至主要內容

在 Hono 項目中整合 Mastra

本指南會示範如何使用 Mastra 及 Hono 建立可呼叫 Tool 的 AI Agent。透過 Hono 伺服器配接器，你毋須自行編寫路由或執行獨立的 Mastra 伺服器，便可將 Agent 公開為 HTTP 端點。

開始之前
開始之前 的直接連結

  • 你需要受支援模型 Provider 的 API 金鑰。如沒有偏好，可使用 OpenAI。
  • 安裝 Node.js v22.13.0 或更新版本

建立新的 Hono 應用程式（可選）
建立新的 Hono 應用程式（可選） 的直接連結

如已有 Hono 應用程式，可跳至下一步。

執行下列命令以建立新的 Hono 應用程式：

npm create hono@latest mastra-hono -- --template nodejs --install --pm npm

這會建立名為 mastra-hono 的項目，但你可以改用任何名稱。

初始化 Mastra
初始化 Mastra 的直接連結

前往 Hono 項目目錄：

cd mastra-hono

執行 mastra init。出現提示時，選擇 Provider（例如 OpenAI）並輸入金鑰：

npx mastra@latest init

這會建立包含天氣 Agent 範例的 src/mastra 資料夾，以及下列檔案：

  • index.ts - Mastra 設定，包括記憶體
  • tools/weather-tool.ts - 擷取指定地點天氣資料的 Tool
  • agents/weather-agent.ts- 使用該 Tool 的天氣 Agent，並包含提示詞

稍後你會將 src/mastra/index.ts 檔案傳給 Hono 伺服器配接器。

加入伺服器配接器
加入伺服器配接器 的直接連結

安裝 Hono 伺服器配接器套件：

npm install @mastra/hono@latest

開啟位於 src/index.ts 的 Hono 進入點檔案，並加入所需的 import 及初始化程式碼：

src/index.ts
import { serve } from '@hono/node-server'
import { Hono } from 'hono'
import { type HonoBindings, type HonoVariables, MastraServer } from '@mastra/hono'
import { mastra } from './mastra/index.js'

const app = new Hono<{ Bindings: HonoBindings; Variables: HonoVariables }>()
const server = new MastraServer({ app, mastra })

await server.init()

app.get('/', c => {
  return c.text('Hello Hono!')
})

serve(
  {
    fetch: app.fetch,
    port: 3000,
  },
  info => {
    console.log(`Server is running on http://localhost:${info.port}`)
  },
)

系統會使用現有的 Hono app 及根 ⁠mastra 實例初始化 ⁠MastraServer。呼叫 ⁠init() 會註冊 Mastra 中介軟件，並公開所有可用的 Mastra 端點。

測試你的 Agent
測試你的 Agent 的直接連結

Mastra 預設會在 /api 子路徑下加入端點，並使用你的 Agent／Workflow ID。由 mastra init 建立的預設 weather-agent 可於 /api/agents/weather-agent 使用。

啟動 Hono 伺服器：

npm run dev

在另一個終端機視窗中，使用 curl 向天氣 Agent 提問：

curl -X POST http://localhost:3000/api/agents/weather-agent/generate -H "Content-Type: application/json" -d "{\"messages\":[{\"role\":\"user\",\"content\":\"What is the weather like in Seoul?\"}]}"

下一步
下一步 的直接連結

恭喜你使用 Hono 建立了 Mastra Agent！🎉

接下來，你可以使用自己的 Tool 及邏輯擴充項目：

準備好後，可進一步了解 Mastra 如何與 Hono 整合：

On this page