Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Os usuários podem anexar arquivos a uma mensagem para que o agente possa ler, resumir ou de outra forma raciocinar sobre eles para essa vez. Anexos são uma entrada fornecida pelo usuário a cada turno, não uma fonte de dados persistente configurada pelo criador.
Note
Os recursos deste artigo são usados por agentes ou fluxos de trabalho alimentados pelo GitHub Copilot.
A cobrança por uso se aplica ao uso, criação, teste e avaliação de agentes. Essas ações podem consumir Créditos do Copilot. Saiba mais em Gerenciar os custos de agentes viabilizados pelo GitHub Copilot harness.
Apegos vs. fontes de conhecimento
Apegos e fontes de conhecimento são conceitos diferentes. Escolha o que combina com o seu cenário.
| Conceito | Quem fornece | Scope | Uso típico |
|---|---|---|---|
| Anexo | O usuário final, por mensagem | Uma conversa | "Resuma este contrato", "O que tem nessa captura de tela?" |
| Fonte de conhecimento | O criador, na época do design | Toda conversa com o agente | Documentos de políticas, catálogos de produtos, artigos de ajuda |
Adicione uma fonte de conhecimento quando o agente sempre deve ter acesso ao mesmo conteúdo. Peça aos usuários que anexem um arquivo quando o conteúdo for único para o pedido deles.
Tipos de anexo com suporte
| Tipo | Examples | Notes |
|---|---|---|
| Excel | .xls, .xlsx | Texto e tabelas são extraídos para que o agente possa raciocinar. |
| Images | .png, .jpg, .gif, .webp | O agente utiliza modelos com capacidade de visão para descrever ou responder perguntas sobre a imagem. |
| arquivos PDF | O texto é extraído para que o agente possa raciocinar. | |
| PowerPoint | .ppt, .pptx | Texto e imagens são extraídos para que o agente possa argumentar. |
| Documentos de texto | .txt, .csv, .html, .md | O conteúdo é passado ao agente como texto. |
| URLs | Qualquer URL HTTP ou HTTPS publicamente acessível | O agente baixa o arquivo vinculado para o turno atual (veja o comportamento de download da URL mais adiante neste artigo). |
| Palavra | .doc, .docx | O texto é extraído para que o agente possa raciocinar. |
Note
Arquivos anexados pelo usuário suportam rótulos Microsoft Purview.
Onde os usuários anexam arquivos
Os usuários podem anexar arquivos em qualquer superfície onde o agente roda:
- A aba Prévia no Copilot Studio, quando você testa o agente. Saiba mais em Teste um agente.
- Qualquer canal publicado que suporte anexos, como Microsoft Teams, Microsoft Copilot e chat na web.
O usuário seleciona o ícone de anexo no compositor de mensagens, escolhe um ou mais arquivos, adiciona uma mensagem opcional e envia o turno. O agente recebe os anexos junto com a mensagem.
Como o agente processa anexos
- O agente lê cada anexo quando processa a mensagem. Os anexos influenciam apenas o turno em que são enviados, a menos que o agente faça referência a eles novamente mais tarde na mesma conversa.
- Se um anexo não puder ser processado (por exemplo, um arquivo inválido ou um URL falhado), o agente pula esse anexo e processa o restante da mensagem. A mensagem ainda é enviada.
- Anexos não substituem fontes de conhecimento, memória ou saídas de ferramentas . Eles são mais um sinal que o agente considera para o turno atual.
Anexos de URL
Quando um usuário anexa uma URL, o agente faz o download do arquivo no URL fornecido e o trata como um anexo carregado para a interação.
- O download deve ser concluído em até 30 segundos. Respostas mais lentas expiram e a URL é pulada nesse turno.
- A URL deve ser acessível publicamente pelo serviço da Microsoft. Links que exigem login ou que ficam atrás de um firewall não funcionam.
- A mensagem continua sendo enviada mesmo que o download da URL falhe.
Retenção e limites
Os anexos são armazenados durante toda a vida da conversa, não apenas na vez atual. Se um usuário anexou um arquivo anteriormente na conversa, o agente pode consultá-lo novamente em uma turnada posterior (por exemplo, "compare isso com o arquivo que enviei antes").
| Item | Limit |
|---|---|
| Tamanho do anexo (por arquivo) | 16 MiB |
| Tempo limite para download do anexo de URL | 30 segundos |
| Retenção de apego (por conversa) | 28 dias após a última atividade na conversa |
| Comportamento de apego em caso de falha | O agente pula o anexo falhado e continua processando a mensagem |
Após o término da janela de retenção, os anexos armazenados são excluídos da conversa e não estão mais disponíveis para o agente consultar. Essa mesma janela de retenção se aplica a quaisquer arquivos criados pelo agente durante a conversa.