Select AI Agentの開始

Select AI Agentを使用するには、前提条件を満たし、フレームワークが実行時に使用するエージェント・オブジェクトを作成します。Select AI Agentには、エージェント、ツール、タスクおよびチームを作成するプロシージャが用意されています。また、Select AIエージェント・アクションまたはDBMS_CLOUD_AI_AGENT.RUN_TEAMを使用してチームを実行できます。

次の順序を使用して、Select AIエージェント・チームを作成および実行します。

  1. 前提条件の完了

    エージェント・オブジェクトを構成する前に、Select AIの前提条件とSelect AI Agentの前提条件を確認します。詳細は、「Select AI Agentを使用するための前提条件」を参照してください。

  2. PL/SQLファンクションを作成します。

    カスタム・ツールでコールできるPL/SQLファンクションを作成します。Select AI Agentツールでは、カスタムPL/SQLファンクションまたは組込みツール・タイプ(SQLRAGWEBSEARCHNOTIFICATIONなど)を使用できます。詳細は、例: Product Return Agentの作成を参照してください。

  3. エージェントを作成します

    DBMS_CLOUD_AI_AGENT.CREATE_AGENTを使用して、作業を実行するエージェントを作成します。エージェント名を定義し、エージェントが使用するAIプロファイルを指定し、エージェントの動作をガイドするロールの指示を指定します。詳細は、例: エージェントの作成を参照してください。

  4. ツールの作成

    DBMS_CLOUD_AI_AGENT.CREATE_TOOLを使用して、エージェントがコールできるツールを登録します。ツールは、PL/SQLファンクションのコールや組込み機能の使用など、タスク処理中にエージェントが実行できる内容を定義します。詳細は、例: 組込みツールの作成を参照してください。

  5. タスクを作成します

    DBMS_CLOUD_AI_AGENT.CREATE_TASKを使用して、エージェントのタスク手順を定義します。タスクは、エージェントが従う指示と、そのタスクに使用できるツールを指定します。詳細は、例: タスクの作成を参照してください。

  6. チームの作成

    DBMS_CLOUD_AI_AGENT.CREATE_TEAMを使用して、1つ以上のエージェントをタスクに関連付け、ワークフローのプロセス・タイプを設定します。チームでは、エージェントとタスクのペアが連携してリクエストを実行する方法を定義します。詳細は、例: エージェント・チームの作成を参照してください。

  7. チームの実行

    次のいずれかの方法を使用して、Select AIエージェント・チームを実行します。

    • Select AIアクション(SELECT AI agent prompt)を使用します。

    • DBMS_CLOUD_AI_AGENT.RUN_TEAMをコールし、ファンクション・コールでプロンプトおよびその他のパラメータを指定します。

    どちらの方法でも、選択したエージェント・チームにプロンプトをルーティングし、チームの返信を返します。詳細は、Select AI Agentの使用方法および例: 組込みツールを使用したムービー分析エージェントの作成を参照してください。

  8. トラブルシューティングのためのエージェント履歴およびログの確認

    チームを実行したら、トラブルシューティングおよび診断のための Select AI Agentビューおよび履歴ビューを確認します。DBMS_CLOUD_AI_AGENTビューを使用して、エージェント、ツール、タスク、チームおよび実行履歴を検査します。詳細は、「DBMS_CLOUD_AI_AGENTビュー」を参照してください。最近の実行を調査するには、問合せ履歴および会話ビュー(USER_AI_AGENT_TEAM_HISTORYUSER_AI_AGENT_TASK_HISTORYUSER_CLOUD_AI_CONVERSATION_PROMPTSなど)を使用して、チーム実行、タスク実行、プロンプト、レスポンスおよびエージェントの考えを確認します。詳細は、「例: 最新チーム実行からのエージェント・プロンプトおよびレスポンスの表示」を参照してください。