Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
[Este artigo é uma documentação de pré-lançamento e está sujeito a alterações.]
Os utilizadores podem anexar ficheiros a uma mensagem para que o agente possa ler, resumir ou de outra forma raciocinar sobre eles nesse turno. Os anexos são uma entrada por turno do utilizador, não uma fonte de dados persistente configurada pelo maker.
Note
As funcionalidades deste artigo são alimentadas pelo chicote GitHub Copilot, que utiliza Créditos Copilot para faturação baseada na utilização. Saiba mais sobre os Créditos Copilot na Visão Geral da faturação para agentes alimentados pelo arnês GitHub Copilot.
A faturação baseada no uso aplica-se à utilização, construção, teste e avaliação de agentes. Estas ações podem consumir Créditos Copilot.
Apegos vs. fontes de conhecimento
Anexos e fontes de conhecimento são conceitos diferentes. Escolhe aquele que se adequa ao teu cenário.
| Conceito | Quem o fornece | Scope | Uso típico |
|---|---|---|---|
| Anexo | O utilizador final, por mensagem | Uma conversa | "Faz um resumo deste contrato", "O que aparece nesta captura de ecrã?" |
| Fonte de conhecimento | O criador, no momento da conceção | Todas as conversas com o agente | Documentos de políticas, catálogos de produtos, artigos de ajuda |
Adicione uma fonte de conhecimento quando o agente deve sempre ter acesso ao mesmo conteúdo. Peça aos utilizadores que anexem um ficheiro quando o conteúdo for único para o seu pedido.
Tipos de anexos suportados
| Tipo | Examples | Notes |
|---|---|---|
| Images | .png, .jpg, .gif, .webp | O agente utiliza modelos com capacidade de visão para descrever ou responder a perguntas sobre a imagem. |
| Ficheiros PDF | O texto é extraído para permitir que o agente raciocine sobre ele. | |
| Documentos de texto | .txt, .csv, .html, .md | O conteúdo é transmitido ao agente como texto. |
| URLs | Qualquer URL HTTP ou HTTPS publicamente acessível | O agente descarrega o ficheiro ligado para o turno atual (ver o comportamento de download de URL mais adiante neste artigo). |
Onde os utilizadores anexam ficheiros
Os utilizadores podem anexar ficheiros em qualquer superfície onde o agente seja executado:
- O separador Pré-visualização no Copilot Studio, quando testas o agente. Saiba mais em Teste um agente.
- Qualquer canal publicado que suporte anexos, como Microsoft Teams, Microsoft 365 Copilot e chat web.
O utilizador seleciona o ícone de anexo no compositor de mensagens, escolhe um ou mais ficheiros, adiciona uma mensagem opcional e envia o turno. O agente recebe os anexos juntamente com a mensagem.
Como o agente processa anexos
- O agente lê cada anexo quando este processa a mensagem. Os anexos afetam apenas o turno em que são enviados, a menos que o agente volte a referir-se a eles mais tarde na mesma conversa.
- Se um anexo não puder ser processado (por exemplo, um ficheiro inválido ou uma URL falhada), o agente ignora esse anexo e processa o resto da mensagem. A mensagem continua a ser enviada.
- Os anexos não substituem fontes de conhecimento, memória ou saídas de ferramentas . São mais um sinal que o agente considera para o turno atual.
Anexos de URL
Quando um utilizador anexa uma URL, o agente descarrega o ficheiro nessa URL e trata-o como um anexo carregado para o turno.
- O download deve ser concluído em 30 segundos. Respostas mais lentas expiram e a URL é ignorada nesse turno.
- O URL deve ser acessível publicamente a partir do serviço da Microsoft. Links que exigem login ou que ficam atrás de um firewall não funcionam.
- A mensagem continua a ser enviada mesmo que o download do URL falhe.
Retenção e limites
Os anexos são armazenados durante toda a vida da conversa, não apenas no turno atual. Se um utilizador anexou um ficheiro mais cedo na conversa, o agente pode consultá-lo novamente numa turno posterior (por exemplo, "compare isto com o ficheiro que enviei anteriormente").
| Item | Limit |
|---|---|
| Tamanho do anexo (por ficheiro) | 16 MiB |
| Tempo de descarregamento do anexo 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 ignora o anexo falhado e continua a processar a mensagem |
Após a janela de retenção, os anexos armazenados são eliminados da conversa e deixam de estar disponíveis para o agente consultar. Esta mesma janela de retenção aplica-se a quaisquer ficheiros criados pelo agente durante a conversa.