ACI.DEV: Integração de mais de 600 ferramentas para inteligências de IA por meio do servidor MCP

Introdução geral

O ACI.dev é uma plataforma de infraestrutura de código aberto projetada para fornecer às inteligências de IA uma rápida integração com mais de 600 ferramentas. Ela garante que as inteligências tenham acesso seguro a ferramentas como o Google Agenda, o Slack e o Brave Search por meio de autenticação multilocatário e gerenciamento de permissões refinadas. Os desenvolvedores podem acessar ferramentas como o Google Agenda, o Slack e o Brave Search por meio de chamadas de função diretas ou unificadas. MCP O ACI.dev fornece um SDK Python e documentação detalhada para dar suporte ao rápido desenvolvimento de inteligências de IA que funcionam imediatamente em ambientes de produção.

Lista de funções

• Integração com mais de 600 ferramentas e suporte para serviços como Google Calendar, Slack, Brave Search e muito mais.
• Oferece suporte à autenticação de vários locatários, gerencia os direitos do desenvolvedor e do usuário e garante a segurança dos dados.
• Fornece um servidor MCP unificado para simplificar a pesquisa e a execução de ferramentas.
• Oferece suporte a chamadas diretas de função e se adapta a uma variedade de estruturas de inteligência de IA.
• Fornece o Python SDK para que os desenvolvedores chamem a API da ACI.
• Oferece suporte à descoberta dinâmica de ferramentas, em que as inteligências podem selecionar automaticamente as ferramentas com base na intenção da tarefa.
• Fornece autenticação OAuth2 e chave de API para simplificar o processo de autorização para ferramentas de terceiros.
• Suporte para limites de permissão de linguagem natural para aumentar a confiabilidade da inteligência.
• Suporte à comunidade de código aberto que permite aos usuários enviar solicitações de integração de ferramentas ou contribuir com código.
• A documentação detalhada e o código de amostra são fornecidos para dar suporte a um início rápido.

Usando a Ajuda

Instalação e configuração

O ACI.dev é um projeto de código aberto hospedado no GitHub. Os desenvolvedores podem integrar a funcionalidade da ACI implantando a plataforma completa localmente (incluindo o servidor de back-end e o portal de front-end) ou usando o Python SDK. Veja a seguir as etapas detalhadas de instalação e uso:

1. implantação local da plataforma ACI.dev

Para executar o servidor back-end e o portal front-end do ACI.dev, siga estas etapas:

• Clonagem da base de códigoExecute o seguinte comando no terminal para obter o código-fonte do ACI:

  git clone https://github.com/aipotheosis-labs/aci.git
  cd aci

• Instalação de dependênciasA ACI usa Python 3.12+ e Docker. Certifique-se de que o Docker e o Docker Compose estejam instalados. backend instale as dependências:

  cd backend
  uv sync
  source .venv/bin/activate
  

  fazer uso de uv O Package Manager instala as dependências. Se o uvpode ser executado:

  pip install uv
  

• Configuração de variáveis de ambienteCopie o arquivo de variável de ambiente de exemplo e modifique-o:

  cp .env.example .env.local
  

  existir .env.local As seguintes variáveis-chave são definidas no

  • SERVER_OPENAI_API_KEYChave de API da OpenAI para chamadas de smartbody.
  • CLI_OPENAI_API_KEYChave do servidor: A mesma que a chave do servidor ou outra.
  • Se estiver usando o recurso de faturamento do Stripe, execute a CLI do Stripe para obter a chave de assinatura do webhook:

    stripe listen --forward-to localhost:8000/v1/billing/webhook
    

    Defina a saída do SERVER_STRIPE_WEBHOOK_SIGNING_SECRET adicionar a .env.local.

• Início dos serviçosIniciar o backend e o frontend usando o Docker Compose:

  docker-compose up
  

  As APIs de back-end são executadas por padrão no diretório localhost:8000O portal front-end é executado em localhost:3000.

• Acesso ao portal front-end: Abrir no navegador http://localhost:3000Registre-se para obter uma conta. Após o registro, o sistema cria automaticamente projetos de teste e inteligências, e os desenvolvedores podem gerenciar ferramentas e permissões por meio do portal.

