Visão Geral Permita que seus agentes acessem e gerenciem sites, listas e bibliotecas de documentos do SharePoint. Recupere informações do site, gerencie itens de lista, faça upload e organize arquivos, e simplifique seus fluxos de trabalho do SharePoint com automação alimentada por IA.
Pré-requisitos Antes de usar a integração Microsoft SharePoint, certifique-se de ter:
Configurando a Integração Microsoft SharePoint 1. Conecte sua Conta Microsoft
Navegue para Integrações CrewAI AMP
Encontre Microsoft SharePoint na seção de Integrações de Autenticação
Clique em Conectar e complete o fluxo OAuth
Conceda as permissões necessárias para acesso a sites e arquivos do SharePoint
Copie seu Token Enterprise das Configurações de Integração
2. Instale o Pacote Necessário 3. Configuração de variável de ambiente Para usar integrações com Agent(apps=[]), você deve definir a variável de ambiente CREWAI_PLATFORM_INTEGRATION_TOKEN com seu Enterprise Token.
export CREWAI_PLATFORM_INTEGRATION_TOKEN = "seu_enterprise_token" Ou adicione ao seu arquivo .env:
CREWAI_PLATFORM_INTEGRATION_TOKEN=seu_enterprise_token Ações Disponíveis
microsoft_sharepoint/get_sites
Descrição: Obter todos os sites do SharePoint aos quais o usuário tem acesso.Parâmetros:
search (string, opcional): Consulta de pesquisa para filtrar sites.select (string, opcional): Selecionar propriedades específicas para retornar (ex: ‘displayName,id,webUrl’).filter (string, opcional): Filtrar resultados usando sintaxe OData.expand (string, opcional): Expandir recursos relacionados inline.top (integer, opcional): Número de itens a retornar (mín 1, máx 999).skip (integer, opcional): Número de itens a pular (mín 0).orderby (string, opcional): Ordenar resultados por propriedades especificadas (ex: ‘displayName desc’).
microsoft_sharepoint/get_site
Descrição: Obter informações sobre um site específico do SharePoint.Parâmetros:
site_id (string, obrigatório): O ID do site do SharePoint.select (string, opcional): Selecionar propriedades específicas para retornar (ex: ‘displayName,id,webUrl,drives’).expand (string, opcional): Expandir recursos relacionados inline (ex: ‘drives,lists’).
microsoft_sharepoint/get_site_lists
Descrição: Obter todas as listas em um site do SharePoint.Parâmetros:
site_id (string, obrigatório): O ID do site do SharePoint.
microsoft_sharepoint/get_list
Descrição: Obter informações sobre uma lista específica.Parâmetros:
site_id (string, obrigatório): O ID do site do SharePoint.list_id (string, obrigatório): O ID da lista.
microsoft_sharepoint/get_list_items
Descrição: Obter itens de uma lista do SharePoint.Parâmetros:
site_id (string, obrigatório): O ID do site do SharePoint.list_id (string, obrigatório): O ID da lista.expand (string, opcional): Expandir dados relacionados (ex: ‘fields’).
microsoft_sharepoint/create_list_item
Descrição: Criar um novo item em uma lista do SharePoint.Parâmetros:
site_id (string, obrigatório): O ID do site do SharePoint.list_id (string, obrigatório): O ID da lista.fields (object, obrigatório): Os valores de campo para o novo item.
microsoft_sharepoint/update_list_item
Descrição: Atualizar um item em uma lista do SharePoint.Parâmetros:
site_id (string, obrigatório): O ID do site do SharePoint.list_id (string, obrigatório): O ID da lista.item_id (string, obrigatório): O ID do item a atualizar.fields (object, obrigatório): Os valores de campo a atualizar.
microsoft_sharepoint/delete_list_item
Descrição: Excluir um item de uma lista do SharePoint.Parâmetros:
site_id (string, obrigatório): O ID do site do SharePoint.list_id (string, obrigatório): O ID da lista.item_id (string, obrigatório): O ID do item a excluir.
microsoft_sharepoint/upload_file_to_library
Descrição: Fazer upload de um arquivo para uma biblioteca de documentos do SharePoint.Parâmetros:
site_id (string, obrigatório): O ID do site do SharePoint.file_path (string, obrigatório): O caminho onde fazer upload do arquivo (ex: ‘pasta/nomeDoArquivo.txt’).content (string, obrigatório): O conteúdo do arquivo a fazer upload.
microsoft_sharepoint/get_drive_items
Descrição: Obter arquivos e pastas de uma biblioteca de documentos do SharePoint.Parâmetros:
site_id (string, obrigatório): O ID do site do SharePoint.
microsoft_sharepoint/delete_drive_item
Descrição: Excluir um arquivo ou pasta da biblioteca de documentos do SharePoint.Parâmetros:
site_id (string, obrigatório): O ID do site do SharePoint.item_id (string, obrigatório): O ID do arquivo ou pasta a excluir. Exemplos de Uso Configuração Básica do Agente Microsoft SharePoint from crewai import Agent, Task, Crew # Crie um agente com capacidades do Microsoft SharePoint sharepoint_agent = Agent( role = "Gerenciador SharePoint" , goal = "Gerenciar sites, listas e documentos do SharePoint de forma eficiente" , backstory = "Um assistente IA especializado em administração do Microsoft SharePoint e gerenciamento de conteúdo." , apps = [ 'microsoft_sharepoint' ] # Todas as ações do SharePoint estarão disponíveis ) # Tarefa para obter todos os sites get_sites_task = Task( description = "Listar todos os sites do SharePoint aos quais tenho acesso." , agent = sharepoint_agent, expected_output = "Uma lista de sites do SharePoint com seus nomes de exibição e URLs." ) # Execute a tarefa crew = Crew( agents = [sharepoint_agent], tasks = [get_sites_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 ao SharePoint (ex: Sites.Read.All, Sites.ReadWrite.All).
Verifique se a conexão OAuth inclui todos os escopos necessários.
Problemas de ID de Site/Lista/Item
Verifique novamente os IDs de site, lista e item para correção.
Certifique-se de que os recursos referenciados existem e estão acessíveis.
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 SharePoint.
