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.]
Um agente pode criar ficheiros durante uma conversa – por exemplo, um relatório, uma folha de cálculo, uma imagem ou um excerto de código – como resultado do trabalho solicitado pelo utilizador. O agente mostra cada um destes ficheiros de volta ao utilizador para que possa rever ou descarregar.
Note
As funcionalidades deste artigo são utilizadas por agentes ou fluxos de trabalho suportados pela estrutura do 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. Saiba mais em Gerir custos para agentes alimentados pelo harness GitHub Copilot.
Quando um agente cria um ficheiro
Um agente cria um ficheiro quando o pedido do utilizador produz naturalmente um. Os padrões comuns incluem:
- Gerar um documento, deck ou folha de cálculo com base na conversa.
- Produzir um gráfico, diagrama ou imagem a partir dos dados fornecidos pelo utilizador.
- Emitindo um ficheiro de código, script ou extração de dados que o utilizador pediu.
- Editar um ficheiro que o utilizador anexou e devolver uma versão atualizada.
Não se configura este comportamento explicitamente. Quando o agente precisa de escrever um ficheiro para concluir uma interação, gera-o e inclui-o na sua resposta.
Como os utilizadores veem os ficheiros criados
No final da interação em que é produzido um ficheiro, a resposta do agente inclui um cartão de ficheiro criado por baixo do texto da mensagem. O cartão mostra:
- O nome e o tipo de ficheiro.
- Uma pré-visualização ou ícone apropriado ao tipo de ficheiro.
- Uma ação de Descarregar .
Os cartões de ficheiro criados aparecem em todas as superfícies onde o agente é executado:
- O separador Pré-visualização no Copilot Studio, quando testas o agente. Saiba mais em Teste um agente.
- Canais publicados como Microsoft Teams, Microsoft 365 Copilot e chat web. Cada canal renderiza o cartão usando o seu anexo nativo ou experiência de ficheiro.
Os utilizadores podem fazer referência a um ficheiro criado numa interação seguinte (por exemplo, "aumentar a altura do gráfico" ou "traduzir isto para francês"). O agente pode ler o ficheiro e produzir uma versão atualizada.
Retenção e limites
Os ficheiros criados são armazenados com a conversa durante o mesmo período que os ficheiros anexados pelo utilizador, para que tanto o utilizador como o agente possam consultá-los entre turnos.
| Item | Limit |
|---|---|
| Tamanho por ficheiro criado | 10 MB |
| Retenção (por conversa) | 28 dias após a última atividade na conversa |
| Comportamento quando o limite de tamanho é ultrapassado | O ficheiro não aparece na resposta. O turno continua, e o agente normalmente explica porque é que o processo não foi apresentado. |
Se o trabalho do agente produzir um ficheiro com mais de 10 MB, peça ao agente para dividir o resultado — por exemplo, uma entrega por capítulo de um relatório longo — para que cada ficheiro individual fique abaixo do limite.
Após a janela de retenção, os ficheiros criados são eliminados da conversa.