Running a Structure
===================

ストラクチャが作成および展開されたら、以下に概説する3つの方法のいずれかでストラクチャを実行できます。作成方法に関係なく、ストラクチャの\ ``Runs``
タブに実行の詳細を表示できます。

Structure Runの詳細と出力の詳細については、
:ref:`Structure Run Events <Structure Run Events>` ドキュメントを参照してください。

Cloudコンソールから
-------------------

クラウドコンソールで、実行する構造の名前をクリックし、[ *Runs*
]タブに移動します。次に、 *Create Run* ボタンを押します。ここで、
Structure実行に渡す引数と、必要な実行固有の環境変数を指定できます。

クラウドコンソールを介して引数を渡す場合、新しい引数を新しい行で渡します。たとえば、ローカルコードが入力\ ``-i input_file.txt``
で実行される場合、クラウドで渡す引数は次のとおりです。

.. code:: bash

   - i
   input_file.txt

APIから
-------

cURLまたはHTTP要求を行うことができるその他のコードを使用して、APIを介してストラクチャを実行できます。
Gen AI Builder APIキーと、ストラクチャーの\ ``Config``
タブにある\ ``Structure Invocation URL`` が必要です。

次の例は、jsonオブジェクトとして渡した引数を使用して実行をキックオフします。

.. code:: shell

   export GT_CLOUD_API_KEY=<your API key here>
   export INVOCATION_URL=<your structure invocation URL>
   curl -H "Authorization: Bearer ${GT_CLOUD_API_KEY}" --json {"args": ["arg1"], "env_vars": [{"name":"var1", "value": "value"}]} "${INVOCATION_URL}"

他のStructure run APIの詳細については、 :ref:`StructureRuns API docs <Gen AI Builder v2023-09-19>` 
をチェックしてください。

Gen AI Builder SDKを使用する
----------------------------

:ref:`StructureRunDrivers </edb-postgres-ai/1.3/ai-factory/gen-ai/reference/sdk/drivers/structure-run-drivers#gen-ai-builder>` を使用して、Gen AI Builderでストラクチャを実行できます。