From fcb09219e76f7e36534dafe91cbd4a202c505048 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Tue, 20 May 2025 03:19:32 +0000 Subject: [PATCH 1/7] Initial plan for issue From c3ce67a0182eb883f38f62e054564999e2a488f0 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Tue, 20 May 2025 03:23:35 +0000 Subject: [PATCH 2/7] Add documentation comments to shared model interfaces and records Co-authored-by: 07JP27 <11060273+07JP27@users.noreply.github.com> --- DurableMultiAgentTemplate.Shared/Model/AdditionalLinkInfo.cs | 4 ++++ .../Model/AdditionalMarkdownInfo.cs | 4 ++++ DurableMultiAgentTemplate.Shared/Model/IAdditionalInfo.cs | 4 ++++ 3 files changed, 12 insertions(+) diff --git a/DurableMultiAgentTemplate.Shared/Model/AdditionalLinkInfo.cs b/DurableMultiAgentTemplate.Shared/Model/AdditionalLinkInfo.cs index 2e936b8..15306c3 100644 --- a/DurableMultiAgentTemplate.Shared/Model/AdditionalLinkInfo.cs +++ b/DurableMultiAgentTemplate.Shared/Model/AdditionalLinkInfo.cs @@ -2,6 +2,10 @@ namespace DurableMultiAgentTemplate.Shared.Model; +/// +/// リンク形式の補足情報を表すレコード。 +/// エージェントの回答に追加情報としてリンクを提供する場合に使用されます。 +/// public record AdditionalLinkInfo( [property: Description("リンクのラベルとして表示されるテキスト")] string LinkText, diff --git a/DurableMultiAgentTemplate.Shared/Model/AdditionalMarkdownInfo.cs b/DurableMultiAgentTemplate.Shared/Model/AdditionalMarkdownInfo.cs index 8015a82..2ebce15 100644 --- a/DurableMultiAgentTemplate.Shared/Model/AdditionalMarkdownInfo.cs +++ b/DurableMultiAgentTemplate.Shared/Model/AdditionalMarkdownInfo.cs @@ -2,6 +2,10 @@ namespace DurableMultiAgentTemplate.Shared.Model; +/// +/// Markdown形式の補足情報を表すレコード。 +/// エージェントの回答に追加情報としてMarkdown形式のテキストを提供する場合に使用されます。 +/// public record AdditionalMarkdownInfo( [property: Description("Markdown形式の補足情報")] string MarkdownText) : IAdditionalInfo; diff --git a/DurableMultiAgentTemplate.Shared/Model/IAdditionalInfo.cs b/DurableMultiAgentTemplate.Shared/Model/IAdditionalInfo.cs index 7c57859..293f528 100644 --- a/DurableMultiAgentTemplate.Shared/Model/IAdditionalInfo.cs +++ b/DurableMultiAgentTemplate.Shared/Model/IAdditionalInfo.cs @@ -2,6 +2,10 @@ namespace DurableMultiAgentTemplate.Shared.Model; +/// +/// 補足情報のインターフェース。 +/// このインターフェースを実装したクラスは、エージェントからの応答に追加される補足情報として使用されます。 +/// [JsonDerivedType(typeof(AdditionalMarkdownInfo), typeDiscriminator: "markdown")] [JsonDerivedType(typeof(AdditionalLinkInfo), typeDiscriminator: "link")] public interface IAdditionalInfo; From a024d830fbc834fb588da8337ed6843dd4564c3f Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Tue, 20 May 2025 03:25:46 +0000 Subject: [PATCH 3/7] Add documentation comments to agent-related classes Co-authored-by: 07JP27 <11060273+07JP27@users.noreply.github.com> --- DurableMultiAgentTemplate/Agent/AgentActivityName.cs | 4 ++++ DurableMultiAgentTemplate/Agent/AgentDefinition.cs | 4 ++++ .../Agent/Synthesizer/SynthesizerWithAdditionalInfoPrompt.cs | 4 ++++ 3 files changed, 12 insertions(+) diff --git a/DurableMultiAgentTemplate/Agent/AgentActivityName.cs b/DurableMultiAgentTemplate/Agent/AgentActivityName.cs index 21d261b..0824e38 100644 --- a/DurableMultiAgentTemplate/Agent/AgentActivityName.cs +++ b/DurableMultiAgentTemplate/Agent/AgentActivityName.cs @@ -1,5 +1,9 @@ namespace DurableMultiAgentTemplate.Agent; +/// +/// エージェントのアクティビティ名を定義する静的クラス。 +/// オーケストレーターエージェントと各ワーカーエージェントの名前を定数として提供します。 +/// public static class AgentActivityName { // Orchestrator Agent functions diff --git a/DurableMultiAgentTemplate/Agent/AgentDefinition.cs b/DurableMultiAgentTemplate/Agent/AgentDefinition.cs index e6c2767..039b995 100644 --- a/DurableMultiAgentTemplate/Agent/AgentDefinition.cs +++ b/DurableMultiAgentTemplate/Agent/AgentDefinition.cs @@ -4,6 +4,10 @@ namespace DurableMultiAgentTemplate.Agent; +/// +/// エージェントの定義を提供するクラス。 +/// 各エージェントの機能、説明、パラメータを定義します。 +/// //https://learn.microsoft.com/ja-jp/azure/ai-services/openai/how-to/dotnet-migration?tabs=stable internal class AgentDefinition { diff --git a/DurableMultiAgentTemplate/Agent/Synthesizer/SynthesizerWithAdditionalInfoPrompt.cs b/DurableMultiAgentTemplate/Agent/Synthesizer/SynthesizerWithAdditionalInfoPrompt.cs index 34d621e..c8de305 100644 --- a/DurableMultiAgentTemplate/Agent/Synthesizer/SynthesizerWithAdditionalInfoPrompt.cs +++ b/DurableMultiAgentTemplate/Agent/Synthesizer/SynthesizerWithAdditionalInfoPrompt.cs @@ -1,5 +1,9 @@ namespace DurableMultiAgentTemplate.Agent.Synthesizer; +/// +/// 補足情報付きの回答を生成するためのプロンプトを定義する静的クラス。 +/// システムプロンプトには、回答の生成方法や補足情報の分離に関する指示が含まれています。 +/// internal static class SynthesizerWithAdditionalInfoPrompt { // Orchestrator Agent functions From e850fa0aaea0ecf49900d5a611684cbe244938be Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Tue, 20 May 2025 03:27:19 +0000 Subject: [PATCH 4/7] Add documentation comments to Starter.cs Co-authored-by: 07JP27 <11060273+07JP27@users.noreply.github.com> --- DurableMultiAgentTemplate/Starter.cs | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/DurableMultiAgentTemplate/Starter.cs b/DurableMultiAgentTemplate/Starter.cs index dedd683..14d68b6 100644 --- a/DurableMultiAgentTemplate/Starter.cs +++ b/DurableMultiAgentTemplate/Starter.cs @@ -8,6 +8,10 @@ namespace DurableMultiAgentTemplate; +/// +/// エージェントオーケストレーションを開始するスターター機能を提供するクラス。 +/// 同期および非同期のHTTPトリガーを提供し、エージェントのオーケストレーションを開始します。 +/// public class Starter(ILogger logger) { private static readonly JsonSerializerOptions _jsonSerializerOptions = new() @@ -15,6 +19,12 @@ public class Starter(ILogger logger) PropertyNameCaseInsensitive = true }; + /// + /// 同期的にエージェントオーケストレーションを実行し、完了を待機するHTTPトリガー関数。 + /// + /// HTTPリクエストデータ + /// Durableタスククライアント + /// エージェントの処理結果を含むHTTPレスポンス [Function("SyncStarter")] public async Task SyncStarter( [HttpTrigger(AuthorizationLevel.Function, "post", Route = "invoke/sync")] HttpRequestData req, @@ -41,6 +51,12 @@ public async Task SyncStarter( return res; } + /// + /// 非同期的にエージェントオーケストレーションを開始するHTTPトリガー関数。 + /// + /// HTTPリクエストデータ + /// Durableタスククライアント + /// オーケストレーションの状態確認用URLを含むHTTPレスポンス [Function("AsyncStarter")] public async Task AsyncStarter( [HttpTrigger(AuthorizationLevel.Function, "post", Route = "invoke/async")] HttpRequestData req, @@ -63,6 +79,11 @@ public async Task AsyncStarter( return await client.CreateCheckStatusResponseAsync(req, instanceId); } + /// + /// HTTPリクエストからエージェントリクエストデータを取得する補助メソッド。 + /// + /// HTTPリクエストデータ + /// エージェントリクエストデータ、またはリクエストが無効な場合はnull private async Task GetRequestData(HttpRequestData req) { var requestBody = await req.ReadAsStringAsync(); From 64d22e2dcaddffccbebbcc57d263a096508fb081 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Tue, 20 May 2025 03:41:04 +0000 Subject: [PATCH 5/7] Change documentation comments from Japanese to English Co-authored-by: runceel <79868+runceel@users.noreply.github.com> --- .../Model/AdditionalLinkInfo.cs | 8 +++--- .../Model/AdditionalMarkdownInfo.cs | 6 ++--- .../Model/IAdditionalInfo.cs | 4 +-- .../Agent/AgentActivityName.cs | 4 +-- .../Agent/AgentDefinition.cs | 4 +-- .../SynthesizerWithAdditionalInfoPrompt.cs | 4 +-- DurableMultiAgentTemplate/Starter.cs | 26 +++++++++---------- 7 files changed, 28 insertions(+), 28 deletions(-) diff --git a/DurableMultiAgentTemplate.Shared/Model/AdditionalLinkInfo.cs b/DurableMultiAgentTemplate.Shared/Model/AdditionalLinkInfo.cs index 15306c3..904c299 100644 --- a/DurableMultiAgentTemplate.Shared/Model/AdditionalLinkInfo.cs +++ b/DurableMultiAgentTemplate.Shared/Model/AdditionalLinkInfo.cs @@ -3,11 +3,11 @@ namespace DurableMultiAgentTemplate.Shared.Model; /// -/// リンク形式の補足情報を表すレコード。 -/// エージェントの回答に追加情報としてリンクを提供する場合に使用されます。 +/// Record representing additional information in link format. +/// Used when providing links as additional information to agent responses. /// public record AdditionalLinkInfo( - [property: Description("リンクのラベルとして表示されるテキスト")] + [property: Description("Text displayed as the link label")] string LinkText, - [property: Description("リンク先のURL")] + [property: Description("Destination URL of the link")] Uri Uri) : IAdditionalInfo; diff --git a/DurableMultiAgentTemplate.Shared/Model/AdditionalMarkdownInfo.cs b/DurableMultiAgentTemplate.Shared/Model/AdditionalMarkdownInfo.cs index 2ebce15..38ee616 100644 --- a/DurableMultiAgentTemplate.Shared/Model/AdditionalMarkdownInfo.cs +++ b/DurableMultiAgentTemplate.Shared/Model/AdditionalMarkdownInfo.cs @@ -3,9 +3,9 @@ namespace DurableMultiAgentTemplate.Shared.Model; /// -/// Markdown形式の補足情報を表すレコード。 -/// エージェントの回答に追加情報としてMarkdown形式のテキストを提供する場合に使用されます。 +/// Record representing additional information in Markdown format. +/// Used when providing text in Markdown format as additional information to agent responses. /// public record AdditionalMarkdownInfo( - [property: Description("Markdown形式の補足情報")] + [property: Description("Additional information in Markdown format")] string MarkdownText) : IAdditionalInfo; diff --git a/DurableMultiAgentTemplate.Shared/Model/IAdditionalInfo.cs b/DurableMultiAgentTemplate.Shared/Model/IAdditionalInfo.cs index 293f528..af16a4f 100644 --- a/DurableMultiAgentTemplate.Shared/Model/IAdditionalInfo.cs +++ b/DurableMultiAgentTemplate.Shared/Model/IAdditionalInfo.cs @@ -3,8 +3,8 @@ namespace DurableMultiAgentTemplate.Shared.Model; /// -/// 補足情報のインターフェース。 -/// このインターフェースを実装したクラスは、エージェントからの応答に追加される補足情報として使用されます。 +/// Interface for additional information. +/// Classes that implement this interface are used as supplementary information to be added to responses from agents. /// [JsonDerivedType(typeof(AdditionalMarkdownInfo), typeDiscriminator: "markdown")] [JsonDerivedType(typeof(AdditionalLinkInfo), typeDiscriminator: "link")] diff --git a/DurableMultiAgentTemplate/Agent/AgentActivityName.cs b/DurableMultiAgentTemplate/Agent/AgentActivityName.cs index 0824e38..b6b3cea 100644 --- a/DurableMultiAgentTemplate/Agent/AgentActivityName.cs +++ b/DurableMultiAgentTemplate/Agent/AgentActivityName.cs @@ -1,8 +1,8 @@ namespace DurableMultiAgentTemplate.Agent; /// -/// エージェントのアクティビティ名を定義する静的クラス。 -/// オーケストレーターエージェントと各ワーカーエージェントの名前を定数として提供します。 +/// Static class defining agent activity names. +/// Provides constants for orchestrator agent and worker agent names. /// public static class AgentActivityName { diff --git a/DurableMultiAgentTemplate/Agent/AgentDefinition.cs b/DurableMultiAgentTemplate/Agent/AgentDefinition.cs index 039b995..e141305 100644 --- a/DurableMultiAgentTemplate/Agent/AgentDefinition.cs +++ b/DurableMultiAgentTemplate/Agent/AgentDefinition.cs @@ -5,8 +5,8 @@ namespace DurableMultiAgentTemplate.Agent; /// -/// エージェントの定義を提供するクラス。 -/// 各エージェントの機能、説明、パラメータを定義します。 +/// Class providing agent definitions. +/// Defines the functionality, description, and parameters for each agent. /// //https://learn.microsoft.com/ja-jp/azure/ai-services/openai/how-to/dotnet-migration?tabs=stable internal class AgentDefinition diff --git a/DurableMultiAgentTemplate/Agent/Synthesizer/SynthesizerWithAdditionalInfoPrompt.cs b/DurableMultiAgentTemplate/Agent/Synthesizer/SynthesizerWithAdditionalInfoPrompt.cs index c8de305..4cd5835 100644 --- a/DurableMultiAgentTemplate/Agent/Synthesizer/SynthesizerWithAdditionalInfoPrompt.cs +++ b/DurableMultiAgentTemplate/Agent/Synthesizer/SynthesizerWithAdditionalInfoPrompt.cs @@ -1,8 +1,8 @@ namespace DurableMultiAgentTemplate.Agent.Synthesizer; /// -/// 補足情報付きの回答を生成するためのプロンプトを定義する静的クラス。 -/// システムプロンプトには、回答の生成方法や補足情報の分離に関する指示が含まれています。 +/// Static class defining prompts for generating responses with additional information. +/// The system prompt includes instructions on how to generate responses and separate additional information. /// internal static class SynthesizerWithAdditionalInfoPrompt { diff --git a/DurableMultiAgentTemplate/Starter.cs b/DurableMultiAgentTemplate/Starter.cs index 14d68b6..3753346 100644 --- a/DurableMultiAgentTemplate/Starter.cs +++ b/DurableMultiAgentTemplate/Starter.cs @@ -9,8 +9,8 @@ namespace DurableMultiAgentTemplate; /// -/// エージェントオーケストレーションを開始するスターター機能を提供するクラス。 -/// 同期および非同期のHTTPトリガーを提供し、エージェントのオーケストレーションを開始します。 +/// Class providing starter functions for agent orchestration. +/// Offers synchronous and asynchronous HTTP triggers to start agent orchestration. /// public class Starter(ILogger logger) { @@ -20,11 +20,11 @@ public class Starter(ILogger logger) }; /// - /// 同期的にエージェントオーケストレーションを実行し、完了を待機するHTTPトリガー関数。 + /// HTTP trigger function that synchronously executes agent orchestration and waits for completion. /// - /// HTTPリクエストデータ - /// Durableタスククライアント - /// エージェントの処理結果を含むHTTPレスポンス + /// HTTP request data + /// Durable task client + /// HTTP response containing agent processing results [Function("SyncStarter")] public async Task SyncStarter( [HttpTrigger(AuthorizationLevel.Function, "post", Route = "invoke/sync")] HttpRequestData req, @@ -52,11 +52,11 @@ public async Task SyncStarter( } /// - /// 非同期的にエージェントオーケストレーションを開始するHTTPトリガー関数。 + /// HTTP trigger function that asynchronously starts agent orchestration. /// - /// HTTPリクエストデータ - /// Durableタスククライアント - /// オーケストレーションの状態確認用URLを含むHTTPレスポンス + /// HTTP request data + /// Durable task client + /// HTTP response containing URLs for checking orchestration status [Function("AsyncStarter")] public async Task AsyncStarter( [HttpTrigger(AuthorizationLevel.Function, "post", Route = "invoke/async")] HttpRequestData req, @@ -80,10 +80,10 @@ public async Task AsyncStarter( } /// - /// HTTPリクエストからエージェントリクエストデータを取得する補助メソッド。 + /// Helper method to extract agent request data from HTTP request. /// - /// HTTPリクエストデータ - /// エージェントリクエストデータ、またはリクエストが無効な場合はnull + /// HTTP request data + /// Agent request data, or null if request is invalid private async Task GetRequestData(HttpRequestData req) { var requestBody = await req.ReadAsStringAsync(); From ea5612d1d9547d0b3b721ea630594104bb9ad19f Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Tue, 20 May 2025 04:25:32 +0000 Subject: [PATCH 6/7] Revert documentation comments back to Japanese Co-authored-by: runceel <79868+runceel@users.noreply.github.com> --- .../Model/AdditionalLinkInfo.cs | 8 +++--- .../Model/AdditionalMarkdownInfo.cs | 6 ++--- .../Model/IAdditionalInfo.cs | 4 +-- .../Agent/AgentActivityName.cs | 4 +-- .../Agent/AgentDefinition.cs | 4 +-- .../SynthesizerWithAdditionalInfoPrompt.cs | 4 +-- DurableMultiAgentTemplate/Starter.cs | 26 +++++++++---------- 7 files changed, 28 insertions(+), 28 deletions(-) diff --git a/DurableMultiAgentTemplate.Shared/Model/AdditionalLinkInfo.cs b/DurableMultiAgentTemplate.Shared/Model/AdditionalLinkInfo.cs index 904c299..15306c3 100644 --- a/DurableMultiAgentTemplate.Shared/Model/AdditionalLinkInfo.cs +++ b/DurableMultiAgentTemplate.Shared/Model/AdditionalLinkInfo.cs @@ -3,11 +3,11 @@ namespace DurableMultiAgentTemplate.Shared.Model; /// -/// Record representing additional information in link format. -/// Used when providing links as additional information to agent responses. +/// リンク形式の補足情報を表すレコード。 +/// エージェントの回答に追加情報としてリンクを提供する場合に使用されます。 /// public record AdditionalLinkInfo( - [property: Description("Text displayed as the link label")] + [property: Description("リンクのラベルとして表示されるテキスト")] string LinkText, - [property: Description("Destination URL of the link")] + [property: Description("リンク先のURL")] Uri Uri) : IAdditionalInfo; diff --git a/DurableMultiAgentTemplate.Shared/Model/AdditionalMarkdownInfo.cs b/DurableMultiAgentTemplate.Shared/Model/AdditionalMarkdownInfo.cs index 38ee616..2ebce15 100644 --- a/DurableMultiAgentTemplate.Shared/Model/AdditionalMarkdownInfo.cs +++ b/DurableMultiAgentTemplate.Shared/Model/AdditionalMarkdownInfo.cs @@ -3,9 +3,9 @@ namespace DurableMultiAgentTemplate.Shared.Model; /// -/// Record representing additional information in Markdown format. -/// Used when providing text in Markdown format as additional information to agent responses. +/// Markdown形式の補足情報を表すレコード。 +/// エージェントの回答に追加情報としてMarkdown形式のテキストを提供する場合に使用されます。 /// public record AdditionalMarkdownInfo( - [property: Description("Additional information in Markdown format")] + [property: Description("Markdown形式の補足情報")] string MarkdownText) : IAdditionalInfo; diff --git a/DurableMultiAgentTemplate.Shared/Model/IAdditionalInfo.cs b/DurableMultiAgentTemplate.Shared/Model/IAdditionalInfo.cs index af16a4f..293f528 100644 --- a/DurableMultiAgentTemplate.Shared/Model/IAdditionalInfo.cs +++ b/DurableMultiAgentTemplate.Shared/Model/IAdditionalInfo.cs @@ -3,8 +3,8 @@ namespace DurableMultiAgentTemplate.Shared.Model; /// -/// Interface for additional information. -/// Classes that implement this interface are used as supplementary information to be added to responses from agents. +/// 補足情報のインターフェース。 +/// このインターフェースを実装したクラスは、エージェントからの応答に追加される補足情報として使用されます。 /// [JsonDerivedType(typeof(AdditionalMarkdownInfo), typeDiscriminator: "markdown")] [JsonDerivedType(typeof(AdditionalLinkInfo), typeDiscriminator: "link")] diff --git a/DurableMultiAgentTemplate/Agent/AgentActivityName.cs b/DurableMultiAgentTemplate/Agent/AgentActivityName.cs index b6b3cea..0824e38 100644 --- a/DurableMultiAgentTemplate/Agent/AgentActivityName.cs +++ b/DurableMultiAgentTemplate/Agent/AgentActivityName.cs @@ -1,8 +1,8 @@ namespace DurableMultiAgentTemplate.Agent; /// -/// Static class defining agent activity names. -/// Provides constants for orchestrator agent and worker agent names. +/// エージェントのアクティビティ名を定義する静的クラス。 +/// オーケストレーターエージェントと各ワーカーエージェントの名前を定数として提供します。 /// public static class AgentActivityName { diff --git a/DurableMultiAgentTemplate/Agent/AgentDefinition.cs b/DurableMultiAgentTemplate/Agent/AgentDefinition.cs index e141305..039b995 100644 --- a/DurableMultiAgentTemplate/Agent/AgentDefinition.cs +++ b/DurableMultiAgentTemplate/Agent/AgentDefinition.cs @@ -5,8 +5,8 @@ namespace DurableMultiAgentTemplate.Agent; /// -/// Class providing agent definitions. -/// Defines the functionality, description, and parameters for each agent. +/// エージェントの定義を提供するクラス。 +/// 各エージェントの機能、説明、パラメータを定義します。 /// //https://learn.microsoft.com/ja-jp/azure/ai-services/openai/how-to/dotnet-migration?tabs=stable internal class AgentDefinition diff --git a/DurableMultiAgentTemplate/Agent/Synthesizer/SynthesizerWithAdditionalInfoPrompt.cs b/DurableMultiAgentTemplate/Agent/Synthesizer/SynthesizerWithAdditionalInfoPrompt.cs index 4cd5835..c8de305 100644 --- a/DurableMultiAgentTemplate/Agent/Synthesizer/SynthesizerWithAdditionalInfoPrompt.cs +++ b/DurableMultiAgentTemplate/Agent/Synthesizer/SynthesizerWithAdditionalInfoPrompt.cs @@ -1,8 +1,8 @@ namespace DurableMultiAgentTemplate.Agent.Synthesizer; /// -/// Static class defining prompts for generating responses with additional information. -/// The system prompt includes instructions on how to generate responses and separate additional information. +/// 補足情報付きの回答を生成するためのプロンプトを定義する静的クラス。 +/// システムプロンプトには、回答の生成方法や補足情報の分離に関する指示が含まれています。 /// internal static class SynthesizerWithAdditionalInfoPrompt { diff --git a/DurableMultiAgentTemplate/Starter.cs b/DurableMultiAgentTemplate/Starter.cs index 3753346..14d68b6 100644 --- a/DurableMultiAgentTemplate/Starter.cs +++ b/DurableMultiAgentTemplate/Starter.cs @@ -9,8 +9,8 @@ namespace DurableMultiAgentTemplate; /// -/// Class providing starter functions for agent orchestration. -/// Offers synchronous and asynchronous HTTP triggers to start agent orchestration. +/// エージェントオーケストレーションを開始するスターター機能を提供するクラス。 +/// 同期および非同期のHTTPトリガーを提供し、エージェントのオーケストレーションを開始します。 /// public class Starter(ILogger logger) { @@ -20,11 +20,11 @@ public class Starter(ILogger logger) }; /// - /// HTTP trigger function that synchronously executes agent orchestration and waits for completion. + /// 同期的にエージェントオーケストレーションを実行し、完了を待機するHTTPトリガー関数。 /// - /// HTTP request data - /// Durable task client - /// HTTP response containing agent processing results + /// HTTPリクエストデータ + /// Durableタスククライアント + /// エージェントの処理結果を含むHTTPレスポンス [Function("SyncStarter")] public async Task SyncStarter( [HttpTrigger(AuthorizationLevel.Function, "post", Route = "invoke/sync")] HttpRequestData req, @@ -52,11 +52,11 @@ public async Task SyncStarter( } /// - /// HTTP trigger function that asynchronously starts agent orchestration. + /// 非同期的にエージェントオーケストレーションを開始するHTTPトリガー関数。 /// - /// HTTP request data - /// Durable task client - /// HTTP response containing URLs for checking orchestration status + /// HTTPリクエストデータ + /// Durableタスククライアント + /// オーケストレーションの状態確認用URLを含むHTTPレスポンス [Function("AsyncStarter")] public async Task AsyncStarter( [HttpTrigger(AuthorizationLevel.Function, "post", Route = "invoke/async")] HttpRequestData req, @@ -80,10 +80,10 @@ public async Task AsyncStarter( } /// - /// Helper method to extract agent request data from HTTP request. + /// HTTPリクエストからエージェントリクエストデータを取得する補助メソッド。 /// - /// HTTP request data - /// Agent request data, or null if request is invalid + /// HTTPリクエストデータ + /// エージェントリクエストデータ、またはリクエストが無効な場合はnull private async Task GetRequestData(HttpRequestData req) { var requestBody = await req.ReadAsStringAsync(); From 37fd815c2706907662464388716f3371518251d0 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Tue, 20 May 2025 04:37:12 +0000 Subject: [PATCH 7/7] Change documentation comments from Japanese to English Co-authored-by: runceel <79868+runceel@users.noreply.github.com> --- .../Model/AdditionalLinkInfo.cs | 4 +-- .../Model/AdditionalMarkdownInfo.cs | 4 +-- .../Model/IAdditionalInfo.cs | 4 +-- .../Agent/AgentActivityName.cs | 4 +-- .../Agent/AgentDefinition.cs | 4 +-- .../SynthesizerWithAdditionalInfoPrompt.cs | 4 +-- DurableMultiAgentTemplate/Starter.cs | 26 +++++++++---------- 7 files changed, 25 insertions(+), 25 deletions(-) diff --git a/DurableMultiAgentTemplate.Shared/Model/AdditionalLinkInfo.cs b/DurableMultiAgentTemplate.Shared/Model/AdditionalLinkInfo.cs index 15306c3..f6931fe 100644 --- a/DurableMultiAgentTemplate.Shared/Model/AdditionalLinkInfo.cs +++ b/DurableMultiAgentTemplate.Shared/Model/AdditionalLinkInfo.cs @@ -3,8 +3,8 @@ namespace DurableMultiAgentTemplate.Shared.Model; /// -/// リンク形式の補足情報を表すレコード。 -/// エージェントの回答に追加情報としてリンクを提供する場合に使用されます。 +/// Record representing additional information in link format. +/// Used when providing links as additional information in agent responses. /// public record AdditionalLinkInfo( [property: Description("リンクのラベルとして表示されるテキスト")] diff --git a/DurableMultiAgentTemplate.Shared/Model/AdditionalMarkdownInfo.cs b/DurableMultiAgentTemplate.Shared/Model/AdditionalMarkdownInfo.cs index 2ebce15..84602dd 100644 --- a/DurableMultiAgentTemplate.Shared/Model/AdditionalMarkdownInfo.cs +++ b/DurableMultiAgentTemplate.Shared/Model/AdditionalMarkdownInfo.cs @@ -3,8 +3,8 @@ namespace DurableMultiAgentTemplate.Shared.Model; /// -/// Markdown形式の補足情報を表すレコード。 -/// エージェントの回答に追加情報としてMarkdown形式のテキストを提供する場合に使用されます。 +/// Record representing additional information in Markdown format. +/// Used when providing Markdown text as additional information in agent responses. /// public record AdditionalMarkdownInfo( [property: Description("Markdown形式の補足情報")] diff --git a/DurableMultiAgentTemplate.Shared/Model/IAdditionalInfo.cs b/DurableMultiAgentTemplate.Shared/Model/IAdditionalInfo.cs index 293f528..6bee665 100644 --- a/DurableMultiAgentTemplate.Shared/Model/IAdditionalInfo.cs +++ b/DurableMultiAgentTemplate.Shared/Model/IAdditionalInfo.cs @@ -3,8 +3,8 @@ namespace DurableMultiAgentTemplate.Shared.Model; /// -/// 補足情報のインターフェース。 -/// このインターフェースを実装したクラスは、エージェントからの応答に追加される補足情報として使用されます。 +/// Interface for additional information. +/// Classes implementing this interface are used as supplementary information added to agent responses. /// [JsonDerivedType(typeof(AdditionalMarkdownInfo), typeDiscriminator: "markdown")] [JsonDerivedType(typeof(AdditionalLinkInfo), typeDiscriminator: "link")] diff --git a/DurableMultiAgentTemplate/Agent/AgentActivityName.cs b/DurableMultiAgentTemplate/Agent/AgentActivityName.cs index 0824e38..b6b3cea 100644 --- a/DurableMultiAgentTemplate/Agent/AgentActivityName.cs +++ b/DurableMultiAgentTemplate/Agent/AgentActivityName.cs @@ -1,8 +1,8 @@ namespace DurableMultiAgentTemplate.Agent; /// -/// エージェントのアクティビティ名を定義する静的クラス。 -/// オーケストレーターエージェントと各ワーカーエージェントの名前を定数として提供します。 +/// Static class defining agent activity names. +/// Provides constants for orchestrator agent and worker agent names. /// public static class AgentActivityName { diff --git a/DurableMultiAgentTemplate/Agent/AgentDefinition.cs b/DurableMultiAgentTemplate/Agent/AgentDefinition.cs index 039b995..7ba118f 100644 --- a/DurableMultiAgentTemplate/Agent/AgentDefinition.cs +++ b/DurableMultiAgentTemplate/Agent/AgentDefinition.cs @@ -5,8 +5,8 @@ namespace DurableMultiAgentTemplate.Agent; /// -/// エージェントの定義を提供するクラス。 -/// 各エージェントの機能、説明、パラメータを定義します。 +/// Class providing agent definitions. +/// Defines the functionality, descriptions, and parameters for each agent. /// //https://learn.microsoft.com/ja-jp/azure/ai-services/openai/how-to/dotnet-migration?tabs=stable internal class AgentDefinition diff --git a/DurableMultiAgentTemplate/Agent/Synthesizer/SynthesizerWithAdditionalInfoPrompt.cs b/DurableMultiAgentTemplate/Agent/Synthesizer/SynthesizerWithAdditionalInfoPrompt.cs index c8de305..4cd5835 100644 --- a/DurableMultiAgentTemplate/Agent/Synthesizer/SynthesizerWithAdditionalInfoPrompt.cs +++ b/DurableMultiAgentTemplate/Agent/Synthesizer/SynthesizerWithAdditionalInfoPrompt.cs @@ -1,8 +1,8 @@ namespace DurableMultiAgentTemplate.Agent.Synthesizer; /// -/// 補足情報付きの回答を生成するためのプロンプトを定義する静的クラス。 -/// システムプロンプトには、回答の生成方法や補足情報の分離に関する指示が含まれています。 +/// Static class defining prompts for generating responses with additional information. +/// The system prompt includes instructions on how to generate responses and separate additional information. /// internal static class SynthesizerWithAdditionalInfoPrompt { diff --git a/DurableMultiAgentTemplate/Starter.cs b/DurableMultiAgentTemplate/Starter.cs index 14d68b6..f66e00c 100644 --- a/DurableMultiAgentTemplate/Starter.cs +++ b/DurableMultiAgentTemplate/Starter.cs @@ -9,8 +9,8 @@ namespace DurableMultiAgentTemplate; /// -/// エージェントオーケストレーションを開始するスターター機能を提供するクラス。 -/// 同期および非同期のHTTPトリガーを提供し、エージェントのオーケストレーションを開始します。 +/// Class providing starter functions for agent orchestration. +/// Provides synchronous and asynchronous HTTP triggers to start agent orchestration. /// public class Starter(ILogger logger) { @@ -20,11 +20,11 @@ public class Starter(ILogger logger) }; /// - /// 同期的にエージェントオーケストレーションを実行し、完了を待機するHTTPトリガー関数。 + /// Synchronously executes agent orchestration and waits for completion. HTTP trigger function. /// - /// HTTPリクエストデータ - /// Durableタスククライアント - /// エージェントの処理結果を含むHTTPレスポンス + /// HTTP request data + /// Durable task client + /// HTTP response containing agent processing results [Function("SyncStarter")] public async Task SyncStarter( [HttpTrigger(AuthorizationLevel.Function, "post", Route = "invoke/sync")] HttpRequestData req, @@ -52,11 +52,11 @@ public async Task SyncStarter( } /// - /// 非同期的にエージェントオーケストレーションを開始するHTTPトリガー関数。 + /// Asynchronously starts agent orchestration. HTTP trigger function. /// - /// HTTPリクエストデータ - /// Durableタスククライアント - /// オーケストレーションの状態確認用URLを含むHTTPレスポンス + /// HTTP request data + /// Durable task client + /// HTTP response containing URLs for checking orchestration status [Function("AsyncStarter")] public async Task AsyncStarter( [HttpTrigger(AuthorizationLevel.Function, "post", Route = "invoke/async")] HttpRequestData req, @@ -80,10 +80,10 @@ public async Task AsyncStarter( } /// - /// HTTPリクエストからエージェントリクエストデータを取得する補助メソッド。 + /// Helper method to retrieve agent request data from an HTTP request. /// - /// HTTPリクエストデータ - /// エージェントリクエストデータ、またはリクエストが無効な場合はnull + /// HTTP request data + /// Agent request data, or null if the request is invalid private async Task GetRequestData(HttpRequestData req) { var requestBody = await req.ReadAsStringAsync();