Enhanced Agents for Generative Language Excellence

Do que se trata este projeto?

Esse projeto implementa a visão do framework CoALA (Cognitive Architectures for Language Agents) no contexto do LangGraph, com agentes, ferramentas e estratégias de integração multiagentes para servirem de exemplo para novas implementações.

Instalação

Pré-requisitos (considerando o uso do Conda para gerenciar o ambiente python)

• Miniforge 3: O Miniforge é uma distribuição mínima do conda, que é um gerenciador de pacotes e ambientes virtuais. Ele será usado para criar um ambiente virtual para instalar as dependências do projeto.

Criando o ambiente virtual

1. Uma vez instalado o Conda, abra o terminal e digite o seguinte comando:

conda create -n eagle python=3.12

2. Após a criação do ambiente, ative-o com o comando:

conda activate eagle

3. Instale a versão mais recente do Poetry com o comando:

pip install poetry==2.3.0

4. Instale as dependências do projeto com o comando:

poetry install --with test --extras pdf

Testes

Para executar os testes, execute os seguintes passos:

1. Ative o ambiente virtual com o comando:

conda activate eagle

2. Configure as variáveis de ambiente necessárias para os testes (ex.: credenciais da API OpenAI). Veja as variáveis usadas pela aplicação em eagle/settings.py.

3. Execute a suíte de testes:

poetry run pytest eagle/tests

Ponto de Atenção

Os testes e exemplos dos notebooks estão baseados nos modelos AzureChatOpenAI para os LLMs e AzureOpenAIEmbeddings para os embeddings. Caso seja necessário utilizar outros nomes de modelos, tipos ou ajustar as relações com as variáveis de ambiente, essas alterações podem ser feitas na pasta eagle/tests/models.

Exemplos de uso das funcionalidades

A pasta sandbox/notebooks contém exemplos de uso das ferramentas. Para executar os exemplos:

1. Ative o ambiente virtual com o comando:

conda activate eagle

2. Ative o jupyter lab com o comando:

poetry run jupyter lab

3. Abra o browser e execute os notebooks da pasta sandbox/notebooks.

Acessando a documentação (MkDocs)

A documentação do projeto é gerada com MkDocs. Para subir o servidor local de documentação:

• Instale as dependências de documentação (se ainda não tiver instalado)

poetry install --with docs

• Ative o ambiente virtual

conda activate eagle

• Suba o servidor MkDocs na pasta docs-eagle

poetry run mkdocs serve -f docs-eagle/mkdocs.yml

• Acesse a documentação no navegador pelo endereço

http://127.0.0.1:8000