Agentの作成

Copy

• Copy for LLM

  Copy page as Markdown for LLMs
• View as Markdown

  Open this page as Markdown
• Open in ChatGPT

  Get insights from ChatGPT
• Open in Claude

  Get insights from Claude
• Cursorに接続

  CursorにMCPサーバーをインストール
• VS Codeに接続

  VS CodeにMCPサーバーをインストール

まず、AI Agentを定義しましょう。技術的な定義は「人工知能を使用して環境と対話し、タスクを実行するソフトウェアプログラム」です。しかし、それが_何ができるか_を理解することがより重要です。AI agentはデータを収集し、経験から学習し、目標を達成するために意思決定を行います。

このトピックには以下が含まれます：

• Agentの詳細を定義する
• System Promptsを作成する
• Toolsを追加する
• Toolを指定する
• ターゲットを指定する
• Outputsを追加する
• Prompt変数を追加する

Agentを作成する

1. TD Consoleを開きます。
2. AI Agent Foundryに移動します。
3. プロジェクトを選択します。
4. Agents Tabを選択し、Create agentを選択します。

Agentの詳細を定義する

1. フォームに入力してagentの詳細を定義します。

2. Nextを選択します。

System Promptsを作成する

System Promptは、LLMモデルがどのように動作するかを自然言語で記述した指示です。構造化された形式で指示することがより適切です。役割、タスク、詳細を定義することで、agentはより期待通りに動作するようになります。

1. System promptsを選択します。

2. テキストボックスにpromptを追加します。
3. Nextを選択します。

Add Tools

toolは、knowledge base内のデータの検索やクエリ、他のagentの利用など、agentの機能を表します。

Toolを指定する

1. Toolsを選択し、+ Add toolを選択します。

2. 関数名と説明を入力します：

• Function Name：関数の一意な名前を入力します。例：list_columns
• Function Description：（オプション）関数の説明を入力します。例：使用可能なテーブルとカラムをリストします。LLMはこの説明を参照します。詳細な説明が定義されていれば、LLMは適切なツールを選択できます。

ターゲットの指定

以下のいずれかを選択します：Knowledge BaseまたはAgent。

Knowledge Base

データにアクセスしたい場合は、ターゲットとしてKnowledge Baseを選択します。

1. ターゲットとしてKnowledge Baseを選択します。

2. ドロップダウンリストからKnowledge Base名を選択します。
3. ターゲットの関数を選択します：

• List columns：対象のKnowledge Base内のテーブルスキーマをリストします。
• Search schema：検索キーワードでカラムを検索します。
• Query data directly (Presto SQL)：SQL文でデータをクエリします。

Text Knowledge Base

Textタイプの Knowledge Baseが選択されている場合、サポートされているターゲット関数はreadのみです

Runtime Text Resource Knowledge Base

Textタイプの Knowledge Baseが選択されている場合、サポートされているターゲット関数はreadのみです

Parent Segment Knowledge Base

サポートされているターゲット関数は以下の通りです：

• List segment folders：Parent Segmentに存在するフォルダをリストします
• List by folder：特定のフォルダに存在するインスタンスをリストします。これにはフォルダIDが必要です
• List attributes：Parent Segment設定で構成された属性定義を取得します
• List behaviors：Parent Segment設定で構成された行動定義を取得します
• Get segment：特定のセグメントのメタデータを取得します。これにはセグメントIDが必要です
• Get journey：特定のジャーニーのメタデータを取得します。これにはジャーニーIDが必要です
• Get audience：Parent Segment設定のメタデータを取得します。これにはジャーニーIDが必要です
• Get query：特定のセグメントのカウントSQLを取得します。これにはセグメントIDが必要です
• Query data directly：Parent SegmentデータにSQLを発行します
• Query segment analytics：特定のセグメントを分析するためのSQLを発行します。これにはセグメントIDが必要です

関数が特定のインスタンスIDを必要とする場合、agentはそのIDを取得する必要があります。通常、agentは「List segment folders」および/または「List by folder」関数を呼び出すことでIDを取得できます。

Agent

特定のタスクを既存のagentに委任するには、TargetとしてAgentを選択します。

