TPHIAAssistant

O Objeto TPHIAAssistant será responsável pelo processamento de texto, execução de instruções e manipulação de arquivos de entrada para interação com o assistente de inteligência artificial.

Propriedades

Nome	Tipo	Descrição
Texto	String	Texto de entrada informado pelo usuário. Antes do envio à IA, pode ser automaticamente combinado com o conteúdo de um Prompt (caso PromptID seja informado), formando o contexto final enviado para processamento. É validado e não pode estar vazio.
PromptID	Integer	Identificador de um prompt armazenado na base de dados (tabela IA_PROMPTS). Quando informado, o conteúdo do prompt é recuperado e concatenado ao Texto, funcionando como contexto inicial da requisição.
Instrucao	String	Instruções adicionais utilizadas para enriquecer o contexto da IA. Pode ser informada manualmente ou carregada automaticamente a partir dos parâmetros do assistente (IA_PARAMETROS) quando utilizado o método ProcessarTexto.
AssistenteID	Integer	Identificador do assistente de IA. Quando definido, força o carregamento direto das configurações do assistente (modelo, temperatura, API Key, tokens, etc.) a partir da base de dados, sobrescrevendo configurações padrão por empresa.o.
TextoRetorno	String	Resultado retornado pela IA após o processamento. Este valor é preenchido pelo provider de IA após a execução da requisição.
Temperatura	Double	Parâmetro que controla o nível de criatividade da IA. Valores menores tornam as respostas mais determinísticas, enquanto valores maiores aumentam a variação e criatividade das respostas.
MaxTokens	Integer	Define o limite máximo de tokens (tamanho da resposta) que a IA pode gerar durante o processamento.
Modelo	String	Identifica o modelo de IA que será utilizado na execução (ex: GPT-4, GPT-3.5, etc.), sendo carregado a partir das configurações do assistente.

Funções

• Executar: Executa o processamento principal do assistente com base nas propriedades configuradas.
• ProcessarTexto: Realiza o processamento do texto informado na propriedade Texto.
• AdicionarArquivo(const NomeArquivo:String; ArquivoStream:TMemoryStream): Adiciona um arquivo de entrada ao assistente, informando o nome e o conteúdo via Stream.

Funcionalidade

O objeto TPHIAAssistant é responsável por intermediar a comunicação com serviços de inteligência artificial, permitindo o envio de textos, instruções e arquivos para processamento e retorno de respostas. Seu uso é indicado sempre que houver necessidade de interpretar, gerar ou transformar informações utilizando IA.

O comportamento do assistente varia conforme as propriedades e métodos utilizados:

• Quando a propriedade AssistenteID é informada, todas as configurações (modelo, temperatura, tokens, API Key, entre outras) são carregadas diretamente da base de dados, garantindo a utilização de um assistente específico.
• Caso AssistenteID não seja informado, serão utilizadas as configurações padrão definidas nos parâmetros de IA da empresa.
• Ao utilizar o método Executar, o processamento ocorre com base nas propriedades atuais do objeto, sem considerar a instrução padrão definida nos parâmetros de IA.
• Já o método ProcessarTexto aplica automaticamente a instrução configurada nos parâmetros de IA, influenciando o comportamento e o formato da resposta gerada.
• A propriedade Texto pode ser combinada com um Prompt previamente cadastrado (quando PromptID é informado), formando um contexto mais completo para a requisição.
• Também é possível adicionar arquivos como entrada por meio do método AdicionarArquivo, ampliando as possibilidades de interação com a IA.

Dessa forma, o TPHIAAssistant oferece flexibilidade para diferentes cenários de uso, desde chamadas simples até configurações mais avançadas e personalizadas de assistentes de inteligência artificial.