graph TD %%{init: {'theme': 'mc','layout': 'elk'}}%% OpenAIModel-1kevp[<div><img src="/_astro/openAI.BhmuxEs3.svg" style="height: 20px !important;width: 20px !important"/></div>OpenAI] style OpenAIModel-1kevp stroke:#a170ff ChatOutput-e303u[<div><img src="/_astro/messages-square.BaSDmT6g.svg" style="height: 20px !important;width: 20px !important"/></div>Chat Output] style ChatOutput-e303u stroke:#a170ff ChatInput-wkxmm[<div><img src="/_astro/messages-square.BaSDmT6g.svg" style="height: 20px !important;width: 20px !important"/></div>Chat Input] style ChatInput-wkxmm stroke:#a170ff LanggraphReactAgent-fy1on[Agent] style LanggraphReactAgent-fy1on stroke:#a170ff SalesForceTool-b81do[Salesforce Tool] style SalesForceTool-b81do stroke:#a170ff ChatInput-wkxmm -.- LanggraphReactAgent-fy1on linkStyle 0 stroke:#a170ff OpenAIModel-1kevp -.- LanggraphReactAgent-fy1on linkStyle 1 stroke:#a170ff LanggraphReactAgent-fy1on -.- ChatOutput-e303u linkStyle 2 stroke:#a170ff SalesForceTool-b81do -.- LanggraphReactAgent-fy1on linkStyle 3 stroke:#a170ff

Agente Salesforce – Documentação

🧩 Visão Geral

O Agente Salesforce integra um modelo de linguagem OpenAI em um Langgraph React Agent e o complementa com uma ferramenta de consultas ao Salesforce.
Ele recebe mensagens do usuário via interface de chat, processa essas mensagens com o LLM e dados opcionais do Salesforce, e retorna respostas em linguagem natural.
O fluxo de trabalho otimiza conversas de negócios, consultando automaticamente o Salesforce e gerando respostas contextuais.

⚙️ Funcionalidades Principais

Conecta de forma fluida a interface de chat a um modelo de linguagem OpenAI via Langgraph React Agent.
Permite que o agente execute consultas ao Salesforce durante a conversa.
Fornece saída de chat em tempo real com informações de remetente e sessão.
Suporta configuração de temperatura, limite de tokens e prompts de sistema para o LLM.
Permite fallback de modelo e streaming de respostas (atualmente desativados).

🔄 Etapas do Fluxo

Nome do Componente	Papel no Fluxo	Entradas Principais	Saídas Principais
Chat Input	Captura a mensagem do usuário e quaisquer arquivos anexos.	Texto do usuário, Tipo de remetente, ID da sessão, ID da conversa	Objeto de mensagem contendo a entrada do usuário
Salesforce Tool	Executa uma consulta ao Salesforce fornecida pelo agente.	String de consulta	Objeto de dados com resultados da consulta
OpenAI Model	Gera texto usando o modelo OpenAI LLM.	Texto do prompt, Mensagem de sistema, Max Tokens, Temperatura, Nome do modelo	Texto gerado (Mensagem)
Langgraph React Agent	Orquestra a conversa, integra o LLM e ferramentas, e produz a resposta.	Mensagem de entrada inicial, LLM (OpenAI), Lista de ferramentas (Salesforce Tool), Prompt de sistema	Mensagem de resposta
Chat Output	Renderiza a resposta do agente na interface de chat.	Texto da resposta, Info do remetente, ID da sessão, ID da conversa	Mensagem de chat exibida

🧠 Observações

É necessária uma chave de API OpenAI e credenciais válidas do Salesforce para que o fluxo funcione.
O agente utiliza o modelo gpt-4o-mini por padrão; isso pode ser alterado pelo seletor de modelos.
A Salesforce Tool deve ser configurada com usuário, senha, token de segurança e domínio do Salesforce antes do uso.
Respostas em streaming estão desativadas por padrão; habilite use_stream para receber saída incremental.
Suporte a fallback de modelo está disponível, mas atualmente desativado; habilite enable_fallback para fornecer um LLM secundário.
O fluxo armazena o histórico de chat se should_store_message estiver ativo, permitindo que o contexto seja mantido entre interações.
O framework Langgraph React Agent gerencia memória e limites de execução; max_execution_time e max_iterations podem ser ajustados para interações mais longas.