1. TargetとしてAgentを選択します。

• Target agent: 呼び出すagent。リストからagentを選択します。
• Output mode:
  • Return : ターゲットagentは出力を呼び出し元agentに渡し、呼び出し元agentは受け取った出力結果に基づいて生成されたコンテンツを出力します
  • Show : ターゲットagentの出力が直接レンダリングされます。
• JSON schema: ツールが呼び出される際の引数構造の定義。
• Prompt template: ターゲットagentが呼び出される際に使用されるユーザープロンプト。"{{parameter_name}}"形式でパラメータを利用できます。_parameter_name_はJSON schemaで定義する必要があります。

Image Generator

Image generatorツールを使用して画像を生成します。

1. TargetとしてImage generatorを選択します

• Target image Generator : 使用するimage generator。既存のimage generatorインスタンスから選択します
• Target function :
  • Text to Image : テキストプロンプトから画像を作成します。0から1へのケースに適しています
  • Outpaint : 指定された領域の周囲を編集します
  • Inpaint : 特定領域の内側を編集します
  • Image Variation : 与えられた画像から画像のバリエーションを作成します
  • Remove Background : 指定された領域の周囲を削除します

Workflow Executor

Workflow Executorツールを使用してTD workflowを実行します。Workflowはworkflow_idで実行されます。適切なworkflowを実行するには、名前でworkflowを検索し、そのIDを取得してから実行する必要がある場合があります。Search workflowターゲット関数は、agentがworkflowを見つけるのに役立ちます。

Workflowは特定のパラメータで実行できます。システムプロンプトでパラメータのスキーマを定義し、agentがExecute workflowツールを呼び出すときにagentに生成させることができます。

1. Workflow Executorを選択します

• Target function :
  • Execute workflow : workflow idでworkflowを実行します
  • Search workflow : 実行する特定のworkflowを検索します

以下は、Workflow executionツールの使用例です。このagentを実行すると、パラメータを指定してwf_test workflowが呼び出されます。

Add Outputs

Outputは、agentがJson schemaの要件を満たすコンテンツを生成する必要がある場合に使用されます。これは、agentが他のagentからツール経由で呼び出される場合に便利です。呼び出し元agentは、呼び出し先agentがoutput関数を定義して呼び出す場合、"return"モードのツールを介して呼び出し先agentから構造化された出力を取得できます。 その他の典型的な使用例は、Ploty.jsライブラリを使用してチャートを描画することです。エージェントが_:plotly:_という名前の出力関数を呼び出すと、チャットインターフェースはPlotly.jsライブラリを使用してチャートを描画します。

カスタムOutputを作成するには

1. Outputsを選択し、次にAdd outputを選択します。

2. フォームに入力します。

3. + Add outputを選択して別の出力を追加するか、Saveを選択してAgentを保存します。

:plotly: Output

_:plotly:_を以下のように定義します。AgentがnewPlot関数を呼び出すと、plotlyチャートが出力としてレンダリングされます。

{
  "type": "object",
  "properties": {
    "data": {
      "type": "array",
      "description": "Plotly.js data JSON objects",
      "items": {
        "type": "object"
      }
    },
    "layout": {
      "type": "object",
      "description": "Plotly.js レイアウト JSON オブジェクト"
    }
  },
  "required": [
    "data"
  ]
}

Prompt variables の追加

Treasure Data は prompt variables をサポートしています。これは、実行時に必要なデータを system prompt に埋め込むための概念です。

1. Prompt variables を選択し、次に Add prompt vriable を選択します。

2. フォームに入力します。

式

• 文字列は、式をカンマ区切りで列挙したリストです (expression-1, expression-2, ...)

• 式は以下のいずれかです:

• テーブル名: 式に . や * などの特殊文字が含まれていない場合、それはテーブル名です。TABLE_NAME.* と同じです。

• "" を含むパターン: 式に特殊文字が含まれている場合、それはマッチングルールであり、 は任意の文字列にマッチします。

• !expression: 式が ! で始まる場合、後続の式を否定します。式は上記のいずれかです。

例

次のステップは user prompts. の定義です。