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

ステップ 4: AI エージェントのワークフローを作成する

ユニークな能力を持つ AI エージェントをカスタマイズして、完全な AI エージェントワークフローを作成する​

Agent Studio は、カスタム AI エージェントソリューションの構築を開始する最も迅速な方法です。このチュートリアルでは、このシリーズの step 1、step 2、step 3 で身につけたスキルを基に、AI エージェントのワークフローを作成します。

作成するもの​

  • コードを書かずに、サンプルのビジネスデータに自然言語で対話できる AI エージェントワークフロー。

必要なもの​

  • このチュートリアルは、最初の AI エージェントを作成する 本シリーズの steps 1 と 2 で習得したスキルを前提としています。まだ完了していない場合は、続行する前に先にそちらを完了してください。
  • Squid Console の Squid アカウント

新しい Agent を作成する​

  1. Squid Console で Agent Studio タブに移動します。

  2. Create New Agent をクリックして Agent を追加します。Agent ID と説明を求めるウィンドウが表示されます。

    • Agent ID: workflow-agent.
    • Description: This is an agent for Squid AI's agent workflow tutorial

  3. Create をクリックして Agent を作成します。

Agent を作成すると、新しい Agent の Overview タブにリダイレクトされます。

Agent に指示を与える​

Agent にカスタム指示を提供すると、ユニークなペルソナを持たせることができます:

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.

Agent をサンプルデータベースに接続する​

次に、homegoods ビジネスの製品、注文、顧客に関連する情報を含むサンプルデータベースに Agent を接続します。これにより、Agent は提供されたデータに基づいて質問に回答できるようになります。

Agent に database ability を追加し、データベースへクエリしてデータを取得できるようにします:

  1. Agent Studio タブの Agent の Overview ページで、ページ右側の Add Abilities をクリックします。

  2. Database ability をクリックし、Add New Database メニューをドロップダウンします。下にスクロールして MongoDb を選択します。データベース接続を設定する画面が表示されます。このチュートリアル向けに Squid AI が事前設定した以下の詳細を入力してください:

    • Connector ID: homegoods-business
    • Connection String: mongodb+srv://homegoods.gxz0j4q.mongodb.net/homegoodsBusiness
    • Database Username: read-only
    • Database Password: key を mongodb-password、value を idmSZKR9Mxz90F2M とする secret を作成します。 これらの詳細を入力したら、Test Connection をクリックして接続が成功することを確認します。接続が成功したら、Add Connector をクリックして続行します。

  3. connector が追加されると、データベースの schema ページにリダイレクトされます。database schema は、クエリ可能な collections と fields を含む、データベースの構造を説明します。AI agent がデータ構造をよりよく理解できるように、database schema の説明を提供することが重要です。

    説明を追加するには、Schema ページで AI features ボタンをドロップダウンし、Generate Descriptions を選択します。

Generate descriptions button

追加の指示ポップアップで、以下の指示を追加します。その後 Confirm をクリックします。説明が生成されたら、Save Schema をクリックして変更を保存します:

All fields with a monetary value are in US dollars.
  1. Agent Studio をクリックして workflow-agent agent を選択し、Agent の Overview ページに戻ります。
    • ページ右側の Add Abilities をクリックします。
    • Database ability をクリックし、+ 記号をクリックして、ID が homegoods-business の MongoDB connector を追加します。
    • ability をいつ使用するかの指示、Agent が ability をどのように使用すべきかの指示、そしてデータベース内でクエリする特定の collections を指定するフィールドを求める画面が表示されます。以下の値を When to use フィールドに使用し、他の 2 つは空欄のままにしてください:
Call this connector whenever the user asks about our homegoods orders.
  1. Add connector をクリックして ability を Agent に追加します。これで database ability を使用する準備ができました!

Agent の機能を拡張する​

各 Agent には、Agent の機能を拡張するために追加できる、いくつかの built-in abilities が付属しています。これらの abilities には、knowledge bases と、特化した AI functions が含まれます。このガイドでは、2 つの AI functions を Agent の abilities リストに追加します。

  1. Agent の Overview ページで、ページ右側の Add Abilities をクリックします。
  2. AI Functions セクションまでスクロールし、createPdfFromHtml を追加します。この ability により Agent は PDF を生成でき、レポート、インサイト、サマリーの作成に役立ちます。
  3. step 1 を繰り返して、2 つ目の AI function searchWeb を追加します。この ability を使用して、Web から追加知識を取り込み（augment）、Agent を強化します。これは、データベース内のデータに直接関連しない質問に答える際に役立ちます。

AI Agent Workflow​

Agent の 3 つの abilities が連携して、カスタマイズされた AI エージェントワークフローを作成します。機能は、テーブル、チャート、グラフ生成など、Squid AI の built-in features によって拡張されます。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. Create a line graph of margin percentages for each product type throughout 2024.
4. Show me a table of customers who have placed multiple orders.
5. What percent of orders were placed online?
6. Create a stacked bar chart showing the value of orders each month in 2024 by order state.
7. Show me a chart of refunds as a percentage of total sales in each month of 2024 as a line and my total sales as a bars on that same graph.

「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.」のように、複数の abilities を組み合わせたプロンプトもテストしてください。

AI agents を最も効果的に使用するには、各 ability の capabilities と limitations を理解することが重要です。たとえば、一部のデータはデータベースに存在しない場合があり、また AI agent が必要な情報すべてにアクセスできない場合もあります。これらの場合、Agent は質問に答えられない旨を示すレスポンスを返します。

次のステップ​

おめでとうございます! AI エージェントワークフローの作成に成功しました。これで、ノーコードの AI workflow を作成してカスタマイズするための基本的な理解が得られました。

  • Agent Studio オンボーディングシリーズの次のチュートリアルに進む: Coming soon...

  • 高度にカスタマイズされた AI エージェントワークフローを構築したいですか? Squid の SDKs を使ってカスタム agent を作成するか、AI tutorial を確認してハンズオンで学習してください。For technical developers only.

  • 質問がありますか? Please reach out to us! ぜひお気軽にご連絡ください。開始をお手伝いします。