agentok

Agentok Studio

AG2可視化 - 具有拖放簡單性的構建代理應用程序。

警告

該項目目前正在開發中，尚未建議用於生產。

雖然證明代碼生成有效地在自動基因之外的各個運行時維護該工具的實用性，但它也揭示了與效率和可觀察性有關的挑戰。結果，我正在考慮將項目轉變為工作流引擎，而不是繼續作為獨立程序。這種更改將為後端體系結構帶來重大修改。

隨著我們的前進，您的反饋是無價的。如果您有任何想法或建議，請通過打開新問題或參加正在進行的討論來分享它們。

？什麼是Agentok Studio

Agenok Studio是一種基於AG2（以前的Autogen）的工具，該工具是Microsoft的強大代理框架，也是一個充滿活力的貢獻者社區。

可視化AG2

我們認為AG2處於下一代多代理應用技術的最前沿。 Agentok Studio通過提供直觀的視覺工具來簡化基於復雜代理的工作流程的創建和管理，從而將此概念提升到了一個新的水平。這簡化了創建者和開發人員的整個過程。

對話關係

兩個代理之間的關係至關重要。要將工具調用納入對話中，LLM必須確定要調用哪些工具，同時告知用戶代理哪些節點要執行。在這些節點之間的邊緣配置工具對於最佳操作至關重要。

代碼生成

我們努力創建一個用戶友好的工具，該工具以最小的依賴性生成本機Python代碼。簡而言之，AgensOk Studio是基於圖的AG2代碼生成器。生成的代碼是獨立的，可以作為普通Python程序在任何地方執行，僅依賴於官方ag2庫。

歡迎對該項目的貢獻（問題，拉的請求，文檔甚至錯字校正）！所有貢獻者都將被添加到貢獻牆中。

筆記

RAG功能已從該項目中刪除，因為我們認為它應該是單獨的服務。

Quickstart

要快速探索特工工作室的功能，請訪問https://studio.agentok.ai。雖然我們提供該項目的在線部署，但請注意，它不打算用於生產使用。服務級協議不能保證，並且由於破裂的變化，可以擦除存儲的數據。

登錄作為訪客或使用OAuth2帳戶後，您可以單擊創建新項目按鈕以創建一個新項目。新項目帶有示例工作流程。您可以單擊右下方的機器人圖標閃爍以啟動對話。

由於GPT-4和AG2的局限性，這個簡單的工作流程可能無法正常工作，但這是了解Agentic App和Agentok Studio的基本概念的一個很好的起點。

有關該項目的深入了解，請參考入門。

？在本地運行（與Docker）

該項目包含前端（使用Next.js構建）和後端服務（在Python中使用Fastapi），並已完全停靠。

在運行項目之前，您需要在ui ABD api目錄中創建.env文件並設置環境變量。

cp frontend/.env.sample frontend/.env
cp api/.env.sample api/.env
cp api/OAI_CONFIG_LIST.sample api/OAI_CONFIG_LIST

請注意，supabase為每個項目提供anon密鑰和service_role鍵。請確保將Anon密鑰設置為fortend的NEXT_PUBLIC_SUPABASE_ANON_KEY ，以及SUPABASE_SERVICE_KEY的服務角色鍵進行後端（API）。

在本地運行的最簡單方法是使用Docker-Compose：

docker-compose up -d

您還可以使用Docker分別構建和運行UI和服務：

docker build -t agentok-api ./api
docker run -d -p 5004:5004 agentok-api

docker build -t agentok-frontend ./frontend
docker run -d -p 2855:2855 agentok-frontend

（默認端口號2855是我們第一個辦公室的地址。）

在本地運行（沒有Docker）

如果您有興趣為該項目的開發做出貢獻或希望從源代碼運行它，則可以選擇獨立運行UI和服務。您可以做到這一點：

前端

• 導航到前端目錄cd frontend 。
• .env.local命名.env.sample
• 使用適當的軟件包管理器命令（例如pnpm install或yarn ）安裝必要的依賴項。
• 使用提供的啟動腳本（例如pnpm dev或yarn dev ）運行前端服務。

如果您經常看到與“ UseContext”相關的服務器錯誤，則可能是由於渦輪模式下的錯誤引起的。在這種情況下，請從package.json中的dev命令中刪除--turbo 。

後端服務

• 切換到API服務目錄cd api 。
• 重命名.env.sample為.env ， OAI_CONFIG_LIST.sample to OAI_CONFIG_LIST ，並正確設置變量的值。
• 安裝詩歌。
• 使用命令poetry run uvicorn agentok_api.main:app --reload --port 5004 。

LLAVA代理需要REPLICATE_API_TOKEN 。如果您需要使用此代理，請確保將此令牌包括在環境變量中。

重要：默認情況下，最新版本的AG2要求Docker進行代碼執行。要繼續，您必須：

1. 在您的本地機器上安裝Docker，或
2. 通過在api/.env文件中設置AUTOGEN_USE_DOCKER=False禁用此要求。

注意：默認情況下，由於該項目的默認部署已經停靠，因此此要求將被禁用。

數據庫服務

該項目依靠用於用戶身份驗證和數據存儲的supabase。要開始，請按照.env文件中的.ENV.Sample中的supabse開頭，請按照./db/readme.md進行準備數據庫，並設置環境變量（請參閱supabse in .env.sample中的那些變量）。

如果願意，可以部署自己的Supabase實例，但這超出了本文檔的範圍。

啟動前端和API服務後，通過遵循先前概述的步驟，您可以通過打開Web瀏覽器並導航到：

• API：http：// localhost：5004（http：// localhost提供的OpenAPI文檔：5004/docs）
• 前端：http：// localhost：2855

如果您的服務成功啟動並在預期的端口上運行，則應通過此URL查看用戶界面或從API服務中接收響應。

？‍貢獻

歡迎捐款！它不僅限於代碼，還包括項目的文檔和其他方面。您可以打開GitHub問題，也可以在我們的Discord服務器上留下評論。

該項目歡迎貢獻和建議。請先閱讀我們的貢獻指南。

如果您是Github的新手，這裡是有關參與GitHub開發的詳細幫助來源。

請考慮為AG2做出貢獻，因為Agent Studio依靠強大的基礎來實現其功能。您的貢獻可以幫助增強平台的核心功能，從而確保為多代理應用程序提供更無縫和高效的開發經驗。

該項目使用“語義釋放”來管理版本控制和發布。為了避免過於頻繁的自動釋放，我們使其成為觸發釋放的手動github動作。

要遵循語義發布過程，我們對提交消息執行了commit-lint慣例。有關更多詳細信息，請參考commlint。

貢獻者的牆

執照

該項目已在Apache 2.0獲得許可，並具有其他條款和條件。