2. usando o SDK do Python

Se você quiser invocar a funcionalidade da ACI somente por meio de código, poderá usar o Python SDK:

• Instalação do SDK::

  pip install aci-python-sdk
  

• Inicialização do SDK::

  from aci import ACI
  import os
  client = ACI(api_key=os.environ.get("ACI_API_KEY"))
  

  ACI_API_KEY Disponível na plataforma ACI.dev (http://localhost:3000) é obtido nas configurações do projeto.

• Exemplo: Pesquisar ferramentas disponíveis::

  apps = client.apps.search(intent="搜索网页", allowed_apps_only=False)
  print(apps)  # 返回与意图相关的工具列表
  

• Exemplo: Funções da ferramenta de execução::

  result = client.functions.execute(
  function_name="BRAVE_SEARCH__WEB_SEARCH",
  function_parameters={"query": {"q": "北京天气"}},
  linked_account_owner_id="user123"
  )
  if result.success:
  print(result.data)
  else:
  print(result.error)
  

3. usando o servidor do Unified MCP

O servidor MCP é o componente principal do ACI.dev e oferece dois modos: Servidor de aplicativos e Servidor unificado:

• servidor de aplicativosAcesso direto à ferramenta especificada. Por exemplo, inicie os servidores de aplicativos do Brave Search e do Gmail:

  uvx aci-mcp apps-server --apps "BRAVE_SEARCH,GMAIL" --linked-account-owner-id user123
  

• servidor unificadoDescoberta e execução dinâmicas de todas as ferramentas da ACI:

  uvx aci-mcp unified-server --linked-account-owner-id user123 --allowed-apps-only
  

  O Unified Server oferece duas metafunções:ACI_SEARCH_FUNCTIONS(ferramenta de pesquisa) e ACI_EXECUTE_FUNCTION(Ferramenta de Execução), reduzindo o espaço ocupado pela janela de contexto do LLM.

• Configurar links de conta: Antes de usar a ferramenta, você precisa vincular sua conta na plataforma ACI.dev. Por exemplo, vincule o Brave Search:

  result = client.linked_accounts.link(
  app_name="BRAVE_SEARCH",
  linked_account_owner_id="user123",
  security_scheme="API_KEY",
  api_key="your-brave-api-key"
  )
  

  Para ferramentas que exigem OAuth2 (por exemplo, Gmail), o SDK retorna o URL de autorização e o usuário precisa concluir a autorização no navegador.

4. operação de recursos especiais

• Descoberta de ferramentas dinâmicasO Unified MCP Server oferece suporte à seleção automatizada de ferramentas por inteligências com base na intenção da tarefa. Código de amostra:

  from aci.meta_functions import ACISearchFunctions
  tools = [ACISearchFunctions.to_json_schema(format="OPENAI")]
  

  Corpos inteligentes podem ser passados ACI_SEARCH_FUNCTIONS Consultar ferramentas relacionadas à tarefa.

• Certificação para vários locatáriosPermissões: Os desenvolvedores podem definir permissões separadas para diferentes usuários. Por exemplo, restringir as inteligências para que usem apenas a conta Brave Search de um usuário específico:

  client.functions.execute(
  function_name="BRAVE_SEARCH__WEB_SEARCH",
  linked_account_owner_id="user123",
  allowed_apps_only=True
  )
  

• Limite de autoridade de linguagem naturalO ACI.dev é compatível com a definição de permissões em linguagem natural. Por exemplo, a restrição de um inteligente a apenas "ler o calendário" e não a "modificar o calendário" é configurada por meio do portal front-end ou do SDK:

  client.permissions.set(
  agent_id="agent123",
  boundaries={"calendar": ["read"]}
  )
  

• Contribuições da comunidadeDesenvolvedores: Os desenvolvedores podem enviar solicitações de novas integrações de ferramentas ou contribuir com código diretamente pelo GitHub. Referências CONTRIBUTING.md responder cantando Integration Request Template::

  gh issue create --title "New Integration: Twitter API" --body-file integration_request.yml
  

5. acesso a documentação e exemplos

• documento oficial: Acesso https://aci.dev/docs Obtenha referências e tutoriais detalhados sobre a API.
• Lista de ferramentas: Ver https://aci.dev/tools Saiba mais sobre as mais de 600 ferramentas suportadas.
• Exemplos de projetos: Referência https://github.com/aipotheosis-labs/aci-agents Obtenha um exemplo de desenvolvimento inteligente do corpo.

advertência

• seguro .env.local As chaves de API no
• Para o desenvolvimento local, você pode usar o DBeaver para se conectar ao banco de dados (parâmetros no .env.local), visualize a estrutura de dados.
• O Python SDK está em versão beta e pode ter atualizações incompatíveis, portanto, recomendamos seguir as notas de versão no repositório do GitHub.
• Algumas ferramentas (como o Brave Search) exigem que os usuários forneçam suas próprias chaves de API, o que pode envolver taxas de terceiros.

cenário do aplicativo

1. Chatbot de assistente pessoal
   Use o ACI.dev para criar assistentes de IA que pesquisam na Web, gerenciam calendários e enviam e-mails. A autenticação multilocatário garante o isolamento dos dados da conta entre diferentes usuários para aumentar a produtividade pessoal.
2. Inteligência de pesquisa
   Os desenvolvedores podem usar o ACI.dev para integrar o Brave Search e o Notion para criar inteligência que busca e organiza automaticamente material de pesquisa, adequado para pesquisa acadêmica ou análise de mercado.
3. automação de vendas
   O ACI.dev oferece suporte à integração do CRM e do Gmail, permitindo que os desenvolvedores criem inteligência de vendas que gera automaticamente listas de clientes potenciais e envia e-mails para aumentar a eficiência dos negócios.
4. Inteligência de suporte ao cliente
   Integre o Zendesk e o Slack com o ACI.dev para criar inteligências que respondem automaticamente a consultas de clientes e gerenciam ordens de serviço para atendimento ao cliente corporativo.
5. Colaboração com a comunidade de código aberto
   A natureza de código aberto do ACI.dev incentiva os desenvolvedores a contribuir com novas integrações de ferramentas para aprimorar o ecossistema da plataforma. Por exemplo, adicione a API do Twitter para ampliar a funcionalidade das inteligências.

QA

1. Quais linguagens de programação são compatíveis com o ACI.dev?
   Suporta principalmente o Python, por meio do Python SDK para chamar a API. Outras linguagens podem ser acessadas por meio da API REST, sendo necessário implementar sua própria solicitação HTTP.
2. Como faço para adicionar uma nova integração de ferramenta?
   Para acessar os repositórios do GitHub, consulte CONTRIBUTING.md responder cantando Integration Request TemplateEnvie solicitações de integração de ferramentas ou contribua com código diretamente.
3. Quais são as vantagens de um servidor MCP unificado?
   aprovar (um projeto de lei ou inspeção etc.) ACI_SEARCH_FUNCTIONS responder cantando ACI_EXECUTE_FUNCTION Duas metafunções para unificar o gerenciamento de mais de 600 ferramentas, reduzir a ocupação da janela de contexto do LLM e melhorar a eficiência da inteligência.
4. É necessário configurar uma autenticação separada para cada ferramenta?
   Não. O ACI.dev oferece autenticação unificada de vários locatários, em que os desenvolvedores simplesmente vinculam contas na plataforma e as inteligências podem acessar a ferramenta com segurança.
5. O ACI.dev cobra alguma taxa?
   O ACI.dev é uma plataforma de código aberto e de uso gratuito. Algumas ferramentas podem exigir que os usuários forneçam suas próprias chaves de API, o que pode envolver taxas de terceiros.
6. Como posso garantir que meu smart body é seguro para operar?
   O ACI.dev oferece gerenciamento de privilégios com granularidade fina e limites de privilégios em linguagem natural, permitindo que os desenvolvedores definam o escopo de operação das inteligências por meio do portal front-end ou do SDK.