Pular para o conteúdo principal

​
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

  1. Navegue para Integrações CrewAI AMP
  2. Encontre Microsoft SharePoint 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 sites e arquivos do SharePoint
  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: 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’).
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’).
Descrição: Obter todas as listas em um site do SharePoint.Parâmetros:
  • site_id (string, obrigatório): O ID do site do SharePoint.
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.
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’).
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.
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.
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.
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.
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.
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.
⌘I