3ステップで始めるコアガイド

3ステップで始めるコアガイドは、Agentriaを最も速く簡単に理解できるリファレンスです。

複雑な設定や詳しい概念説明は省略し、要点だけを短く簡潔に案内することで、最初のワークフロー(Workflow)をすばやく作成できるように構成しています。以下の3ステップに沿って進めれば、ワークフローの作成から基本的なノード連携、全体の作業の流れまで自然に身につけることができ、その後の応用学習の土台としても活用できます。

開発が初めての方や、より詳しい説明とステップごとの例で深く学びたい方は、🔗ノードの使い方 ページでレベルに合ったチュートリアルをご確認ください。

ステップ1：プロジェクト作成とコンポーザー選択

まず、Agentriaの会員登録とログインを行います。

Agentriaに初めてアクセスすると、サンプルプロジェクトのWelcome to Agentria!が用意されています。このプロジェクトには、アビリティ（Ability）とエージェント（Agent）のワークフローを実際に実行して試せるサンプルが含まれています。

新しいプロジェクトを作成するには、画面右上の+プロジェクト作成（Create Project）ボタンをクリックし、名前と説明を入力して保存（Save）ボタンをクリックします。

次に、プロジェクト内でコンポーザー（Composer）を選択します。コンポーザーはワークフローの性質と目的を決めるステップで、次の2つから選択できます。

• アビリティ（Ability）： 特定の機能やタスクを迅速かつ正確に実行することに重点を置いたワークフローです。翻訳、要約、データ処理など、単一機能を中心とした業務の自動化に役立ちます。

• エージェント（Agent）： 会話ベースで動作し、メモリ機能で文脈を理解しながら継続的なやり取りをサポートするインテリジェントなワークフローです。カスタマー対応チャットボットやサポート対応など、長期的な文脈管理が必要なプロジェクトに適しています。

コンポーザーを選択したら、画面右上の+アビリティ作成（Create Ability）または+エージェント作成（Create Agent）ボタンをクリックして、アビリティまたはエージェントを作成します。これでキャンバス（Canvas）に入り、本格的にワークフローを構成できます。

ステップ2：ノードを構成する

Agentriaのワークフローは、中心となる要素である🔗ノード（Node）で構成されています。ノードはそれぞれの機能を担う単位であり、複数のノードを組み合わせることで1つの完成したフローを作り上げます。

キャンバスには、デフォルトでスタートノード（Start Node）とエンドノード（End Node）が配置されています。スタートノードは全体のフローを開始し、エンドノードは全体のフローを終了します。

必要な機能を実装するには、キャンバス下部の+ノード追加（Add Node）ボタンで新しいノードを呼び出します。ノードはドラッグ＆ドロップ（Drag and Drop）でキャンバス上に自由に配置でき、いつでも位置を調整できます。

ノードを正しく理解して接続することがワークフローの品質と効率を左右するため、各ノードがどんな役割を果たし、他のノードとどのように連携するのかを明確に把握することが重要です。

ノードをダブルクリックするとノードエディター（Node Editor）が開き、入出力変数を定義したり、コードやプロンプトを直接記述したりできます。

ただし、一部のノードはすぐには使用できず、事前準備が必要です。

• データストレージ（Data Storage）関連のノードは、先にデータストレージを作成してから使用できます。

• 外部API・サービスと連携するノードは、該当サービスから発行されたトークン（Token）で🔗クレデンシャル（Credential）を先に登録してから使用できます。

ノードとノードを接続し、データが移動する経路を作る要素をエッジ（Edge）と呼びます。エッジは単なる線ではなく、ワークフロー内でデータがどのような順序・方法で伝達されるかを定義する通路です。

ワークフローを設計する際は、常にスタートノードから中間ノードを経てエンドノードへとつながるように構成し、この流れが正しく接続されるためには各ノードをエッジでつなぐ作業が欠かせません。

エッジを活用すれば、順次的なノード接続だけでなく、分岐処理、条件付きフロー、並列実行など多様なデータフローを実現でき、ワークフローの複雑さと目的に合わせて設計する過程が必要です。

ステップ3：テストと改善

ワークフローの構成が完了したら、テストで動作を検証します。

画面右下のテスト実行（RUN TEST）ボタンをクリックすると、ワークフロー全体が実行され、ノード間の接続とデータフローが正しく動作しているかをすぐに確認できます。テスト結果は成功・失敗のメッセージと最終的な出力結果で確認します。

想定と異なる結果が出たりエラーが発生したりした場合は、該当ノードの変数設定・命令・接続状態を確認・修正し、再度テストを実行しながら改善します。

Agentriaでは、コンポーザーによってテスト方式が異なります。

アビリティテスト

• アビリティテスト（Ability Test）： 順次実行方式で各ノードの入力と出力を段階的に確認でき、機能単位の検証やデバッグ（Debugging）に役立ちます。テストを実行すると、キャンバス上で実行の流れが視覚的に表示され、ワークフローが正しく動作しているかを直感的に確認できます。

エージェントテスト

• エージェントテスト（Agent Test）： 対話形式のテスト環境で、実際の会話シナリオに近いチャットボット形式で結果を検証します。メモリと文脈管理機能も含めて、エージェントの応答品質を評価できます。

次のステップ

Agentriaでは、わずか3ステップでアイデアを現実にできます。複雑な設定なしにプロジェクトを始められ、直感的なインターフェースで誰でも簡単かつすばやくワークフローを構築できます。

さらに深く学びたい場合は、レベル別のチュートリアルとあわせて実際にワークフローを作ってみましょう。

• 🔗ノードの使い方 — ノードごとの詳しい使い方とステップごとのチュートリアルをご確認ください。

よくある質問

クイックスタートを終えるのにどれくらいかかりますか？

個人差はありますが、会員登録から最初のワークフローのテストまで、通常は数分あれば十分です。複雑な設定や概念の学習なしに、コアとなる流れだけをすばやく体験できるように構成されています。

アビリティとエージェント、どちらを先に作ってみるべきですか？

決まった作業を素早く正確に自動化したい場合はアビリティ（Ability）を、文脈を維持しながら対話形式でやり取りするワークフローが必要な場合はエージェント（Agent）を選ぶとよいでしょう。どちらのコンポーザーも同じ方法でノードを編集するため、目的に合った方から始めても問題ありません。

ノードの接続に失敗したりエラーが出たりした場合はどうすればよいですか？

テスト実行（RUN TEST）で確認したエラーメッセージをもとに、問題が発生したノードの変数設定・命令・接続状態を点検・修正し、再度テストを実行します。データストレージや外部サービス連携ノードについては、事前にストレージの作成やクレデンシャル（Credential）の登録が済んでいるかもあわせて確認します。

クイックスタートの後は何をすればよいですか？

レベル別に提供されているノードの使い方チュートリアルを参考に、実際の業務に必要なワークフローを直接作ってみることをおすすめします。