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

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

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

Agent StudioはカスタムAIエージェントソリューションを構築する最速の方法です。本チュートリアルでは、本シリーズのstep 1、step 2、step 3で培ったスキルを活かして、AIエージェントワークフローを作成します。

作成するもの​

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

必要なもの​

  • このチュートリアルは、本シリーズのstep 1およびstep 2で培ったスキルに基づいており、そこで最初のAIエージェントを作成します。まだ完了していない場合は、先に完了してください。
  • Squid ConsoleでのSquidアカウント

新しいエージェントの作成​

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

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

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

  3. Createをクリックしてエージェントを作成します。
    エージェント作成後、新しく作成したエージェントのOverviewタブにリダイレクトされます。

エージェントに指示を与える​

エージェントにカスタム指示を与えることで、独自のパーソナリティを付与できます:

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.

エージェントをサンプルデータベースに接続する​

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

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

  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. コネクタが追加されると、データベースのスキーマページにリダイレクトされます。データベーススキーマは、クエリ可能なコレクションやフィールドを含むデータベースの構造を説明します。AIエージェントがデータの構造をよりよく理解できるよう、スキーマの説明を追加することが重要です。

    説明を追加するには、スキーマページの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コネクタを追加します。
    • 能力を使用するタイミング、エージェントがその能力をどのように使用するかの指示、およびデータベース内でクエリする特定のコレクションを指定するフィールドがある画面が表示されます。When to useフィールドには、以下の値を入力し、他の2つは空白のままにしてください:
Call this connector whenever the user asks about our homegoods orders.
  1. Add connectorをクリックしてエージェントに能力を追加します。これでデータベース能力が使用可能になりました！

エージェントの機能を拡張する​

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

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

AIエージェントワークフロー​

エージェントの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エージェントを最も効果的に使用するためには、各能力の機能と制限事項を理解することが重要です。例えば、データベースに存在しないデータがあったり、エージェントが必要なすべての情報にアクセスできなかったりする場合、その際にはエージェントは質問に回答できない旨を返答します。

次のステップ​

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

  • Agent Studio onboardingシリーズの次のチュートリアルを続ける: Coming soon...

  • 高度にカスタマイズされたAIエージェントワークフローを構築したいですか？ SquidのSDKsを使用してカスタムエージェントを作成するか、実践的な学習体験を得るためにAI tutorialをご覧ください。（技術系開発者のみ）

  • ご質問がありますか？ Please reach out to us! 喜んでご支援いたします。