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获得许可，并具有其他条款和条件。