Pular para o conteúdo principal

S3ReaderTool

Descrição

O S3ReaderTool foi projetado para ler arquivos de buckets Amazon S3. Esta ferramenta permite que os agentes CrewAI acessem e recuperem conteúdos armazenados no S3, tornando-a ideal para fluxos de trabalho que exigem leitura de dados, arquivos de configuração ou qualquer outro conteúdo armazenado no AWS S3.

Instalação

Para utilizar esta ferramenta, é necessário instalar as dependências requeridas:

Passos para Começar

Para usar o S3ReaderTool efetivamente, siga estes passos:
  1. Instale as Dependências: Instale os pacotes necessários usando o comando acima.
  2. Configure as Credenciais AWS: Defina suas credenciais AWS como variáveis de ambiente.
  3. Inicialize a Ferramenta: Crie uma instância da ferramenta.
  4. Especifique o Caminho S3: Forneça o caminho S3 do arquivo que deseja ler.

Exemplo

O exemplo a seguir demonstra como utilizar o S3ReaderTool para ler um arquivo de um bucket S3:
Code

Parâmetros

O S3ReaderTool aceita o seguinte parâmetro quando utilizado por um agente:
  • file_path: Obrigatório. O caminho do arquivo S3 no formato s3://nome-do-bucket/nome-do-arquivo.

Credenciais AWS

A ferramenta requer credenciais AWS para acessar buckets S3. Você pode configurar essas credenciais usando variáveis de ambiente:
  • CREW_AWS_REGION: Região AWS onde seu bucket S3 está localizado. O padrão é us-east-1.
  • CREW_AWS_ACCESS_KEY_ID: Sua AWS access key ID.
  • CREW_AWS_SEC_ACCESS_KEY: Sua AWS secret access key.

Uso

Ao utilizar o S3ReaderTool com um agente, o agente deverá fornecer o caminho do arquivo S3:
Code

Tratamento de Erros

O S3ReaderTool inclui tratamento para erros comuns do S3:
  • Formato inválido de caminho S3
  • Arquivos ausentes ou inacessíveis
  • Problemas de permissão
  • Problemas com credenciais AWS
Quando um erro ocorre, a ferramenta retorna uma mensagem de erro com detalhes sobre o problema.

Detalhes da Implementação

O S3ReaderTool utiliza o AWS SDK for Python (boto3) para interagir com o S3:
Code

Conclusão

O S3ReaderTool oferece uma maneira simples de ler arquivos de buckets Amazon S3. Ao permitir que agentes acessem conteúdos armazenados no S3, facilita fluxos de trabalho que necessitam de acesso a arquivos na nuvem. Esta ferramenta é especialmente útil para processamento de dados, gestão de configurações e qualquer tarefa que envolva a obtenção de informações do armazenamento AWS S3.