GenAI.BuildingBlocks 1.0.11

Documenta��o do Projeto

Este documento fornece uma vis�o geral de como trabalhar com classes e opera��es espec�ficas, incluindo a cria��o de queries Mongo com linguagem natural e a intera��o com o Microsoft Teams.

1. Cria��o de Classe que Representa uma Cole��o

A classe a seguir representa uma cole��o, com atributos utilizados como prompts para gera��o de queries Mongo com linguagem natural. Utilize o atributo "RuleConditionPrompt" tanto no n�vel de classe como nas propriedades para criar seu pr�prio prompt:

[RuleConditionPrompt(Rule = "Regra 100", Condition = @"Lembre-se: voc� deve retornar todos os campos relacionados na cole��o cadastro_usuarios.")]
[RuleConditionPrompt(Rule = "Regra 101", Condition = @"Lembre-se da regra 100.")]
[Display(Name = "Cadastro de Usu�rios")]
[BsonCollection("cadastro_usuarios_teste_hml")]
public class User : BaseModel
{
    [Display(Name = "ID")]
    [JsonProperty(PropertyName = "_id")]
    [BsonRepresentation(BsonType.String)]
    public ObjectId Id { get; set; }

    [Display(Name = "E-Mail")]
    [JsonProperty(PropertyName = "Mail")]
    public string Mail { get; set; }
}

2. Exemplo de gera��o de query com linguagem natural baseando-se na classe User

Para gerar uma query com linguagem natural baseando-se na classe User, siga os passos abaixo:

var _mongoQueryBuilder = InternalConfigurationDI.GetService<IMongoQueryBuilder>();
var messageUser = "Liste todos os usu�rios";

var messagesHistory = new List<Message>();
messagesHistory.Add(messageUser);

ParametersOpenAI PoAI = new ParametersOpenAI(true); // true para OpenAI da Azure, false para outro servi�o da OpenAI
PoAI.MessageUser = messageUser;
PoAI.ApiVersion = "sua api version";
PoAI.ApiKey = "sua api key";
PoAI.Endpoint = "endpoint da sua OpenAI";
PoAI.DeploymentName = "Seu DeploymentName";
PoAI.Messages = new List<Message>();
PoAI.Messages.AddRange(messagesHistory);

var queryMongoIA = await _mongoQueryBuilder.GetQueryFromIA<User>(PoAI);
var queryFormated = queryMongoIA?.Replace("", "").Replace('', ' ');
var response = await _mongoCommand.GetRunCommandAsyncToTable(queryFormated);

3. Exemplo de utiliza��o do BaseMongoRepository para opera��es de reposit�rio

O uso do BaseMongoRepository permite que voc� trabalhe com Linq para realizar opera��es de reposit�rio:

public class UserRepository : BaseMongoDBRepository<User>
{
    public UserRepository(string connectionString, string databaseName) : base(connectionString, databaseName)
    {
    }
}

4. Envio de mensagens ao Teams

Para enviar mensagens ao Microsoft Teams, obtenha primeiro o MicrosoftAppId, MicrosoftAppPassword e ConversationId do seu aplicativo. Em seguida, obtenha a inst�ncia do TeamsUtilities:

_teamsUtilities = InternalConfigurationDI.GetService<TeamsUtilities>(microsoftAppId, microsoftAppPassword, conversationId);
var result = await _teamsUtilities.SendMessageToTeams("sua mensagem");

5. Itera��o direta com a OpenAI

Voc� pode estabelecer uma conversa��o natural com a OpenAI, siga o exemplo abaixo:

var messageUser = "quem descobriu o Brasil?";

var messagesHistory = new List<Message>();
messagesHistory.Add(messageUser);

ParametersOpenAI PoAI = new ParametersOpenAI(true); // true para OpenAI da Azure, false para outro servi�o da OpenAI
PoAI.MessageUser = messageUser;
PoAI.ApiVersion = "sua api version";
PoAI.ApiKey = "sua api key";
PoAI.Endpoint = "endpoint da sua OpenAI";
PoAI.DeploymentName = "Seu DeploymentName";
PoAI.Messages = new List<Message>();
PoAI.Messages.AddRange(messagesHistory);

var OpenAISDK = InternalConfigurationDI.GetService<IOpenaiSdkService>();
var completion = await OpenAISDK.GetGenAICompletionAsync(PoAI);
var response = completion.Value.Choices[0].Message.Content;