Timbal AI

1) 建立帳戶並開啟 Timbal: 前往 https://timbal.ai/ 並點擊「立即免費開始」（或在 https://app.timbal.ai/ 登入）。這將使您能夠存取 Timbal Studio，您可以在其中建立代理程式、工作流程、介面和知識庫。

2) 選擇您要建立的內容（代理程式 vs 工作流程）: 在 Studio 中，決定：(a) 代理程式用於具有工具和記憶體的自主推理，或 (b) 工作流程用於具有分支邏輯和保證結果的確定性、逐步管道。

3) 透過整合（或 MCP）連接您的資料和工具: 在 Studio 中開啟「整合」並連接您的 AI 所需的系統（例如 Slack、Drive、Jira、SAP、Salesforce）。如果您已經透過 MCP 公開了工具，請將它們指向 Timbal 的 MCP 端點：api.timbal.ai/mcp。

4) (可選) 建立 RAG 的知識庫: 在 Studio 中，建立知識庫並同步您的文件/資料來源。Timbal 提供企業級檢索（混合搜尋：向量 + 全文 + SQL 風格查詢），因此代理程式/工作流程可以使用您的內部內容進行回答。

5) 配置模型路由（模型無關）: 選擇適合您用例的 LLM/供應商（OpenAI、Anthropic、Google、Mistral、Meta 或任何 OpenAI 相容端點）。Timbal 是模型無關的，支援每個代理程式、每個步驟或每個租戶切換供應商。

6) 使用開源 Python 框架（本地開發）以程式碼建置: 複製框架儲存庫並在本地執行測試：git clone https://github.com/timbal-ai/timbal.git && cd timbal && uv sync --dev && uv run pytest。然後使用 async/await 和工具建立代理程式（來自來源的範例）：import asyncio; from timbal import Agent; from timbal.tools import WebSearch; agent = Agent(name=\"assistant\", model=\"anthropic/claude-sonnet-4-6\", tools=[WebSearch()], max_tokens=1024); async def main(): result = await agent(prompt=\"What's new in AI this week?\",).collect(); print(result.output); asyncio.run(main()).

7) 在 Studio 中建置（視覺化）並在需要時匯出程式碼: 使用 Studio 視覺化組裝代理程式/工作流程和整合。Timbal 強調可匯出程式碼（無黑箱）：代理程式、工作流程和整合可以編譯成可讀的程式碼，您可以在本地執行或自行託管。

8) 新增治理：環境 + 審查工作流程 (Git 整合): 設定獨立的環境（開發/預備/生產），這樣實驗就不會影響生產。將 Timbal 變更連接到分支和拉取請求，以便在推廣到生產之前審查每個代理程式/工作流程/配置更新。

9) 部署（託管或自行託管）: 選擇部署模式：(a) 在 Timbal 託管基礎設施上進行完全託管部署（選擇區域/機器大小、擴展、回滾），或 (b) 自行託管組件。該平台支援雲端、VPC 或內部部署。

10) 從 CLI 部署（快速路徑）: 使用 Timbal CLI 搭建和部署（來自來源的範例）：$ timbal init my-agent; $ timbal deploy --env prod → deployed … → url: api.timbal.ai/agents/…. CLI 支援身份驗證、帶有 UI 的本地執行以及推送到雲端。

11) 透過 TypeScript/JavaScript SDK 呼叫您部署的 AI: 安裝並使用官方 SDK 從 Node/React/Bun 呼叫您的勞動力/代理程式/工作流程（來自來源的範例）：import Timbal from \"@timbal-ai/timbal-sdk\"; const timbal = new Timbal({ token: \"your-api-key\", orgId: \"your-org-id\", projectId: \"your-project-id\" }); const res = await timbal.callWorkforce(\"support\", { message: \"Refund #8812\" }); 您也可以透過環境變數配置並使用 as() 建立使用者範圍的客戶端。

12) 交付介面（聊天/儀表板/全通路）或嵌入到您的產品中: 使用 Timbal 介面建立自訂 UI（從聊天到儀表板到語音），並透過多個管道（例如 WhatsApp、Instagram、電子郵件、語音）交付，或將體驗嵌入到現有產品中。

13) 透過完整的可追溯性觀察和偵錯生產執行: 使用 Timbal 的可觀察性來端到端檢查追蹤：提示、工具呼叫、模型使用、時間和故障。這支援自信地偵錯和解釋決策。

14) 安全地迭代：評估、推廣和回滾: 使用內建評估/治理在推廣到生產之前驗證行為。在環境之間推廣版本，並在需要時回滾部署，以保持生產的可靠性和可稽核性。