CrewAI プロジェクトをインポートする — 2 つのエージェントからなるクルー
従来のレイアウトの CrewAI プロジェクトにおけるエージェントとタスクの宣言 — 1 つの OpenAI モデル上の 2 つのエージェントと、それぞれに 1 つのタスク — を、aggrega import で Aggrega ファイルに下書きし、crew のプログラムが動作するイメージを回答ファイルで一度だけ指定したうえで、Docker Compose 向けにビルドしたものです。
CrewAI プロジェクトをインポートする では、コマンド、それが尋ねる内容、書き出すファイルと各行がある理由、ビルド、そして crew の実行までを順を追って説明します。このフォルダーには、そのウォークスルーの各段階が収められています:
| フォルダーまたはファイル | 内容 |
|---|---|
source/ | プロジェクトの宣言 src/support_brief/config/agents.yaml と tasks.yaml、フォルダーをワークスペースにする .aggrega-config.yaml、そしてどの宣言にも含まれない値を持つ src/support_brief/import-answers.yaml:各エージェントのイメージと、Kubernetes 向けのビルドが OpenAI キーを読み取る Kubernetes Secret の名前 |
draft/ | aggrega import src/support_brief --target compose が書き出したファイル(release.lock を含め変更なし)と、出力した内容:標準出力は stdout.txt、標準エラーは import.txt |
宣言はこの例のために書かれたものです。クルーのプログラムはこの例に含まれません。インポートはプログラムを読むことはなく、それが動作するイメージは Release が指定します。
ドキュメントリポジトリのチェックアウトでは、check.sh がインポートを再実行し、書き出した内容と出力した内容を draft/ と比較し、ウォークスルーが引用するブロックをこれらのファイルと比較して、インポートが書き出したものを検証しビルドします。このリポジトリの隣に標準ライブラリのカタログ(入手先)がチェックアウトされているか、そのディレクトリが AGGREGA_CATALOG_DIRS に指定されている必要があります。
サンプルを生成する
この例のインポートは、以下のコマンドで実行することも、AI アシスタントに代わりに実行させることもできます。
例の名前を付けた新しいフォルダーに例を書き出します。
aggrega scaffold --example import-crewaiその後、次に実行するコマンドを表示します。最初のコマンドは新しいフォルダーに移動します。
cd import-crewaiビルド
インポートは、プロジェクトの横の source/ に Aggrega ファイルを下書きします。プロジェクトを標準ライブラリのカタログと照らし合わせます。このカタログは、ワークスペースのデフォルトレジストリが署名付きスナップショットとして公開しているものです:最初のインポートでそれを取得して検証し、ワークスペースのコンテンツキャッシュに保持し、下書きの横に書き出す記録にそのダイジェストで名前を記します。独自のカタログフォルダーを指定するワークスペース — AGGREGA_CATALOG_DIRS で、または workspace.catalog_dirs の下で — では、代わりにそれらに対してインポートします。インポートは src/support_brief/import-answers.yaml からイメージを読み取り、続いて下書きされた Release が依存するものをプルするため、すぐにビルドに進めます:
cd sourceaggrega import src/support_brief --target composeaggrega build --release release.yaml例で指定しているイメージは、プロジェクトからビルドするイメージを表しています。そのビルド方法とスタックの実行方法は、上記リンク先のウォークスルーにあります。
AI アシスタントを使う
Aggrega のツールでセットアップした AI アシスタントでも同じことができます。次のプロンプトを貼り付けてください。
Aggrega のツールだけを使い、フォルダーは自分で作成しないでください。ワークスペースフォルダーにまだ `import-crewai` フォルダーがない場合は、`example` を `import-crewai` に設定し、`dir` を指定せずに `scaffold` ツールを一度呼び出してください。このツールは例を新しい `import-crewai` フォルダーに書き込み、その `source` フォルダーにこの例がインポートするものが入ります。次に、`workspace_root` を `import-crewai/source`、`source` を `src/support_brief`、`target` を `compose` に設定して `import` ツールを呼び出してください。このツールは必要な回答を `src/support_brief` フォルダー内の `import-answers.yaml` から読み取り、下書きを `import-crewai/source` に書き込み、下書きが必要とするものをプルします。次に、`workspace_root` を `import-crewai/source`、`release` を `release.yaml` に設定して `validate` ツールを、`workspace_root` を `import-crewai/source`、`release` を `release.yaml`、`write` を true に設定して `build` ツールを呼び出してください。ビルドが書き込んだファイルを教えてください。それらは `import-crewai/source/dist/` の下にあります。テストする
ウォークスルーと同じようにスタックを実行すると、1 つのリクエストが crew に届きます。以下のルートはウォークスルー自身のプログラム、つまりポート 8000 で動く小さな HTTP サーバーのものです。独自のプログラムでは、そのプログラムがルートを決めます。Release はリサーチャーを 127.0.0.1:8000 で、ライターを 127.0.0.1:8001 で公開するため、リクエストは自分のマシンからリサーチャーに送ります:
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]"}この実行のキーはプレースホルダーだったため、応答はそのキーに対する OpenAI の拒否です。Kubernetes では、Service を持たない Deployment にローカルポートをフォワードし、別のターミナルからそこへ同じリクエストを送信します:
kubectl port-forward deploy/researcher 8000:8000curl -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?"}'応答は同じです。