Upload de Arquivos
Financiamento e uso de IA
IA incluída usa créditos REDA. Traga sua própria IA usa a conta de provedor da sua organização, cobrada diretamente pelo provedor. A licença define um modelo para toda a organização. Nos dois, o REDA AI governa ferramentas e ações configuradas no Salesforce. Configure a licença e as contas de IA.
Com conta própria, o modelo escolhido define os níveis de raciocínio profundo e recursos disponíveis. Confira os níveis e avisos no seletor AI Account; não presuma que todos os provedores aceitam a mesma combinação. Ferramentas administrativas e processamento de documentos usam a conexão padrão da organização. Configure o padrão e teste o fluxo.
Esta página cobre o upload de arquivos iniciado pelo usuário — o que acontece quando um usuário anexa um arquivo dentro de um chat. Para a capacidade mais ampla da plataforma que permite aos agentes ingerir arquivos vindos de e-mail, Fluxos, da API ou de canais de mensagens — incluindo o pipeline do processador de arquivos, a entrega de arquivos grandes e os três padrões de integração — consulte Processamento de Documentos.
O que é o Upload de Arquivos?
O Upload de Arquivos permite que os usuários anexem documentos, imagens, planilhas e arquivos de dados às suas conversas. O agente processa o conteúdo do arquivo e pode:
- Responder perguntas sobre o conteúdo do arquivo
- Resumir documentos e extrair informações-chave
- Importar dados de CSV para registros do Salesforce
- Analisar imagens e capturas de tela
- Vincular arquivos enviados a registros do Salesforce
Tipos de arquivo suportados
| Tipo de arquivo | Extensões | O que o agente pode fazer |
|---|---|---|
.pdf |
Ler e resumir documentos, extrair dados, responder perguntas sobre o conteúdo | |
| CSV | .csv |
Ler dados tabulares, responder perguntas, importar linhas como registros do Salesforce |
| Imagens | .png, .jpg, .jpeg |
Analisar imagens, ler texto em capturas de tela, descrever conteúdo visual |
| Texto | .txt |
Ler e analisar conteúdo de texto simples |
| JSON | .json |
Analisar dados estruturados |
A lista de extensões permitidas é configurável em Platform Settings. Consulte Configuração abaixo.
Ativando o Upload de Arquivos
-
Abra a Definição de Agente
Navegue até o registro de Definição de Agente da REDAAI.
-
Marque Allow File Upload
A caixa de seleção Allow File Upload vem ativada por padrão em novos agentes. Verifique se ela está marcada.
-
(Opcional) Defina Supported File Types
Se quiser restringir quais tipos de arquivo esse agente específico aceita, defina o campo Supported File Types (extensões separadas por vírgula). Deixe em branco para usar a lista de permissões global do Platform Settings.
-
(Opcional) Ative o Auto Execute File Actions
Marque Auto Execute File Actions para permitir que o agente execute automaticamente ações sobre arquivos enviados (por exemplo, importar dados de CSV) sem pedir confirmação primeiro.
Como os usuários enviam arquivos
Na interface de chat (canal interno), os usuários clicam no ícone de anexo ao lado do campo de mensagem para selecionar um ou mais arquivos — até 5 por mensagem. Cada anexo aparece como um chip (com o nome do arquivo) que pode ser removido individualmente antes do envio. Os arquivos são enviados ao Salesforce como registros ContentVersion, e então o agente processa seu conteúdo.
Os usuários também podem arrastar e soltar arquivos na área de chat em navegadores compatíveis.
Widget do portal da comunidade. Usuários do portal (Experience Cloud) autenticados enviam arquivos da mesma forma — um botão de clipe de papel na barra de mensagem, até 5 arquivos por mensagem. Cada arquivo anexado aparece como um chip nomeado na mensagem enviada. Os arquivos enviados no portal são automaticamente associados ao registro de Contato do cliente autenticado, para que sua equipe possa localizá-los depois a partir do registro do cliente. O botão de clipe de papel só aparece quando o agente tem Allow File Upload ativado.
- O usuário envia
tenants.csve digita “Importar estes locatários como registros de Contato” - O agente lê o CSV, identifica os cabeçalhos das colunas e os mapeia para os campos de Contato
- O agente cria registros de Contato para cada linha (com confirmação, a menos que a execução automática esteja ativada)
- O agente relata os resultados: quantos registros foram criados com sucesso
Vinculação de arquivos
Quando a ferramenta link_file_to_record é atribuída ao agente, ele pode anexar arquivos enviados a registros do Salesforce. Por exemplo, um usuário pode enviar um PDF de fatura e pedir ao agente para anexá-lo a um registro específico de Conta ou Oportunidade.
No portal da comunidade, um arquivo enviado é vinculado automaticamente ao Contato do cliente. Além disso, o assistente pode anexar o mesmo arquivo a um registro relacionado quando solicitado — por exemplo, a um Caso que ele abre para o cliente. Para um agente de portal, mantenha isso restrito aos próprios registros do cliente (seu Contato, Conta ou Casos) para que os clientes só possam afetar os próprios dados.
Configuração
O comportamento do upload de arquivos é controlado por meio do Platform Settings no painel de administração da REDA AI:
| Configuração | Padrão | Intervalo | Descrição |
|---|---|---|---|
| Max File Size (MB) | 5 | 1 – 25 | Tamanho máximo de arquivo permitido para uploads. Arquivos que excedam esse limite são rejeitados. |
| Allowed File Extensions | pdf,csv,png,jpg,jpeg,txt,json |
— | Lista de extensões de arquivo permitidas, separadas por vírgula. Arquivos com outras extensões são rejeitados. |
| Max CSV Characters | 50.000 | 10.000 – 200.000 | Número máximo de caracteres para o conteúdo do arquivo CSV. CSVs que excedam esse limite retornam um erro. |
| File Processing Credit Multiplier | Configurável | — | Amplia o limite máximo de tokens de saída para solicitações de processamento de arquivos. Valores mais altos permitem análises mais detalhadas com maior custo em créditos. |
Configurações da Definição de Agente
Configurações de upload de arquivos por agente no registro de Definição de Agente:
| Campo | Padrão | Descrição |
|---|---|---|
| Allow File Upload | Ativado | Controle mestre do upload de arquivos para este agente |
| Supported File Types | (em branco — usa a configuração global) | Substitui as extensões permitidas globalmente apenas para este agente |
| Auto Execute File Actions | Desativado | Quando ativado, o agente age sobre os arquivos imediatamente, sem pedir confirmação |
Impacto nos créditos
Os uploads de arquivos aumentam o número de tokens de entrada em uma conversa, pois o conteúdo do arquivo é enviado à IA para processamento. Arquivos maiores usam mais tokens e, portanto, mais créditos.
- Arquivos de texto e CSV — a contagem de tokens é proporcional à contagem de caracteres
- PDF e imagens — processados como conteúdo multimodal, o que usa mais tokens por unidade de conteúdo
- Multiplicador de créditos — a configuração File Processing Credit Multiplier aumenta o orçamento de tokens de saída para respostas relacionadas a arquivos, permitindo análises mais detalhadas
Para arquivos CSV grandes, considere dividi-los em lotes menores antes do envio. A configuração Max CSV Characters evita que arquivos excessivamente grandes consumam muitos créditos em uma única solicitação.
Boas práticas
Defina limites de tamanho adequados — O limite padrão de 5 MB funciona bem para a maioria dos documentos. Aumente-o apenas se os usuários precisarem regularmente enviar arquivos maiores.
Restrinja extensões para agentes externos — Para agentes de External Widget, considere limitar os tipos de arquivo permitidos apenas ao que for necessário (por exemplo, apenas csv e txt).
Use a execução automática com cuidado — O Auto Execute File Actions pula a confirmação para ações baseadas em arquivos, como importações de CSV. Ative isso apenas para agentes internos confiáveis, em que os usuários entendem as consequências.
Atribua a ferramenta link_file_to_record — Se quiser que o agente anexe arquivos enviados a registros, garanta que a ferramenta link_file_to_record esteja atribuída ao agente.
Perguntas frequentes
Sim — os usuários podem anexar até 5 arquivos por mensagem tanto no assistente dentro do Salesforce quanto no widget do portal da comunidade. Cada um aparece como um chip próprio e pode ser removido individualmente antes do envio; o agente recebe e processa todos eles juntos. Para mais de 5, envie arquivos adicionais em uma mensagem de acompanhamento na mesma conversa.
Sim. Quando o agente tem Allow File Upload ativado, um botão de clipe de papel aparece no widget do portal da comunidade. Os arquivos que um cliente envia ali são automaticamente vinculados ao respectivo registro de Contato. O assistente também pode anexar um arquivo enviado a um registro relacionado (como um Caso que ele cria) quando solicitado.
Sim. A ação invocável da REDA AI aceita vários arquivos em uma única chamada, de modo que um Fluxo automatizado pode enviar vários documentos ao assistente de uma só vez.
Os arquivos são armazenados como registros ContentVersion do Salesforce, seguindo o armazenamento padrão de arquivos do Salesforce. Eles contam para os limites de armazenamento de arquivos da sua organização.
Sim. Quando um usuário envia um CSV e pede ao agente para importá-lo, o agente lê os dados, mapeia as colunas para os campos do Salesforce e cria os registros. O agente pede confirmação antes de criar os registros (a menos que o Auto Execute File Actions esteja ativado).
O upload é rejeitado com uma mensagem de erro informando ao usuário o tamanho máximo de arquivo permitido. O arquivo não é processado.
O upload de arquivos depende do canal e da configuração do agente. A opção Allow File Upload na Definição de Agente controla a disponibilidade por agente.
As extensões permitidas são configuráveis em Platform Settings. No entanto, o agente só consegue processar nativamente os tipos de arquivo que suporta (PDF, CSV, PNG, JPG, TXT, JSON). Adicionar extensões não suportadas à lista de permissões permitirá o upload, mas o agente pode não conseguir ler o conteúdo.
Próximos passos
Saiba mais sobre Configuração de Ferramentas para gerenciar quais ferramentas e capacidades são atribuídas aos seus agentes, ou revise Como Funcionam os Créditos para entender o impacto do processamento de arquivos nos créditos.