Get Started
アビリティ（Ability）ガイドのチュートリアルは、Agentria（エージェントリア）入門者に向けた、最も基本でありながら必須となる手順を扱います。
本チュートリアルでは、名前と誕生日を入力し、LLMノードで生成した「今日のラッキーメッセージ」を確認するアビリティを実際に作成して実行します。
事前準備
開始するには、Agentriaでプロジェクト（Project）を作成した後、アビリティキャンバス（Canvas）に移動します。
キャンバスへの移動手順は、🔗3ステップ核心ガイド のステップ1（プロジェクト作成およびコンポーザー選択）をご参照ください。
本チュートリアルを完了すると、次の作業ができるようになります。
ノード（Node）を追加する
スタートノード（Start node）で変数を宣言する
ノードを接続する
LLMノードのプロンプトを作成する
LLMノードで生成した回答をエンドノード（End node）に渡す
アビリティテスト（Ability Test）でワークフロー（Workflow）の実行結果を確認する
ステップ1：入力変数を宣言する
Agentriaのキャンバスには、基本的に スタートノード（Start Node） と エンドノード（End Node） がそれぞれ1つずつ配置されています。
スタートノードは全体の流れを開始します。
エンドノードは全体の流れを終了します。
「今日のラッキーメッセージ」ワークフローを構成するには、まずスタートノードで必要な変数を宣言する必要があります。
スタートノードをダブルクリックするとノードエディターがポップアップで開き、ここでデータ型・名前・説明を設定して変数を宣言できます。
ラッキーメッセージの確認に必要な情報である [名前] と [誕生日] を変数として宣言します。
変数名には韓国語（ハングル）を使用できません。
名前の変数はデータ型を
Stringにし、変数名をNameとして保存します。誕生日の変数はデータ型を
Stringにし、変数名をBirthDayとして保存します。
変数の宣言が完了したら、キャンバスに戻ります。
ステップ2：ドラッグ＆ドロップでノードを追加する
次に、今日のラッキーメッセージを生成するノードを追加します。
LLMノードを使うと、簡単なプロンプト作成だけで入力値に基づいた出力を生成できます。
キャンバス下部の +ノード追加（Add Node） ボタンをクリックし、AIカテゴリからLLMノードをドラッグ＆ドロップ（Drag and Drop）で配置します。
本チュートリアルでは Azure OpenAI LLM を使用します。
ステップ3：エッジでノードを接続する
スタートノードで受け取った変数をLLMノードで使用するには、2つのノードを接続する必要があります。
この接続線をエッジ（Edge）と呼びます。
スタートノード右側のアウトピン（Out-Pin）を、LLMノード左側のインピン（In-Pin）にエッジで接続すると、スタートノードの入力値がLLMノードに渡されます。
エッジにマウスを重ねて … ボタンをクリックすると、エッジを削除して接続を解除できます。
ステップ4：システムプロンプトを作成する
LLMノードをダブルクリックするとノードエディターが開きます。
入力（Input）エリアに Name と BirthDay が表示されれば、2つのノードは正しく接続されています。
LLMノードには、🔗クレデンシャル（Credential） 設定、システムプロンプト作成、ユーザープロンプト作成、性能および出力特性を調整する詳細設定エリアが含まれます。
システムプロンプト欄には、LLMに実行してほしい役割や出力形式を指示するガイドラインを記載します。
役割や出力ルールを具体的に指示するほど、結果の品質は高まります。
例：
### 役割 あなたは「今日のラッキーメッセージ通知係」です。
ステップ5：ユーザープロンプトを作成する
ユーザープロンプトには入力値を渡す依頼文を記載します。
つまり、スタートノードで受け取ったデータをLLMに渡すステップです。
例：
名前:
誕生日:
上記情報を参考に、今日のラッキーメッセージを100文字程度で作成してください。
最初の文でユーザーの名前を呼んでください。例：「◯◯さん、こんにちは。」
誕生日から年齢と生まれた季節を推測し、出力形式に沿ってふさわしいラッキーメッセージを出力してください。
親切で気分が良くなる締めの一言を必ず含めてください。
ステップ6：ドラッグ＆ドロップで変数をバインドする
Agentriaでは、別途コードを書くことなく、ドラッグ＆ドロップで変数を簡単に呼び出せます。
次のように変数を配置してバインドします。
名前：
Name誕生日：
BirthDay「
Nameさん、こんにちは。」
ステップ7：LLM出力変数を宣言する
最終出力のためにエンドノードと接続するには、LLMノードで出力変数を宣言する必要があります。
出力（Output）エリアで鉛筆アイコンをクリックすると変数を宣言できます。
データ型は String を指定し、変数名を FortuneMessage に設定すると、LLMノードの設定は完了です。
本チュートリアルでは、LLMノードの詳細設定はデフォルト値のまま進めます。
ステップ8：ノードテストを実行する
プロンプトの構成を終えたら、入力（Input）エリアの テスト（TEST） ボタンを押してノードテストを実行します。
🔗ノードテスト とは、ノードエディター内で個別に行える点検作業です。
このテストでノードが正しく構成されていることを確認してから他のノードと接続することで、エラーを減らし安定してフローをつなげられます。
名前と誕生日を入力してテストを実行した際に、運勢メッセージが正常に出力されれば、LLMノードは正しく構成されています。
ステップ9：エンドノードを接続する
生成された「今日の運勢」出力をエンドノードに渡します。
キャンバスに戻り、LLMノードとエンドノードをエッジで接続します。
エンドノードをダブルクリックしてノードエディターを開き、String 型の Result 変数を追加します。
LLMノードで生成した Fortune 変数を選択、またはドラッグ＆ドロップで Result 変数に接続します。
これで「今日のラッキーメッセージ」生成ワークフローが完成しました。
ステップ10：アビリティテストでワークフロー全体を実行する
キャンバス右下の テスト実行（RUN TEST） ボタンをクリックすると、完成したワークフロー全体を実行できます。
単体テストと同様に名前と誕生日を入力して実行すると、出力変数 Today に今日の運勢結果が表示されます。
Output:
{
"Result": "..."
}
次のステップ
🎉 おめでとうございます！ Agentriaを使って「今日のラッキーメッセージ」ワークフローを完成させました。
これからはさまざまな入力値で結果を確認し、LLMプロンプトを調整しながらワークフローの性能を改善してみてください。
Agentriaは、アイデアを現実に変える可能性の空間です。
あなたの想像力によって、ワークフローは無限に拡張できます。