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.
[Este artigo é uma documentação de pré-lançamento e está sujeito a alterações.]
Um agente pode criar arquivos durante uma conversa – por exemplo, um relatório, uma planilha, uma imagem ou um trecho de código – como resultado do trabalho solicitado pelo usuário. O agente mostra cada um desses arquivos de volta ao usuário para que ele possa revisá-los ou baixá-los.
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.
Quando um agente cria um arquivo
Um agente cria um arquivo quando a solicitação do usuário naturalmente produz um. Os padrões comuns incluem:
- Gerar um documento, baralho ou planilha com base na conversa.
- Produzir um gráfico, diagrama ou imagem a partir dos dados fornecidos pelo usuário.
- Emitindo um arquivo de código, script ou extrato de dados que o usuário solicitou.
- Editar um arquivo que o usuário anexou e retornar uma versão atualizada.
Você não configura esse comportamento explicitamente. Quando o agente precisa escrever um arquivo para completar uma turnada, ele produz um e o inclui na resposta.
Como os usuários veem os arquivos criados
Ao final do turno que produz um arquivo, a resposta do agente inclui um cartão de arquivo criado abaixo do texto da mensagem. O cartão mostra:
- O nome do arquivo e o tipo de arquivo.
- Uma prévia ou ícone apropriado ao tipo de arquivo.
- Uma ação de download .
Cartões de arquivo criados aparecem em todas as superfícies onde o agente roda:
- A aba Prévia no Copilot Studio, quando você testa o agente. Saiba mais em Teste um agente.
- Canais publicados como Microsoft Teams, Microsoft 365 Copilot e chat na web. Cada canal exibe o cartão usando sua experiência nativa de anexo ou de arquivo.
Os usuários podem referenciar um arquivo criado em um turno subsequente (por exemplo, "tornar o gráfico mais alto" ou "traduzir para o francês"). O agente pode reler o arquivo e produzir uma versão atualizada.
Retenção e limites
Arquivos criados são armazenados junto com a conversa pelo mesmo período que os arquivos anexados pelo usuário, para que tanto o usuário quanto o agente possam consultá-los entre turnos.
| Item | Limit |
|---|---|
| Tamanho por arquivo criado | 10 MB |
| Retenção (por conversa) | 28 dias após a última atividade na conversa |
| Comportamento quando o limite de tamanho é ultrapassado | O arquivo não aparece na resposta. A turnada continua, e o agente normalmente explica por que o arquivo não foi apresentado. |
Se o trabalho do agente gerar um arquivo superior a 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 arquivo individual permaneça abaixo do limite.
Após a janela de retenção, os arquivos criados são excluídos da conversa.