シーケンシャルオーケストレーション

Von Bedeutung

エージェントフレームワークのエージェントオーケストレーション機能は、試験段階にあります。これらはアクティブな開発中であり、プレビューまたはリリース候補ステージに進む前に大幅に変更される可能性があります。

順次オーケストレーションでは、エージェントはパイプラインに編成されます。各エージェントはタスクを順番に処理し、その出力をシーケンス内の次のエージェントに渡します。これは、ドキュメントレビュー、データ処理パイプライン、マルチステージ推論など、各ステップが前の手順に基づいて構築されるワークフローに最適です。

パターンを使用するタイミングや、ワークロードでパターンを回避するタイミングなど、パターンの詳細については、「シーケンシャルオーケストレーション」を参照してください。

一般的なユースケース

ドキュメントは、要約エージェント、翻訳エージェント、そして最後に品質保証エージェントを順に通過し、それぞれが前の出力を基にします。

ダイアグラム

ここでは、次の内容について学習します

エージェントのシーケンスを定義する方法(それぞれが特殊なロールを持つ)
各エージェントが前のエージェントの出力を処理するようにこれらのエージェントを調整する方法
中間出力を観察し、最終的な結果を収集する方法

エージェントの定義

エージェントは、タスクを順番に処理する特殊なエンティティです。ここでは、アナリスト、コピーライター、エディターの 3 つのエージェントを定義します。

ヒント

ここでは ChatCompletionAgent を使用しますが、任意の種類のエージェントを使用できます。

using Microsoft.SemanticKernel;
using Microsoft.SemanticKernel.Agents;
using Microsoft.SemanticKernel.Agents.Orchestration;
using Microsoft.SemanticKernel.Agents.Orchestration.Sequential;
using Microsoft.SemanticKernel.Agents.Runtime.InProcess;

// Create a kernel with an AI service
Kernel kernel = ...;

ChatCompletionAgent analystAgent = new ChatCompletionAgent {
    Name = "Analyst",
    Instructions = "You are a marketing analyst. Given a product description, identify:\n- Key features\n- Target audience\n- Unique selling points",
    Kernel = kernel,
};

ChatCompletionAgent writerAgent = new ChatCompletionAgent {
    Name = "Copywriter",
    Instructions = "You are a marketing copywriter. Given a block of text describing features, audience, and USPs, compose a compelling marketing copy (like a newsletter section) that highlights these points. Output should be short (around 150 words), output just the copy as a single text block.",
    Kernel = kernel,
};

ChatCompletionAgent editorAgent = new ChatCompletionAgent {
    Name = "Editor",
    Instructions = "You are an editor. Given the draft copy, correct grammar, improve clarity, ensure consistent tone, give format and make it polished. Output the final improved copy as a single text block.",
    Kernel = kernel,
};

省略可能: エージェントの応答を観察する

ResponseCallback プロパティを使用してシーケンスの進行に応じてエージェントの応答をキャプチャするコールバックを作成できます。

ChatHistory history = [];

ValueTask responseCallback(ChatMessageContent response)
{
    history.Add(response);
    return ValueTask.CompletedTask;
}