はじめに

このセクションでは、Goa-AI開発を始める方法をガイドします。以下を学びます：

1. 開発環境のセットアップ - GoモジュールとGoa CLIの設定
2. 最初のエージェントの作成 - Goa-AIのデザインファーストアプローチを使用

期待できること

Goa-AIで作業する際、開発ワークフローは通常以下のステップに従います：

1. デザインファースト：GoでGoa-AIのDSLを使ってエージェント定義を記述
2. コード生成：Goa CLIを使ってエージェントパッケージ、ツール仕様、ワークフローを生成
3. プランナー実装：プランナーロジック（LLM統合、ツール選択）を追加
4. ランタイム接続：エンジン、ストア、機能モジュールでランタイムを設定
5. テストと実行：生成されたクライアントを使ってエージェントをテスト

次のパスを選択

はじめにガイドを完了したら、以下ができます：

• シンプルエージェントチュートリアルで基本的なエージェント構築を深く学ぶ
• エージェント構成でAgent-as-Toolパターンを学ぶ
• MCP統合で外部ツールスイートの利用を学ぶ

ベストプラクティス

• 設計ファイルは別のdesignパッケージに保管：この分離により、エージェント設計と実装の間の明確な区別を維持できます。エージェント契約への変更をプランナーロジックから独立して管理しやすくなります。

• 設計変更後はgoa genを実行：生成されたコードを設計と同期させることが重要です。goa genを実行することで、エージェントパッケージ、ツール仕様、ワークフローが常に現在のエージェント設計を反映するようになります。

• 生成されたコードをバージョン管理：生成されたコードは再作成できますが、バージョン管理することでエージェントの進化を追跡し、デプロイメントの信頼性を高め、エージェント変更のコードレビューを容易にします。

• 生成されたツール仕様を使用：自動生成されたツール仕様は開発とバリデーションの両方で価値あるリソースとなります。ツールペイロードと結果への型安全なアクセスを提供します。

• 一貫した命名規則に従う：設計でエージェント、ツールセット、ツールに説明的で一貫した名前を使用してください。これにより、エージェントアーキテクチャがより直感的で保守しやすくなります。

• Goaの型システムを活用：Goaの豊富な型システムを活用して、設計で正確なツールペイロードとバリデーションルールを定義してください。これにより、ボイラープレートのバリデーションコードが削減され、一貫したデータ処理が保証されます。

準備はできましたか？インストールから始めて、Goa-AI開発環境をセットアップしましょう。