O objeto arquivo

ArquivosO objeto arquivo
Zoen

Seus workflows criam arquivos a partir de lugares muito diferentes: um anexo de e-mail, uma imagem gerada, fala sintetizada, um documento parseado. Dentro do workflow, todos viajam como a mesma coisa: um objeto arquivo.

What you will learn

Payloads diferentes, pacote idêntico

Um PDF, uma imagem e um clipe de áudio chegam de blocos diferentes, cada um entregue exatamente da mesma forma.

Os campos nunca mudam

Todo objeto arquivo carrega um ID, um nome, uma URL onde os bytes vivem, um tamanho, um tipo e o conteúdo — não importa qual bloco o criou.

Produtores são intercambiáveis

Como todo produtor fala o mesmo formato, você pode trocar qual alimenta um agente e o lado do agente nunca muda.

Consumidores se compõem

O mesmo objeto segue para qualquer consumidor — para um agente, para fora como anexo de e-mail ou direto para o armazenamento.

A forma comum

Pegue um arquivo no meio de uma execução e olhe dentro: um ID, um nome, uma URL onde os bytes vivem, um tamanho, um tipo e o conteúdo em si. Existem mais alguns campos por baixo dos panos, mas a forma nunca muda — e é exatamente isso que permite que um anexo do Gmail, uma imagem gerada e um clipe de texto-para-fala alimentem o mesmo agente sem tratamento especial.

O vídeo fecha nesta máquina: um objeto arquivo percorrendo toda a cadeia:

Por que uma única forma importa

Troque qual produtor alimenta o agente e nada no lado do agente muda. Aponte o mesmo objeto para um consumidor diferente — um e-mail, armazenamento na nuvem, outro agente — e ele simplesmente segue. Na máquina final, uma nota fiscal chega no Gmail, é parseada, um agente extrai os campos e o resultado aterrissa no banco: um objeto carregado o caminho inteiro.

Common Questions

Um ID, um nome, uma URL onde os bytes vivem, um tamanho, um tipo MIME e o conteúdo. Alguns campos internos existem por baixo dos panos, mas a forma é a mesma para todo arquivo, independentemente do bloco que o criou.
Produtores e consumidores se compõem sem tratamento especial. Você pode trocar qual bloco alimenta um agente, ou apontar o mesmo arquivo para um destino diferente, e mais nada muda.
Pelo campo Files do bloco Agent, geralmente referenciado com uma tag de conexão como <file.files[0]>. O agente lê o conteúdo do documento diretamente.
Sim. Uma imagem de um gerador, um clipe de áudio de texto-para-fala e um anexo de e-mail todos viajam como o mesmo objeto, então os blocos seguintes os tratam de forma idêntica.

Documentação relacionada