Creating a Structure from a GitHub Repo
=======================================

Gen AI Builder SDK :ref:`ツールでエージェントを強化 <ツールでエージェントを強化>`  、 :ref:`Pipelines </edb-postgres-ai/1.3/ai-factory/gen-ai/reference/sdk/structures/pipelines>`  、および :ref:`Workflows </edb-postgres-ai/1.3/ai-factory/gen-ai/reference/sdk/structures/workflows>` 
をGen AI
Builderでホストできます。これにより、インフラストラクチャを管理せずにストラクチャを実行できます。

運用ユースケースの場合、Gen AI
BuilderをGitHubに接続し、ストラクチャのコードを1つ以上のGitHubリポジトリに保存することをお勧めします。

1. GitHubアカウントをGen AI Builderアカウントに接続します

2. `Gen AI Builder GitHub app to your GitHub account or organization <https://github.com/apps/griptape-cloud/installations/new/>`_ のインストール

- アプリに\ ``All Repositories``
  へのアクセスを許可するか、必要な特定のリポジトリを選択してください

3. リポジトリにStructure Config
   YAMLファイルがあることを確認します。リポジトリに複数のストラクチャが含まれる場合、各ストラクチャには別個のストラクチャ構成YAMLファイルが必要です。
   - 詳細については、 :ref:`Structure Config YAML <Structure Config YAML>` を参照してください。

4. Gen AI BuilderコンソールのCreate Structureページに移動します

5. GitHubリポジトリ *から* Gen AI Builder Structureを選択します

6. デプロイ元のGitHub組織、リポジトリ、およびブランチを選択します。

7. この展開の\ ``structure_config.yaml`` を指定します

8. オプションで、Webhookを有効にするおよび/または環境変数を追加します

9. *Create* をクリックして、入力した構成の詳細を使用して構造を作成します

GitHubリポジトリ情報を提供することにより、Gen AI
Builderコンソールでストラクチャを作成できるようになりました。

ZIPファイルから構造を作成する
-----------------------------

1. StructureフォルダーにStructure Config
   YAMLファイルがあることを確認します。
   Structureフォルダーに複数のストラクチャが含まれている場合、各ストラクチャには別個のストラクチャ構成YAMLファイルが必要です。
   - 詳細については、 :ref:`Structure Config YAML <Structure Config YAML>` を参照してください。

2. Structureフォルダーに機能的な `Python venv <https://docs.python.org/3/library/venv.html>`_ を作成します -
   StructureのPython依存関係での仮想環境の設定は、
   `pip <https://pip.pypa.io/en/stable/getting-started/#install-multiple-packages-using-a-requirements-file>`_ を使用して行うことができます。

3. Structureフォルダー全体をZIPファイルに圧縮します

   - MacおよびLinuxシステムでは、これは’zip’ CLIコマンドで実行できます
   - Windowsシステムでは、これは’tar.exe’PowerShellコマンドで実行できます。

4. 作成したZIPファイルを :ref:`Data Lakes <Data Lakes>` にアップロードし、アセット名をメモします

5. この展開の\ ``structure_config.yaml`` を指定します

6. オプションで、Webhookを有効にするおよび/または環境変数を追加します

7. *Create*
   をクリックして、入力した構成の詳細を使用してストラクチャを作成します

上記からバケットとアセット名を指定することにより、Gen AI
Builderコンソールでストラクチャを作成できるようになりました。

サンプルとテンプレートを使用したクイックスタート
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

クラウドのストラクチャーの使用を開始するには、
`managed-structure-template on GitHub <https://github.com/griptape-ai/managed-structure-template>`_ をチェックアウトするか、
`griptape-sample-structures from GitHub <https://github.com/griptape-ai/griptape-sample-structures/tree/main>`_ のいずれかを展開します。