メインコンテンツまでスキップ

初めての AI Agent を構築する

このガイドでは、Agent Studio を使用して初めてのカスタマイズされた AI agent を構築する手順を説明します。​

このガイドでは、初めてのノーコード AI agent を構築します。この agent を使用すると、コードを書くことなく自然言語でサンプルのビジネスデータと対話できます。このオンボーディング体験を活用して、データセットに関する洞察を得たり、データに基づいてタスクを自動化したりしましょう。

セットアップ​

Prerequisites: このチュートリアルを完了するには、Squid アカウントが必要です。

  1. まず、Squid Console にアクセスします。アプリケーションをお持ちでない場合は、新規作成してください。その後、左側のサイドバーから Agent Studio を選択します。

  2. エージェントを追加するには、Create your first Agent をクリックします。以下の詳細を入力してください:

    • Agent ID: onboarding
    • Description: This is an agent for Squid AI's Agent Studio onboarding guide

  3. エージェントを作成するには、Create をクリックします。

  4. エージェント作成後、自動的にエージェントの設定が行える Overview タブに移動します。続行するには、画面右側の Enhance your agent の下にある Onboarding Tutorial ボタンをクリックし、Initialize Onboarding を選択してください.

    • オンボーディング体験を初期化することで、あなたのアプリケーションは自動的に新しい connector ― MongoDBデータベース ― で構成され、agent がデータと対話してタスクを自動化する方法を実証します。

エージェントのカスタマイズ​

新しい connector を取得したので、エージェントのカスタマイズを開始できます。Squid AI agent はデータやサービスと対話するために Abilities を使用します。Abilities は agent がタスクを実行するために利用できる技能のようなものです。Abilities については here をご覧ください。

エージェントの設定​

まず、エージェントの基本設定を行います。これには、Agent Studio の Overview タブにある LLM モデルと指示の設定が含まれます。

  • LLM Model: デフォルトの LLM (GPT-4o) はこの agent に適していますが、必要に応じて別の LLM を選択することもできます。
  • Instructions: エージェントがどのように応答し、ユーザーと対話すべきかの指示を提供します.
You are an expert assistant for an internal team at a homegoods business. You will answer questions about the homegoods business based on our data and your general knowledge. Only generate a PDF when the user specifically asks for it.

The database ability​

データベース ability を追加することで、agent は MongoDB データベースにクエリを実行しデータを取得できるようになります。これは、データに関する質問に答える際に役立ちます。

  1. まず、データベースのスキーマの記述を提供することが重要です。これにより、AI agent がデータの構造をよりよく把握できます。

    記述を追加するには、左側のサイドバーの Connectors タブに移動し、homegoods-business connector を選択します。次に、Schema タブをクリックし、AI features ボタンのドロップダウンから Generate Descriptions を選択して記述を追加します。追加の指示が記載されたポップアップに以下の指示を入力し、Confirm をクリックしてください。記述が生成されたら、Save Schema をクリックして変更を保存します:

All fields with a monetary value are in US dollars.
  1. エージェントに MongoDB database ability を追加します。これにより、agent は MongoDB データベースにクエリを実行しデータを取得できるようになります.
    • Agent Studio タブ内のエージェントの Overview ページに移動します。
    • ページ右側の Add Abilities をクリックします。
    • Database ability をクリックし、+ シンボルをクリックして ID が homegoods-business の MongoDB connector を追加します。
    • 使用するタイミング、agent が ability をどう使用するかの指示、およびデータベース内でクエリする特定のコレクションを指定するフィールドについて指示を求める画面が表示されます。When to use フィールドには以下の値を使用し、他の二つは空のままにしてください:
Call this connector whenever the user asks about our homegoods orders.
  1. エージェントに ability を追加するには Add connector をクリックしてください。これで database ability の使用準備が完了しました！

他の abilities を追加する​

各エージェントには、機能拡張のために追加できるいくつかの組み込み abilities が備わっています。これらの abilities には knowledge bases や、専門の AI functions が含まれます。このガイドでは、エージェントの abilities リストに 2 つの AI functions を追加します。

  1. エージェントの Overview ページで、ページ右側の Add Abilities をクリックします。
  2. AI Functions セクションまでスクロールし、createPdfFromHtml を追加します。この ability により、agent は PDF を生成できるようになり、レポート、洞察、サマリーの作成に役立ちます。
  3. 手順1を繰り返して、2 つ目の AI function searchWeb を追加します。この ability は、エージェントにウェブからの追加知識を補強するために使用します。これは、データベース内のデータに直接関連しない質問に答える際に役立ちます。

AI agent のワークフロー​

エージェントの 3 つの abilities が連携して、カスタマイズされた AI agent のワークフローを実現します。以下は、Test Agent タブで AI agent に送信するサンプルプロンプトです:

1. Generate a PDF invoice for order ID 63572.
2. Who are some of our biggest competitors in the homegoods space?
3. Show me a table of customers who have placed multiple orders.
4. How many orders have a status of Refunded?
5. What percent of orders were placed online?

AI agent を使用している際は、画面右側で agent ワークフローのプロセスが確認できることに注意してください。各ステップをドロップダウンして、より詳細な技術情報を確認できます。

複数の abilities を組み合わせたテストプロンプトも試してみてください。例えば、「Create a PDF with a list of all orders with a total over 1000」や「Search the web for the cheapest available overnight shipping to the customer's address for order ID 17011」といったプロンプトです。

AI agent を最も効果的に活用するためには、各 ability の機能と限界を理解することが重要です。例えば、データがデータベースに存在しなかったり、AI agent が必要なすべての情報にアクセスできなかったりする場合があります。そのような場合、agent は質問に答えられない旨の回答を提供します。

次のステップ​

おめでとうございます！ あなたは初めての Squid AI Agent を構築しました！

これで初めての AI agent が作成されたので、さらに abilities を追加してカスタマイズを続けることができます。また、Agent Studio documentation を参照して、ノーコード AI agent の構築と管理について詳しく学ぶか、explore other ways を参照して Squid AI を使用したカスタム AI ソリューションの構築方法を検討してください。