Pular para o conteúdo principal

​
Visão Geral

Permita que seus agentes façam upload, download e gerenciem arquivos e pastas no Microsoft OneDrive. Automatize operações de arquivos, organize conteúdo, crie links de compartilhamento e simplifique seus fluxos de trabalho de armazenamento em nuvem com automação alimentada por IA.

​
Pré-requisitos

Antes de usar a integração Microsoft OneDrive, certifique-se de ter:

​
Configurando a Integração Microsoft OneDrive

​
1. Conecte sua Conta Microsoft

  1. Navegue para Integrações CrewAI AMP
  2. Encontre Microsoft OneDrive na seção de Integrações de Autenticação
  3. Clique em Conectar e complete o fluxo OAuth
  4. Conceda as permissões necessárias para acesso a arquivos
  5. Copie seu Token Enterprise das Configurações de Integração

​
2. Instale o Pacote Necessário

uv add crewai-tools

​
Ações Disponíveis

Descrição: Listar arquivos e pastas no OneDrive.Parâmetros:
  • top (integer, opcional): Número de itens a recuperar (máx 1000). Padrão: 50.
  • orderby (string, opcional): Ordenar por campo (ex: “name asc”, “lastModifiedDateTime desc”). Padrão: “name asc”.
  • filter (string, opcional): Expressão de filtro OData.
Descrição: Obter informações sobre um arquivo ou pasta específica.Parâmetros:
  • item_id (string, obrigatório): O ID do arquivo ou pasta.
Descrição: Baixar um arquivo do OneDrive.Parâmetros:
  • item_id (string, obrigatório): O ID do arquivo a baixar.
Descrição: Fazer upload de um arquivo para o OneDrive.Parâmetros:
  • file_name (string, obrigatório): Nome do arquivo a fazer upload.
  • content (string, obrigatório): Conteúdo do arquivo codificado em Base64.
Descrição: Criar uma nova pasta no OneDrive.Parâmetros:
  • folder_name (string, obrigatório): Nome da pasta a criar.
Descrição: Excluir um arquivo ou pasta do OneDrive.Parâmetros:
  • item_id (string, obrigatório): O ID do arquivo ou pasta a excluir.
Descrição: Copiar um arquivo ou pasta no OneDrive.Parâmetros:
  • item_id (string, obrigatório): O ID do arquivo ou pasta a copiar.
  • parent_id (string, opcional): O ID da pasta de destino (opcional, padrão para raiz).
  • new_name (string, opcional): Novo nome para o item copiado (opcional).
Descrição: Mover um arquivo ou pasta no OneDrive.Parâmetros:
  • item_id (string, obrigatório): O ID do arquivo ou pasta a mover.
  • parent_id (string, obrigatório): O ID da pasta de destino.
  • new_name (string, opcional): Novo nome para o item (opcional).
Descrição: Pesquisar arquivos e pastas no OneDrive.Parâmetros:
  • query (string, obrigatório): String de consulta de pesquisa.
  • top (integer, opcional): Número de resultados a retornar (máx 1000). Padrão: 50.
Descrição: Criar um link de compartilhamento para um arquivo ou pasta.Parâmetros:
  • item_id (string, obrigatório): O ID do arquivo ou pasta a compartilhar.
  • type (string, opcional): Tipo de link de compartilhamento. Opções: view, edit, embed. Padrão: view.
  • scope (string, opcional): Escopo do link de compartilhamento. Opções: anonymous, organization. Padrão: anonymous.
Descrição: Obter miniaturas para um arquivo.Parâmetros:
  • item_id (string, obrigatório): O ID do arquivo.

​
Exemplos de Uso

​
Configuração Básica do Agente Microsoft OneDrive

from crewai import Agent, Task, Crew

# Crie um agente com capacidades do Microsoft OneDrive
onedrive_agent = Agent(
    role="Gerenciador de Arquivos",
    goal="Gerenciar arquivos e pastas no OneDrive de forma eficiente",
    backstory="Um assistente IA especializado em operações de arquivos do Microsoft OneDrive e organização.",
    apps=['microsoft_onedrive']  # Todas as ações do OneDrive estarão disponíveis
)

# Tarefa para listar arquivos e criar pasta
organize_files_task = Task(
    description="Listar todos os arquivos no diretório raiz do meu OneDrive e criar uma nova pasta chamada 'Documentos do Projeto'.",
    agent=onedrive_agent,
    expected_output="Lista de arquivos exibida e nova pasta 'Documentos do Projeto' criada."
)

# Execute a tarefa
crew = Crew(
    agents=[onedrive_agent],
    tasks=[organize_files_task]
)

crew.kickoff()

​
Solução de Problemas

​
Problemas Comuns

Erros de Autenticação
  • Certifique-se de que sua conta Microsoft tenha as permissões necessárias para acesso a arquivos (ex: Files.Read, Files.ReadWrite).
  • Verifique se a conexão OAuth inclui todos os escopos necessários.
Problemas de Upload de Arquivos
  • Certifique-se de que file_name e content sejam fornecidos para uploads de arquivos.
  • O conteúdo deve ser codificado em Base64 para arquivos binários.
  • Verifique se você tem permissões de escrita no OneDrive.

​
Obtendo Ajuda

Precisa de Ajuda?

Entre em contato com nossa equipe de suporte para assistência com configuração ou solução de problemas da integração Microsoft OneDrive.
⌘I