Skip to main content

AgentBuilder

本指南演示如何通過使用 MCP Tools Components在 agent flow 中運行 DataStax Astra DB MCP 伺服器 來 將 AgentBuilder 用作 MCP 客戶端。

  1. 安裝 LTS 版本的 Node.js。
tip

uvx 包含在 AgentBuilder 套件中的 uv 中。

要使用 npx 伺服器命令，您必須先安裝 LTS 版本的 Node.js。如果您在 Docker 中運行 AgentBuilder，請在容器映像中安裝 Node.js 並重建，以便在運行時可以使用基於 npx 的 MCP 伺服器。更多資訊，請參閱套件管理。

如需 AgentBuilder 中 npx MCP 伺服器的範例，請參閱將 Astra DB MCP 伺服器連接到 AgentBuilder。

  1. 建立 OpenAI API 金鑰。

  2. 如果您還沒有，請建立 Astra DB Serverless (Vector) 資料庫。

  3. 取得您資料庫的 Astra DB API 端點和具有 Database Administrator 角色的 Astra 應用程式權杖。有關更多資訊，請參閱 為資料庫產生應用程式權杖。

  4. 要按照本指南操作，請基於 Simple Agent 模板建立FLOW。

    您也可以使用現有FLOW或建立空白FLOW。

  5. 移除 URL 工具，然後用 MCP Tools Components 替換它。

  6. 按以下方式配置 MCP Tools Components：

    1. 選取 Stdio 模式。

    2. 在 MCP server 欄位中，新增以下程式碼以連接到 Astra DB MCP 伺服器：


      _10
      npx -y @datastax/astra-db-mcp

    3. 在 Env 欄位中，為 ASTRA_DB_APPLICATION_TOKEN 和 ASTRA_DB_API_ENDPOINT 新增變數，並使用來自您的 Astra 資料庫的值。

      info

      在您的 AgentBuilder .env 檔案中宣告的環境變數可以在您的 MCP 伺服器命令中引用，但您無法引用在 AgentBuilder 中宣告的全域變數。

      如果您想為 ASTRA_DB_APPLICATION_TOKEN 和 ASTRA_DB_API_ENDPOINT 使用變數，請將它們新增到 AgentBuilder 的 .env 檔案中，然後重新啟動 AgentBuilder。 有關更多資訊，請參閱 全域變數。

      單獨新增每個變數。 要新增另一個變數欄位，請點擊 Add More。


      _10
      ASTRA_DB_APPLICATION_TOKEN=AstraCS:...


      _10
      ASTRA_DB_API_ENDPOINT=https://...-us-east-2.apps.astra.datastax.com

  7. 在 Agent Components中，新增您的 OpenAI API 金鑰。

    預設模型是 OpenAI 模型。 如果您想使用不同的模型，請相應地編輯 Model Provider、Model Name 和 API Key 欄位。

    Simple Agent Flow，其中 URL 工具被 MCP Tools Components替換，並且 MCP Tools Components啟動 Astra DB MCP 伺服器

  8. 開啟 Playground，然後詢問 Agent，What collections are available?

    由於 AgentBuilder 通過 MCP 伺服器連接到您的 Astra DB 資料庫，Agent 會選擇正確的工具並連接到您的資料庫以取得答案。 例如：


    _10
    The available collections in your database are:
    _10
    collection_002
    _10
    hardware_requirements
    _10
    load_collection
    _10
    nvidia_collection
    _10
    software_requirements

Search