1. エージェントの理解

エージェント設定タブの概要

日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

Agentic Studioのカスタム ワークフローエージェント は、目的、入力、出力構造、実行ワークフローを定義する一連のタブを通じて設定されます。

ワークフローエージェントを作成または編集すると、エディターは以下のタブを表示します:

The agent editor page with the configuration tabs

以下のセクションで各タブについて説明します。

概要

Overviewタブはエージェントが何であるか、何をするのか、ユーザーがどんな入力を提供すべきかを定義する場所です。

このタブはプレイ開始時のユーザー体験に影響を与えます。これは、エージェントがランページ上でどのように提示されるか、またユーザーがエージェント開始前に提供すべき情報を決定します。

このタブでは、以下のことができます:

  • Define the agent’s name and description - エージェントに明確なアイデンティティを与え、その役割を説明すること。

  • Provide introductory information - 実行ページに表示されるヘルプテキストを追加し、ユーザーを案内します。

  • Configure required inputs - エージェント実行時にウェブサイトのURL、ファイルアップロード、トピック、プロンプトなど、ユーザーが提供すべき情報を指定すること。

カスタムMarketing Content Generatorエージェントの場合は、以下のように設定できます:

  • Name: Marketing Content Generator

  • Description: Generates viral-ready posts based on a topic or URL.

  • Input

    • Type - Prompt - 投稿の主旨を捉えています。

    • Label - Topic

    • DescriptionBriefly describe what you want to write about

    • Placeholder text - A high level summary about [topic]

    • Required - Yes

    • Min Lines - 3

パラメータ

Parametersタブは、エージェントが出力を生成する方法を導く構造化オプションを定義する場所です。

このタブはエージェントの応答の適応に影響を与えます。ユーザーは言語、オーディエンス、地域などのオプションを選択でき、それがトーン、スタイル、コンテンツ生成に影響を与えます。

このタブでは、以下のことができます:

  • コンテンツ生成に影響を与えるcategories (例: ChannelLanguageTarget audiences)を作成しましょう。

  • 各カテゴリー内にoptionsを加えます(例えば、Channelの下にLinkedInLanguageの下にFrenchなど)。

  • 文脈、口調、ベストプラクティス、すべきこと・やってはいけないことなど、each optionのガイドラインを定義しましょう。指導のために「 プロンプト作成のベストプラクティス 」を参照してください。

  • 構造化出力が必要な場合はschema Link。また、Workflowタブでエージェントアクションを編集する際にスキーマを選択することもできます。

  • フォーマットが必要な場合はHTML template Linkしてください。また、Workflowタブでエージェントアクションを編集する際にテンプレートを選択することもできます。

LinkedInコンテンツ向けに設定されたMarketing Content Generatorエージェントは以下のような機能を使うことがあります。

  • Category: Channel

  • Option: LinkedIn

    • Context - Use for professional updates or thought leadership.

    • Tone of voice - Professional and thought-provoking

    • Best practices - Include industry insights and keep posts concise

    • Do’s and Don’ts

      • Do's: Add relevant hashtags

      • Don’t: Avoid aggressive sales language

    • Schema - LinkedIn JSONスキーマ。

    • HTML template - LinkedIn HTMLテンプレート。

このセットアップにより、エージェントは定められた構造とガイドラインに従うLinkedInコンテンツを作成します。

スキーマ

Schemasタブは、一貫性があり予測可能な結果が必要なときにエージェントの出力構造を定義する場所です。

このタブは結果の整理や返送方法に影響を与えます。これにより、エージェントが一貫した構造化された出力を生成し、検証や再利用が可能であることを保証します。

スキーマは助けになるfine-tune agent output。各フィールドを明確に記述することで、モデルはより一貫性があり予測可能な回答を生み出します。構造化JSONが不要な場合は、ワークフローエディターでアクションのシステムプロンプトを設定することで出力をガイドできます。

例えば、LinkedInの投稿スキーマではbodyhashtagsheadlinementionscall_to_actionといったフィールドを定義し、すべての出力が同じ構造に従うようにします。

