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

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

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

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

作成するもの

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

必要なもの

  • このチュートリアルは、steps 1 and 2 of this series で開発したスキルに基づいています。そこで初めての AI エージェントを作成しました。もしこのチュートリアルが完了していない場合は、続行する前に完了してください。
  • Squid Console の Squid アカウント

Create a New Agent

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

  2. Create New Agent をクリックしてエージェントを追加します。Agent ID と description の入力ウィンドウが表示されます。

    • Agent ID: workflow-agent
    • Description: This is an agent for Squid AI's agent workflow tutorial
  3. Create をクリックしてエージェントを作成します。

エージェント作成後、新しいエージェントの Overview タブにリダイレクトされます。

Give the Agent 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.

Connect your Agent to the Sample Database

次に、エージェントを、ホームグッズビジネスの製品、注文、および顧客に関連する情報を含むサンプルデータベースに接続します。これにより、エージェントが提供されたデータに基づいて質問に答えられるようになります。

エージェントに、データベースをクエリしてデータを取得する能力を追加します:

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

  2. Database 能力をクリックし、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: Create a secret where the key is mongodb-password and the value is idmSZKR9Mxz90F2M.

    これらの詳細を入力したら、Test Connection をクリックして接続が成功するか確認してください。接続に成功したら、Add Connector をクリックして続行します。

  3. コネクタが追加されると、データベースの schema ページにリダイレクトされます。データベース schema は、クエリ可能な collections とフィールドを含むデータベースの構造を記述しています。エージェントがデータの構造をより正しく理解できるように、データベース 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 エージェントを選択し、エージェントの Overview ページに戻ります。
    • ページ右側の Add Abilities をクリックします。
    • Database 能力をクリックし、+ シンボルをクリックして、ID homegoods-business の MongoDB コネクタを追加します。
    • 能力を使用するタイミングについての指示、エージェントがその能力をどのように使用すべきかについての指示、さらにデータベースでクエリする特定の collections を指定するフィールドが表示される画面が出ます。When to use フィールドには以下の値を入力し、他の二つは空欄のままにしてください:
Call this connector whenever the user asks about our homegoods orders.
  1. Add connector をクリックして、エージェントに能力を追加します。これで、データベース能力が利用可能になりました!

Extend the Agent's Capabilities

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

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

The AI Agent Workflow

エージェントの 3 つの能力は連携して、カスタマイズされた AI エージェント ワークフローを実現します。その機能は、テーブル、チャート、グラフの生成など、Squid AI の組み込み機能によって拡張されます。以下は、Test Agent タブで AI エージェントに送信するサンプルのプロンプトです:

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」があります。

各能力の機能と制限を理解することは、AI エージェントを最も効果的に使用するために重要です。例えば、データベースに存在しないデータがあったり、エージェントが必要な全情報にアクセスできなかったりする場合、エージェントはその質問に答えられない旨の応答を返します。

Next Steps

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

  • Continue with the next tutorial in the Agent Studio onboarding series: Coming soon...

  • Want to build a highly customized AI agent workflow? Squid の SDKs を使用してカスタムエージェントを作成するか、ハンズオン学習体験のための AI tutorial をご覧ください。(技術系開発者のみ)

  • Have a question? Please reach out to us! We are happy to help you get started.