Pular para o conteúdo
AggregaAggrega
Selecionar língua: Português (Portugal)
Esta página foi traduzida automaticamente. Ler o original em inglês.

Importar um projeto CrewAI — uma equipa de dois agentes

As declarações de agentes e tarefas de um projeto CrewAI na disposição clássica — dois agentes num mesmo modelo da OpenAI, uma tarefa para cada um — convertidas em rascunhos de ficheiros Aggrega por aggrega import, com a imagem em que o programa da crew é executado indicada uma única vez num ficheiro de respostas, e compiladas para Docker Compose.

Importar um projeto CrewAI percorre o processo passo a passo: o comando, o que pergunta, os ficheiros que escreve e porque está lá cada linha, a compilação e a crew em execução. Esta pasta contém cada etapa desse guia:

pasta ou ficheiroo que contém
source/as declarações do projeto, src/support_brief/config/agents.yaml e tasks.yaml, o .aggrega-config.yaml que torna a pasta um espaço de trabalho, e src/support_brief/import-answers.yaml, os valores que nenhuma declaração contém: a imagem de cada agente e o nome do Secret do Kubernetes a partir do qual uma compilação para Kubernetes lê a chave da OpenAI
draft/os ficheiros que aggrega import src/support_brief --target compose escreveu, inalterados, incluindo release.lock, e o que imprimiu: stdout.txt na saída padrão, import.txt na saída de erro padrão

As declarações foram escritas para este exemplo. O programa da equipa não faz parte do exemplo: a importação nunca lê nenhum programa, e a Release indica a imagem em que é executado.

Num checkout do repositório da documentação, check.sh volta a executar a importação, compara o que esta escreve e imprime com draft/, compara os blocos que o guia cita com estes ficheiros, e valida e compila o que a importação escreveu. Precisa do catálogo da biblioteca padrão (onde obter um) num checkout ao lado deste repositório, ou do respetivo diretório indicado em AGGREGA_CATALOG_DIRS.

Gerar o exemplo

É possível executar a importação deste exemplo com os comandos abaixo, ou pedir ao seu assistente de IA que a execute por si.

Escreva o exemplo numa nova pasta com o nome dele:

Terminal window
aggrega scaffold --example import-crewai

Depois, imprime os próximos comandos a executar. O primeiro entra na nova pasta:

Terminal window
cd import-crewai

Compilação

A importação cria os rascunhos dos ficheiros Aggrega ao lado do projeto, em source/. Compara o projeto com o catálogo da biblioteca padrão, que o registry predefinido do espaço de trabalho publica como um instantâneo assinado: a primeira importação obtém-no, verifica-o, guarda-o na cache de conteúdo do espaço de trabalho e identifica-o pelo seu digest no registo que escreve ao lado dos rascunhos. Um espaço de trabalho que indica as suas próprias pastas de catálogo — em AGGREGA_CATALOG_DIRS, ou sob workspace.catalog_dirs — importa antes em relação a essas. A importação lê as imagens de src/support_brief/import-answers.yaml e depois obtém aquilo de que a Release rascunhada depende, para que a compilação se siga de imediato:

Terminal window
cd source
aggrega import src/support_brief --target compose
aggrega build --release release.yaml

A imagem que o exemplo indica representa uma que é construída a partir do seu projeto; a sua construção e a execução da stack estão descritas no guia indicado acima.

Com um assistente de IA

Um assistente de IA configurado com as ferramentas do Aggrega pode fazer o mesmo: cole-lhe este prompt.

Use apenas as ferramentas do Aggrega e não crie nenhuma pasta por iniciativa própria. Se a pasta do espaço de trabalho ainda não contiver uma pasta `import-crewai`, chame uma vez a ferramenta `scaffold` com `example` definido como `import-crewai` e sem `dir`: esta escreve o exemplo numa nova pasta `import-crewai`, cuja pasta `source` contém o que este exemplo importa. Em seguida, chame a ferramenta `import` com `workspace_root` definido como `import-crewai/source`, `source` definido como `src/support_brief` e `target` definido como `compose`: esta lê as respostas de que precisa a partir de `import-answers.yaml`, dentro da pasta `src/support_brief`, escreve os seus rascunhos em `import-crewai/source` e obtém aquilo de que precisam. Em seguida, chame a ferramenta `validate` com `workspace_root` definido como `import-crewai/source` e `release` definido como `release.yaml`, e a ferramenta `build` com `workspace_root` definido como `import-crewai/source`, `release` definido como `release.yaml` e `write` definido como true. Indique-me que ficheiros o build escreveu; encontram-se em `import-crewai/source/dist/`.

Testar

Com a stack em execução tal como o guia a executa, um pedido chega à crew. A rota abaixo é a do próprio programa do guia, um pequeno servidor HTTP na porta 8000; o seu próprio programa decide a sua. A Release publica o investigador em 127.0.0.1:8000 e o redator em 127.0.0.1:8001, pelo que o pedido vai da sua máquina para o investigador:

Terminal window
curl -sS -X POST http://127.0.0.1:8000/kickoff -H 'Content-Type: application/json' \
-d '{"question": "Which support plan covers a weekend outage, and what does it cost?"}'
{
"error": "the crew failed: AuthenticationError: Error code: 401 - {'error': {'message': 'Incorrect API key provided: sk-place************-key. [… omitted: where to find an API key, and the error's type and code]"
}

A chave da execução era um marcador de posição, pelo que a resposta é a recusa dessa chave pela OpenAI. No Kubernetes, reencaminhe uma porta local para o Deployment, que não tem Service, e envie-lhe o mesmo pedido a partir de outro terminal:

Terminal window
kubectl port-forward deploy/researcher 8000:8000
Terminal window
curl -sS -X POST http://127.0.0.1:8000/kickoff -H 'Content-Type: application/json' \
-d '{"question": "Which support plan covers a weekend outage, and what does it cost?"}'

A resposta é a mesma.