Arquivos · Documentação da Ephemeral

Arquivos são documentos que o agente pode ler durante uma execução, como instruções, dados de referência ou exemplos. Você os envia uma vez para a sua organização e escolhe, para cada execução ou fluxo de trabalho, quais montar e onde.

Enviando arquivos

Envie arquivos no painel, em Arquivos, com POST /v1/files ou com ephemeral files upload. Cada arquivo recebe um ID, como file_9c41…, e um nome. O nome é um caminho relativo, como guides/refunds.md, com até 240 caracteres.

Enviar de novo com um nome que já existe adiciona um novo arquivo com um novo ID. A lista de arquivos mostra o envio mais recente de cada nome. Os envios anteriores continuam disponíveis pelo ID até você excluí-los.

Dando arquivos a uma execução

Liste os arquivos no array files da execução. Cada entrada monta um arquivo em um path à sua escolha. Há três maneiras de indicar o conteúdo:

Entrada	Monta
`{"file": "file_9c41…", "path": "refunds.md"}`	Exatamente esse envio.
`{"file": "guides/refunds.md"}`	O envio mais recente com esse nome, no momento em que a execução é criada.
`{"path": "notes.md", "content": "…"}`	Texto em linha enviado com a requisição. Nada é enviado como upload.

Para arquivos enviados, path assume por padrão o nome do arquivo. Arquivos em linha precisam defini-lo. Os caminhos devem ser relativos e únicos dentro da execução.

Arquivos em uma requisição de execução

"files": [
  { "file": "guides/refunds.md", "path": "instructions/refunds.md" },
  { "file": "file_9c41d2a07be35f1e8a6c0d4b9e2f7a13" },
  { "path": "context.md", "content": "The customer is on the annual plan." }
]

Dentro da microVM

O worker recebe os arquivos como um diretório somente leitura e é informado do caminho de cada um. Ele não pode alterá-los. Seu diretório de trabalho é uma área temporária separada. Tudo o que ele grava ali desaparece quando a microVM é destruída, então os arquivos nunca são compartilhados entre execuções. O resultado da execução é a sua saída de texto.

Uma execução lê o conteúdo dos arquivos quando sai da fila. Se você excluir um arquivo enquanto uma execução que o usa ainda está na fila, essa execução falha.

Limites

Limite	Valor
Tamanho do arquivo	1 MiB por arquivo, enviado ou em linha
Arquivos por execução	32
Total por execução	4 MiB

Qualquer membro da organização pode enviar, renomear e excluir arquivos. A definição de uma execução guarda o conteúdo dos arquivos em linha, então coloque segredos em uma conexão em vez de em um arquivo.

Veja a API de arquivos para enviar, baixar, renomear e excluir.