BotSharp/src/Infrastructure/BotSharp.Core/Instructs/InstructService.cs

using BotSharp.Abstraction.Agents.Enums;
using BotSharp.Abstraction.Agents.Models;
using BotSharp.Abstraction.Instructs;
using BotSharp.Abstraction.Instructs.Models;
using BotSharp.Abstraction.MLTasks;
using BotSharp.Abstraction.Templating;
using System.IO;

namespace BotSharp.Core.Instructs;

public partial class InstructService : IInstructService
{
    private readonly IServiceProvider _services;
    private readonly ILogger _logger;

    public InstructService(IServiceProvider services, ILogger<InstructService> logger)
    {
        _services = services;
        _logger = logger;
    }

    public async Task<InstructResult> ExecuteInstruction(Agent agent, 
        RoleDialogModel message, 
        Func<RoleDialogModel, Task> onMessageReceived,
        Func<RoleDialogModel, Task> onFunctionExecuting,
        Func<RoleDialogModel, Task> onFunctionExecuted)
    {
        var response = new InstructResult();

        var wholeDialogs = new List<RoleDialogModel>
        {
            message
        };

        // Trigger before completion hooks
        var hooks = _services.GetServices<IInstructHook>();
        foreach (var hook in hooks)
        {
            await hook.BeforeCompletion(message);
        }

        await ExecuteInstructionRecursively(agent,
            wholeDialogs,
            async msg =>
            {
                response.Text = msg.Content;
                await onMessageReceived(msg);
            },
            async fn =>
            {
                response.Function = fn.FunctionName;
                await onFunctionExecuting(fn);
            },
            async fn =>
            {
                response.Data = fn.Data;
                await onFunctionExecuted(fn);
            });

        foreach (var hook in hooks)
        {
            await hook.AfterCompletion(response);
        }

        return response;
    }

    private async Task<bool> ExecuteInstructionRecursively(Agent agent,
        List<RoleDialogModel> wholeDialogs,
        Func<RoleDialogModel, Task> onMessageReceived, 
        Func<RoleDialogModel, Task> onFunctionExecuting, 
        Func<RoleDialogModel, Task> onFunctionExecuted)
    {
        var chatCompletion = CompletionProvider.GetChatCompletion(_services);

        var result = await chatCompletion.GetChatCompletionsAsync(agent, wholeDialogs, async msg =>
        {
            await onMessageReceived(msg);

            wholeDialogs.Add(msg);
        }, async fn =>
        {
            var preAgentId = agent.Id;

            await HandleFunctionMessage(fn, onFunctionExecuting, onFunctionExecuted);

            // Function executed has exception
            if (fn.Content == null || fn.StopCompletion)
            {
                await onMessageReceived(new RoleDialogModel(AgentRole.Assistant, fn.Content));
                return;
            }

            fn.Content = fn.FunctionArgs.Replace("\r", " ").Replace("\n", " ").Trim() + " => " + fn.Content;

            // Find response template
            var templateService = _services.GetRequiredService<IResponseTemplateService>();
            var response = await templateService.RenderFunctionResponse(agent.Id, fn);
            if (!string.IsNullOrEmpty(response))
            {
                await onMessageReceived(new RoleDialogModel(AgentRole.Assistant, response));
                return;
            }

            // After function is executed, pass the result to LLM to get a natural response
            wholeDialogs.Add(fn);

            await ExecuteInstructionRecursively(agent,
                wholeDialogs,
                onMessageReceived,
                onFunctionExecuting,
                onFunctionExecuted);
        });

        return result;
    }

    private async Task HandleFunctionMessage(RoleDialogModel msg,
        Func<RoleDialogModel, Task> onFunctionExecuting,
        Func<RoleDialogModel, Task> onFunctionExecuted)
    {
        // Call functions
        await onFunctionExecuting(msg);
        await CallFunctions(msg);
        await onFunctionExecuted(msg);
    }
}