Skip to main content

管理檔案

每個 AgentBuilder 伺服器都有一個檔案管理系統，您可以在其中儲存要在 Flow中使用的檔案。

上傳到 AgentBuilder 檔案管理的檔案會儲存在您的 AgentBuilder 配置目錄 中，並且所有 Flow都可以使用它們。 本地儲存由 LANGFLOW_STORAGE_TYPE 設定，它只有一個允許的值 (local)。

將檔案上傳到 AgentBuilder 檔案管理將您的檔案保存在中央位置，並允許您在 Flow之間重複使用檔案，而無需重複手動上傳。

使用檔案管理 UI​

您可以使用檔案管理 UI 將檔案從本地機器上傳到您自己的 AgentBuilder 伺服器。 您也可以管理已上傳到 AgentBuilder 伺服器的所有檔案。

  1. 導航到 AgentBuilder 檔案管理：

    • AgentBuilder Desktop：在 AgentBuilder 中，在 專案頁面 頁面上，按一下專案列表下方的 我的檔案。
    • AgentBuilder OSS：從瀏覽器導航到您的 AgentBuilder 伺服器的 /files 端點，例如 http://localhost:7860/files。根據需要修改 AgentBuilder 伺服器的基礎 URL。
    • 僅後端：對於程式化檔案管理，請使用 AgentBuilder API 檔案端點。但是，以下步驟假設您正在使用檔案管理 UI。

  2. 在 我的檔案 頁面上，按一下 上傳。

  3. 選取一個或多個要上傳的檔案。

上傳檔案後，您可以在檔案管理 UI 中重新命名、下載、複製或刪除檔案。 要刪除檔案，將滑鼠懸停在檔案圖示上，選取它，然後按一下 刪除。 您可以在單一動作中刪除多個檔案。 要下載檔案，將滑鼠懸停在檔案圖示上，選取它，然後按一下 下載。 如果您在單一動作中下載多個檔案，它們會一起儲存在 zip 檔案中。

使用 AgentBuilder API 上傳和管理檔案​

使用 AgentBuilder API，您可以在 AgentBuilder 檔案管理中上傳和管理檔案，並且可以在運行時以程式設計方式將檔案發送到 Flow。

更多資訊和示例，請參閱 檔案端點 和 建立可以擷取檔案的聊天機器人。

設定最大檔案大小​

預設情況下，最大檔案大小為 1024 MB。 要修改此值，請更改 LANGFLOW_MAX_FILE_SIZE_UPLOAD 環境變數。

在 Flow中使用檔案​

要在 Flow中使用 AgentBuilder 檔案管理系統中的檔案，請將接受檔案輸入的Components新增到您的 Flow，例如 File Components。

例如，將 File Components新增到您的 Flow，按一下 選取檔案，然後從 我的檔案 列表中選取檔案。

此列表包括伺服器檔案管理系統中的所有檔案，但您只能選取 File Components支援的檔案類型。 如果您需要另一種檔案類型，您必須使用支援該檔案類型的不同Components，或者在上傳之前將其轉換為支援的類型。

有關 File Components和其他資料載入Components的更多資訊，請參閱 資料Components。

在運行時載入檔案​

您可以在 Flow中使用預載檔案，並且如果您的 Flow接受檔案輸入，您可以在運行時載入檔案。 要在 Flow中啟用檔案輸入，請執行以下操作：

  1. 將 File Components 新增到您的 Flow。

  2. 按一下 分享，選取 API 存取，然後按一下 輸入結構 以在FLOW自動產生的程式碼片段中的請求有效負載中新增 tweaks。

  3. 展開 File 部分，找到 Files 行，然後啟用 公開輸入 以允許參數通過 AgentBuilder API 在運行時設定。

  4. 關閉 輸入結構 窗格以返回 API 存取 窗格。 每個程式碼片段中的有效負載現在包含 tweaks，其中包含您的 File Components的 ID 和您在 輸入結構 中啟用的 path 金鑰：


    _10
    "tweaks": {
    _10
    "File-qYD5w": {
    _10
    "path": []
    _10
    }
    _10
    }

  5. 當您以程式設計方式運行此 Flow時，您的腳本必須將檔案上傳到 AgentBuilder 檔案管理，然後將返回的 file_path 傳遞給 /run 請求中的 path tweak：


    _10
    "tweaks": {
    _10
    "FILE_COMPONENT_ID": {
    _10
    "path": [ "file_path" ]
    _10
    }
    _10
    }

    完整示例請參閱 建立可以擷取檔案的聊天機器人 和 檔案端點。

    如果您想上傳多個檔案，您可以在 path 陣列中傳遞多個 file_path 值，例如 [ "path1", "path2" ]。

上傳圖像​

AgentBuilder 支援以下格式的 base64 圖像：

  • PNG
  • JPG/JPEG
  • GIF
  • BMP
  • WebP

您可以將圖像上傳到 Playground 聊天介面，並使用 AgentBuilder API 作為運行時輸入。

  • 在 Playground 中，您可以將圖像拖放進聊天輸入區域，或者按一下 附加圖像 圖示來選取要上傳的圖像。

  • 當您使用 /api/v1/run/$FLOW_ID 端點觸發 Flow時，您可以使用 files 參數將圖像資料作為 base64 編碼字串附加：


    _10
    curl -X POST "http://$LANGFLOW_SERVER_ADDRESS/api/v1/run/$FLOW_ID" \
    _10
    -H "Content-Type: application/json" \
    _10
    -H "x-api-key: $LANGFLOW_API_KEY" \
    _10
    -d '{
    _10
    "session_id": "custom_session_123",
    _10
    "input_value": "What is in this image?",
    _10
    "input_type": "chat",
    _10
    "output_type": "chat",
    _10
    "files": ["data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."]
    _10
    }'

對於更專業的圖像處理，請瀏覽 [Bundles] 或 建立您自己的Components。

使用影片檔案​

對於影片，請參閱 Twelve Labs 和 YouTube Bundles。

另請參閱​

Search