スキーマは、定義した パラメータ と併用したり、特定の出力フォーマットが必要な アクションの設定 時に使うことができます。

このタブでは、以下のことができます:

  • NameDescriptionを追加してスキーマを作成します。

  • フィールドとデータ型をJSONスキーマ形式で定義します:

    {
      "type": "object",
      "properties": {},
      "required": []
    }
  • 必須フィールドと検証ルールを指定してください。

以下のスキーマはLinkedIn投稿の構造を定義しています:

{
  "type": "object",
  "properties": {
    "body": {
      "type": "string",
      "description": "Main content (max 3000 characters)"
    },
    "hashtags": {
      "type": "array",
      "description": "Relevant hashtags (3-5 recommended)",
      "items": {
        "type": "string"
      }
    },
    "headline": {
      "type": "string",
      "description": "Attention-grabbing headline or opening line"
    },
    "mentions": {
      "type": "array",
      "description": "People or companies to tag",
      "items": {
        "type": "string"
      }
    },
    "call_to_action": {
      "type": "string",
      "description": "Clear call-to-action"
    }
  },
  "required": [
    "body",
    "hashtags",
    "headline",
    "mentions",
    "call_to_action"
  ],
  "additionalProperties": false
}

このスキーマにより、すべてのLinkedIn投稿が必要なセクションを含み、各フィールドの構造を明確に定義しています。テンプレートにリンクすると、生成されたコンテンツは選択したレイアウトで自動的にフォーマットされます。

HTMLテンプレート

HTML Templatesタブはエージェントの出力の提示方法を定義する場所です。

このタブは結果の表示方法に影響を与えます。構造化出力(スキーマで定義)を受け取り、レポートやドキュメントなどのレイアウトにフォーマットします。テンプレートはHandlebars構文を用いてスキーマフィールドをHTMLにマッピングし、{{title}}{{body}}などのプレースホルダーを用います。

HTMLテンプレートは、定義した パラメータ と併用したり、特定の出力レイアウトが必要な アクションの設定 時に使うことができます。

このタブでは、以下のことができます:

  • テンプレートを作成し、NameDescriptionを用意してください。

  • スキーマフィールドに合ったプレースホルダーを使ってHTMLレイアウトを構築します。例えば:

    <div class="content">
      <h1>{{title}}</h1>
      <p>{{body}}</p>
    </div>
  • レンダリングされたテンプレートをプレビューしてレイアウトとデータバインディングを確認しましょう。

以下のHTMLテンプレートは、LinkedInの投稿スキーマの出力をフォーマットしています。

