mastra

馬斯特拉

Mastra是一個自以為是的打字稿框架，可幫助您快速構建AI應用程序和功能。它為您提供了所需的一組原始內容：工作流程，代理，抹布，集成，同步和evals。您可以在本地計算機上運行mastra，也可以部署到無服務器雲。

Mastra的主要特徵是：

特徵	描述
LLM型號	Mastra支持各種LLM提供商，包括OpenAI，Anthropic，Google Gemini。您可以選擇特定的模型和提供商，選擇系統和用戶提示，並決定是否流式響應。
代理商	代理是語言模型選擇一系列動作的系統。在Mastra中，代理商為LLM模型提供工具，工作流和同步數據。代理可以調用​​您自己的功能或第三方集成的API，並訪問您構建的知識庫。
工具	工具是可以通過代理或工作流程執行的鍵入功能，具有內置的集成訪問和參數驗證。每個工具都有一個定義其輸入的模式，該架構是實現其邏輯的執行函數，並訪問了配置的集成。
工作流程	工作流程是耐用的基於圖形的狀態機。他們有循環，分支，等待人類輸入，嵌入其他工作流程，進行錯誤處理，重試，解析等。它們可以用代碼或視覺編輯器構建。工作流程中的每個步驟都有內置的OpenTelemetry跟踪。
抹布	檢索演出的一代（RAG）使您可以為代理人構建知識庫。 RAG是一種具有特定查詢技術的ETL管道，包括塊，嵌入和矢量搜索。
集成與同步	在Mastra中，同步是異步函數，可以在不同的執行環境中部署為背景任務。集成是為第三方服務的自動生成的，類型的API客戶端，可以用作代理商或工作流程中的步驟。
evals	Evals是自動測試，使用模型級，基於規則和統計方法評估LLM輸出。每個評估都返回可以記錄和比較的0-1之間的歸一化分數。可以通過自己的提示和評分功能來定制evals。

快速開始

先決條件

• node.js（v20.0+）

獲取LLM提供商API密鑰

如果您沒有LLM提供商的API密鑰，則可以從以下服務中獲得一項：

• Openai
• 人類
• Google雙子座

如果您沒有這些提供商的帳戶，則可以註冊並獲取API密鑰。 OpenAI和人類需要信用卡才能獲取API密鑰。雙子座沒有，並且具有寬敞的自由層的API。

創建一個新項目

作為第一步，創建一個項目目錄並導航到其中：

mkdir hello-mastra
cd hello-mastra

接下來，使用NPM初始化一個打字稿項目：

npm init -y
npm install typescript tsx @types/node @mastra/core@alpha --save-dev

添加index.ts文件

mkdir src
touch src/index.ts

然後，將此代碼添加到src/index.ts ：

 import { Agent } from '@mastra/core' ;

async function main ( ) {
  const agent = new Agent ( {
    name : 'story-writer' ,
    maxSteps : 3 ,
    model : {
      provider : 'OPEN_AI' ,
      name : 'gpt-4o' ,
      toolChoice : 'auto' ,
    } ,
    instructions : `You are a helpful assistant who writes creative stories.` ,
    tools : { } ,
  } ) ;

  const result = await agent . text ( {
    messages : [ 'Write a short story about a robot learning to paint.' ] ,
  } ) ;

  console . log ( 'Agent response:' , result . text ) ;
}

main ( ) ;

運行腳本

最後，運行腳本：

OPENAI_API_KEY= < your-openai-api-key > npx tsx src/index.ts

如果您使用的是擬人化，請設置ANTHROPIC_API_KEY 。如果您使用的是Gemini，請設置GOOGLE_GENERATIVE_AI_API_KEY 。

支持

我們有一個開放的社區不和諧。來打個招呼，讓我們知道您是否有任何疑問或需要任何幫助使事情運行。

如果您將項目留在頁面頂部，這也非常有幫助