Unstructured API

🚀 未結構化項目

本項目主要圍繞未結構化數據處理相關工具展開，提供了環境變量設置、調試工具使用、客戶端功能擴展等功能，方便用戶進行數據處理和調試工作。

🚀 快速開始

環境變量設置

• LOG_LEVEL="ERROR"：設置此環境變量可抑制調試輸出，僅向用戶顯示清晰的消息。
• CONFIRM_TOOL_USE='false'：禁用工具使用前的確認提示。⚠️ 重要提示：請謹慎使用此設置，特別是在開發階段，因為大語言模型（LLM）可能會執行昂貴的工作流程或刪除數據。

調試工具使用

Anthropic提供了MCP Inspector工具來調試/測試你的MCP服務器。運行以下命令啟動一個調試UI：

mcp dev uns_mcp/server.py

從此處，您可以在左側窗格中添加環境變量（指向您的本地環境），並在那裡包含您的個人API密鑰作為環境變量。轉到tools，您可以測試添加到MCP服務器的功能。

若需要記錄UnstructuredClient調用參數，請設置環境變量DEBUG_API_REQUESTS=false。日誌將保存為格式為unstructured-client-{date}.log的文件，可查看該文件以調試UnstructuredClient函數的調用參數。

將終端訪問添加到最小客戶端

我們將使用@wonderwhy-er/desktop-commander將終端訪問權限添加到最小客戶端，該工具基於MCP文件系統服務器構建。請注意，客戶端（也包括LLM）現在有權訪問私人文件。

執行以下命令安裝該包：

npx @wonderwhy-er/desktop-commander setup

然後使用額外參數啟動客戶端：

uv run python minimal_client/client.py "http://127.0.0.1:8080/sse" "@wonderwhy-er/desktop-commander"
# 或者
make sse-client-terminal

使用工具的子集

如果你的客戶端只支持使用工具的一部分，需要注意以下事項：

• update_workflow工具需要與create_workflow工具一起加載到上下文中，因為它包含有關如何創建和配置自定義節點的詳細描述。

🔧 技術細節

已知問題

• update_workflow - 需要將工作流的配置（由用戶提供或通過調用get_workflow_info工具獲得）包含在上下文中，因為此工具不會像patch一樣應用更改，而是完全替換工作流配置。

📄 變更日誌

任何新開發的功能/修復/增強都將添加到CHANGELOG.md中。在穩定版本之前，優先使用0.x.x-dev預發佈格式。

🛠️ 故障排除

• 若遇到Error: spawn <command> ENOENT錯誤，意味著<command>未安裝或不在PATH中：
  • 確保已安裝它並在你的PATH中。
  • 或者在命令字段中提供該命令的絕對路徑。例如，在配置中將python替換為/opt/miniconda3/bin/python。