<div class="linkedin-post">
  <div class="headline"><strong>{{headline}}</strong></div>
  <div class="body">{{body}}</div>
  <div class="hashtags">{{#each hashtags}}<span class="hashtag">#{{this}}</span> {{/each}}</div>
  <div class="cta">{{call_to_action}}</div>
  {{#if mentions}}<div class="mentions">{{#each mentions}}<span class="mention">@{{this}}</span> {{/each}}</div>{{/if}}
</div>

このテンプレートはスキーマフィールドをHTML要素にマッピングし、ループを使ってハッシュタグや言及を繰り返し、言及が利用可能な場合にのみ言及セクションを表示します。

ワークフロー

Workflowタブは、エージェントがタスクを完了するためにたどるステップの順序を定義する場所です。

このタブは、エージェントの入力処理、論理の適用、出力の生成に影響を与えます。ステップ間のデータの流れや結果の作成・保存方法を制御します。

Workflow editorを用いて、エージェントが実行するアクションの順序を設計します。

The Workflow editor

ワークフローエディターには以下の領域が含まれます:

  • Canvas - ワークフローアクションを追加・接続するビジュアルワークスペース(or steps)。

  • Properties pane - キャンバス上で選択した内容に基づいて以下を表示する動的な右側パネル:

    • Add Stepを選択すると、このペインに利用可能なアクションが表示されます。

    • アクションを選択すると、このペインタブにはアクションの動作を定義する 設定設定が表示され、入力・出力、システムプロンプト、メッセージテンプレート、リンクされたスキーマやHTMLテンプレート、アーティファクト保存オプションなどが含まれます。

ワークフローを作成したら、キャンバスのRunをクリックしてテストしてください。これは現在の構成と入力を使ってワークフローを実行します。ワークフローが実行されると、各ステップが順番に実行されるため、アクション間のデータ流れや出力の生成方法を検証できます。

右ペインのRunsタブを使って、各ランの結果を確認しましょう。個々のステップを検査し、入力と出力を確認し、問題やエラーを特定してデバッグに役立ちます。

Marketing Content Generator例では、ワークフローには以下のアクションが含まれることがあります。

  1. Manual Trigger - ユーザーがエージェントを実行する際にワークフローを開始する。

  2. Deep Research - トピックに関する洞察を集め、結果を保存して後のステップで活用します。

  3. Generate Content - ワークフロー入力、設定された指示(トーン、チャンネル、オーディエンスなど)、オプションのプロンプトを使ってコンテンツを作成する

  4. Save - 選択したフォーマットとファイル名設定を使って生成された結果をアーティファクトとして保存します

これらの行動が合わさって、エージェントがどのように入力を処理し、最終的な出力を生成するかを定義します。

プロンプト作成のベストプラクティス

プロンプトは、エージェント構成の複数の部分で使用可能で、指示、メッセージテンプレート、システムプロンプトなどが含まれます。これらのプロンプトは、エージェントがどのように入力を解釈し、ルールを適用し、出力を生成するかを指針します。

生成された出力の信頼性と有用性を向上させるために、以下のベストプラクティスを遵守してください:

  • Be specific - タスクと期待される出力を明確に定義すること。

    • Weak prompt - 与えられたテーマについて書く。

    • Improved prompt - トピックについて150〜200語の説明を書く。なぜそのトピックが重要なのかに焦点を当て、ユースケースを挙げましょう。ミレニアル世代向けに、テーマに基本的な知識がある人向けに書くべきです。

  • Provide context - {{topic}}のような必要な入力や変数を含めること。

    • Weak prompt - 要約を書く。

    • Improved prompt - 以下の内容について3〜4文の要旨を書く {{topic}}。プロダクトマネージャーにとって重要なポイントに焦点を当てましょう。

  • Define consistency - 必要に応じてトーン、フォーマットルール、または応答構造を指定すること。

    • Weak prompt - 特徴について説明してください。

    • Improved prompt - 特徴を明瞭で中立的な口調で説明し、簡潔で理解しやすいものに保つこと。まずタイトルから始め、その後短い説明(1〜2文)を書き、3つの主要な利点を箇条書きとして挙げ、最後に1つのユースケース例で締めくくります。

  • Avoid time-sensitive wording - latestcurrentのような用語は、動的データが提供されない限り信頼性に欠ける結果をもたらすことがあります。

    • Weak prompt - {{industry}}における最新のAIトレンドを説明してください。

    • Improved prompt- {{source_material}}で提供された情報に基づき、{{industry}}の3つの主要な傾向を説明する。

  • Ground responses - モデルに提供された入力、スキーマ、または知識源に依存するよう指示する。

    • Weak prompt - 質問に答えろ。

    • Improved prompt - {{brand_knowledge}}で提供された情報のみを用いてユーザーの質問に答える。答えがなければ、次のように答えてください: The information is not available in the provided sources

  • Make outputs actionable - 構造化データや明確な推奨など、直接利用可能な結果の要求。

    • Weak prompt - マーケティングのアイデアを出してくれ...

    • Improved prompt - {{product}}のためのマーケティングキャンペーンアイデアを5つ生成。出力をキャンペーン名、ターゲットオーディエンス、キーメッセージ、例チャネルの表として返します。

この記事を改善するための提案がある場合は、 お知らせください!