agentok
v0.24.1
AG2 Visualizada-Crie aplicativos agênticos com simplicidade de arrastar e soltar.
Aviso
Atualmente, este projeto está em desenvolvimento e ainda não é recomendado para o uso da produção.
Embora a geração de código tenha se mostrado eficaz na manutenção da utilidade da ferramenta em vários tempos de execução além do Autogen, ela também revelou desafios relacionados à eficiência e observabilidade. Como resultado, estou pensando em fazer a transição do projeto para um mecanismo de fluxo de trabalho, em vez de continuar como um programa independente. Essa mudança introduziria modificações significativas na arquitetura de back -end.
Seu feedback é inestimável à medida que avançamos. Se você tiver algum pensamento ou sugestão, compartilhe -os abrindo uma nova questão ou participando das discussões em andamento aqui.
O Agentok Studio é uma ferramenta construída sobre o AG2 (anteriormente Autogen), uma poderosa estrutura de agentes da Microsoft e uma comunidade vibrante de colaboradores.
Consideramos Ag2 estar na vanguarda da tecnologia de aplicações multi-agente de próxima geração. O Agentok Studio leva esse conceito para o próximo nível, oferecendo ferramentas visuais intuitivas que otimizam a criação e o gerenciamento de fluxos de trabalho complexos baseados em agentes. Isso simplifica todo o processo para criadores e desenvolvedores.
A relação entre dois agentes é essencial. Para incorporar chamadas de ferramentas em uma conversa, o LLM deve determinar quais ferramentas invocarem, ao mesmo tempo em que informará o proxy do usuário sobre quais nós executarem. A configuração de ferramentas na borda entre esses nós é crucial para a operação ideal.
Nós nos esforçamos para criar uma ferramenta fácil de usar que gera código Python nativo com dependências mínimas. Simplificando, o Agentok Studio é um gerador de código baseado em diagrama para AG2. O código gerado é independente e pode ser executado em qualquer lugar como um programa Python normal, confiando apenas na biblioteca oficial ag2 .
Contribuições (questões, solicitações de puxar, documentação e até correções de digitação) para este projeto são bem-vindas! Todos os colaboradores serão adicionados à parede de contribuição.
Observação
O recurso RAG foi removido deste projeto, pois acreditamos que deve ser um serviço separado.
Para explorar rapidamente as características do Agentok Studio, visite https://studio.agontok.ai. Embora ofereçamos uma implantação on -line deste projeto, observe que ele não se destina ao uso da produção. O contrato de nível de serviço não é garantido e os dados armazenados podem ser limpos devido a mudanças de quebra.
Após o login como convidado ou com sua conta OAuth2, você pode clicar no botão Criar um novo projeto para criar um novo projeto. O novo projeto vem com um amostra de fluxo de trabalho. Você pode clicar no ícone do robô piscando na parte inferior direita para iniciar a conversa.
Devido às limitações do GPT-4 e AG2, esse fluxo de trabalho simples pode não funcionar conforme o esperado, mas é um bom ponto de partida entender os conceitos básicos de aplicativo Agentic e Agentok Studio.
Para uma análise mais aprofundada do projeto, consulte o início.
O projeto contém o front -end (construído com o Next.js) e o serviço de back -end (construído com FASTAPI em Python) e foi totalmente dockerizado.
Antes de executar o projeto, você precisa criar um arquivo .env no diretório api da interface ui ABD e definir variáveis de ambiente.
cp frontend/.env.sample frontend/.env
cp api/.env.sample api/.env
cp api/OAI_CONFIG_LIST.sample api/OAI_CONFIG_LIST Esteja ciente de que o supabase fornece a chave anon e o serviço_role para cada projeto. Certifique -se de definir a chave anon para NEXT_PUBLIC_SUPABASE_ANON_KEY para o front -end e a chave de função de serviço para SUPABASE_SERVICE_KEY para back -end (API).
A maneira mais fácil de correr no local é usar o Docker-Comppose:
docker-compose up -dVocê também pode construir e executar a interface do usuário e o serviço separadamente com o Docker:
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
(A porta padrão número 2855 é o endereço do nosso primeiro escritório.)
Se você estiver interessado em contribuir para o desenvolvimento deste projeto ou desejar executá -lo no código -fonte, você terá a opção de executar a interface do usuário e o serviço de forma independente. Veja como você pode fazer isso:
cd frontend diretório front -end..env.sample para .env.local e defina o valor das variáveis corretamente.pnpm install ou yarn ).pnpm dev ou yarn dev ).Se você vir o erro do servidor relacionado ao 'useContext' com bastante frequência, ele é possivelmente causado pelos bugs no modo turbo. Nesse caso, remova
--turbodo comando dev no package.json.
cd api ..env.sample to .env , OAI_CONFIG_LIST.sample to OAI_CONFIG_LIST , and set the value of variables correctly.poetry run uvicorn agentok_api.main:app --reload --port 5004 . REPLICATE_API_TOKEN é necessário para o agente LLAVA. Se você precisar usar esse agente, inclua esse token em variáveis de ambiente.
IMPORTANTE : A versão mais recente do AG2 requer o Docker para execução de código por padrão. Para prosseguir, você deve:
AUTOGEN_USE_DOCKER=False no arquivo api/.env .NOTA: Este requisito está desativado por padrão, pois a implantação padrão deste projeto já está dockerizada.
Este projeto depende do supabase para autenticação do usuário e armazenamento de dados. Para começar, siga o ./db/readme.md para preparar o banco de dados e defina as variáveis de ambiente (consulte essas variáveis com o nome inicia com supabse em .env.sample) no arquivo .env .
Se preferir, você pode implantar sua própria instância Supabase, mas isso está além do escopo deste documento.
Depois de iniciar os serviços de front -end e API seguindo as etapas anteriormente descritas, você pode acessar o aplicativo abrindo seu navegador da web e navegando para:
Se seus serviços forem iniciados com sucesso e em execução nas portas esperadas, você deverá ver a interface do usuário ou receber respostas dos serviços da API por meio deste URL.
As contribuições são bem -vindas! Não se limita ao código, mas também inclui documentação e outros aspectos do projeto. Você pode abrir um problema do GitHub ou deixar comentários em nosso servidor Discord.
Este projeto recebe contribuições e sugestões. Por favor, leia nosso guia contribuinte primeiro.
Se você é novo no Github, aqui está uma fonte detalhada de ajuda para se envolver no desenvolvimento no Github.
Por favor, considere contribuir para o AG2, pois o Agentok Studio conta com uma base robusta para oferecer seus recursos. Suas contribuições podem ajudar a aprimorar as principais funcionalidades da plataforma, garantindo uma experiência de desenvolvimento mais perfeita e eficiente para aplicações multi-agentes.
Este projeto usa? Release semântica para gerenciar versões e lançamentos. Para evitar liberações automáticas muito frequentes, tornamos uma ação manual do Github para acionar a liberação.
Para seguir o processo de liberação semântica, aplicamos a Convenção Commit-Lint em mensagens de confirmação. Por favor, consulte o CommitteLint para obter mais detalhes.
O projeto é licenciado no Apache 2.0 com termos e condições adicionais.
