ACI.DEV: Интеграция 600+ инструментов для искусственного интеллекта через MCP-сервер

Общее введение

ACI.dev - это инфраструктурная платформа с открытым исходным кодом, предназначенная для быстрой интеграции искусственного интеллекта с более чем 600 инструментами. Она обеспечивает интеллектуальным системам безопасный доступ к таким инструментам, как Google Calendar, Slack и Brave Search, благодаря многопользовательской аутентификации и тонкому управлению разрешениями. Разработчики могут получить доступ к таким инструментам, как Google Calendar, Slack и Brave Search, через прямые вызовы функций или унифицированные функции. MCP ACI.dev предоставляет SDK на языке Python и подробную документацию для быстрой разработки искусственного интеллекта, который работает в производственных средах "из коробки".

Список функций

• Интеграция с 600+ инструментами и поддержка таких сервисов, как Google Calendar, Slack, Brave Search и др.
• Поддерживает многопользовательскую аутентификацию, управляет правами разработчиков и пользователей, а также обеспечивает безопасность данных.
• Предоставляет единый сервер MCP для упрощения поиска и выполнения инструментов.
• Поддерживает прямые вызовы функций и адаптируется к различным фреймворкам искусственного интеллекта.
• Предоставляет Python SDK для разработчиков для вызова ACI API.
• Поддержка динамического поиска инструментов, когда интеллект может автоматически выбирать инструменты в зависимости от цели задачи.
• Обеспечивает аутентификацию по протоколу OAuth2 и API-ключам для упрощения процесса авторизации сторонних инструментов.
• Поддержка границ разрешений на естественном языке для повышения надежности интеллигенции.
• Поддержка сообщества с открытым исходным кодом, позволяющая пользователям отправлять запросы на интеграцию инструментов или предоставлять код.
• Подробная документация и примеры кода помогут быстро начать работу.

Использование помощи

Установка и настройка

ACI.dev - это проект с открытым исходным кодом, размещенный на GitHub. Разработчики могут интегрировать функциональность ACI, развернув полную платформу локально (включая внутренний сервер и внешний портал) или используя Python SDK. Ниже приведены подробные шаги по установке и использованию:

1. локальное развертывание платформы ACI.dev

Чтобы запустить внутренний сервер ACI.dev и внешний портал, выполните следующие действия:

• Клонирование кодовой базы: Выполните следующую команду в терминале, чтобы получить исходный код ACI:

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

• Установка зависимостей: ACI использует Python 3.12+ и Docker. убедитесь, что Docker и Docker Compose установлены. перейдите по ссылке backend установите зависимости:

  cd backend
  uv sync
  source .venv/bin/activate
  

  пользоваться uv Менеджер пакетов устанавливает зависимости. Если при установке пакетов не были установлены uvможно запускать:

  pip install uv
  

• Настройка переменных среды: Скопируйте файл переменной окружения примера и измените его:

  cp .env.example .env.local
  

  существовать .env.local Следующие ключевые переменные задаются в

  • SERVER_OPENAI_API_KEY: API-ключ OpenAI для вызовов smartbody.
  • CLI_OPENAI_API_KEY: То же, что и ключ сервера или другой.
  • Если вы используете функцию биллинга Stripe, запустите Stripe CLI, чтобы получить ключ подписи веб-хука:

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

    Установите выход SERVER_STRIPE_WEBHOOK_SIGNING_SECRET добавить к .env.local.

• Начальные услуги: Запустите бэкэнд и фронтэнд с помощью Docker Compose:

  docker-compose up
  

  Внутренние API по умолчанию запускаются в localhost:8000Внешний портал работает на localhost:3000.

• Доступ к внешнему порталу: Открыть в браузере http://localhost:3000, зарегистрируйтесь для получения учетной записи. После регистрации система автоматически создает тестовые проекты и интеллекты, а разработчики могут управлять инструментами и разрешениями через портал.

2. Использование Python SDK

Если вы хотите вызывать функциональность ACI только через код, вы можете использовать Python SDK:

• Установка SDK::

  pip install aci-python-sdk
  

• Инициализация SDK::

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

  ACI_API_KEY Доступно на платформе ACI.dev (http://localhost:3000) получен из настроек проекта.

• Пример: поиск доступных инструментов::

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

• Пример: Функции инструмента исполнения::

  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. Использование сервера Unified MCP

Сервер MCP является основным компонентом ACI.dev и предлагает два режима работы: сервер приложений и унифицированный сервер:

• сервер приложений: Прямой доступ к указанному инструменту. Например, запустите серверы приложений для Brave Search и Gmail:

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

• унифицированный сервер: Динамическое обнаружение и выполнение всех инструментов ACI:

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

  Unified Server предоставляет две мета-функции:ACI_SEARCH_FUNCTIONS(инструмент поиска) и ACI_EXECUTE_FUNCTION(Execution Tool), уменьшая площадь контекстного окна LLM.

• Настройка ссылок на учетные записи: Перед использованием инструмента необходимо связать вашу учетную запись на платформе ACI.dev. Например, привяжите 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"
  )
  

  Для инструментов, требующих OAuth2 (например, Gmail), SDK возвращает URL-адрес авторизации, и пользователь завершает авторизацию в браузере.

4. Эксплуатация специальных функций

• Динамическое обнаружение инструментов: Unified MCP Server поддерживает автоматический выбор инструментов интеллектами на основе намерения задачи. Пример кода:

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

  Интеллектуальные тела могут быть переданы ACI_SEARCH_FUNCTIONS Запрашивайте инструменты, связанные с выполнением задач.

• Сертификация многопользовательских услуг: Разработчики могут устанавливать отдельные разрешения для разных пользователей. Например, ограничить использование интеллекта только учетной записью Brave Search определенного пользователя:

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

• Граница полномочий естественного языкаACI.dev поддерживает определение разрешений на естественном языке. Например, ограничение интеллекта только на "чтение календаря", но не на "изменение календаря", настраивается через внешний портал или SDK:

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

• Вклад в развитие сообщества: Разработчики могут отправлять запросы на интеграцию новых инструментов или предоставлять код непосредственно через GitHub. Ссылки CONTRIBUTING.md ответить пением Integration Request Template::

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

5. доступ к документации и примерам

• официальный документ: Доступ https://aci.dev/docs Получите подробные рекомендации и руководства по API.
• Список инструментов: Смотреть https://aci.dev/tools Узнайте о 600+ поддерживаемых инструментах.
• Образцы проектов: Справочник https://github.com/aipotheosis-labs/aci-agents Приведите пример разумного развития тела.

предостережение

• безопасный .env.local Ключи API в
• Для локальной разработки вы можете использовать DBeaver для подключения к базе данных (параметры в .env.local), просмотрите структуру данных.
• Python SDK находится в стадии бета-версии и может иметь несовместимые обновления, поэтому мы рекомендуем следить за примечаниями к выпуску в репозитории GitHub.
• Некоторые инструменты (например, Brave Search) требуют от пользователей предоставления собственных ключей API, что может потребовать оплаты услуг третьих сторон.

сценарий применения

1. Чатбот с персональным помощником
   Используйте ACI.dev для создания помощников с искусственным интеллектом, которые будут искать информацию в Интернете, управлять календарями и отправлять электронную почту. Многопользовательская аутентификация обеспечивает изоляцию учетных данных разных пользователей для повышения производительности.
2. Исследовательская разведка
   Разработчики могут использовать ACI.dev для интеграции Brave Search и Notion, чтобы создать интеллектуальную систему, которая автоматически ищет и организует исследовательские материалы, подходящие для академических исследований или анализа рынка.
3. автоматизация продаж
   ACI.dev поддерживает интеграцию с CRM и Gmail, позволяя разработчикам создавать интеллектуальные системы продаж, которые автоматически формируют списки потенциальных клиентов и отправляют электронные письма для повышения эффективности бизнеса.
4. Интеллектуальная поддержка клиентов
   Интегрируйте Zendesk и Slack с ACI.dev, чтобы создать интеллектуальные системы, автоматически отвечающие на запросы клиентов и управляющие рабочими заказами для корпоративной службы поддержки.
5. Сотрудничество с сообществом разработчиков открытого исходного кода
   Открытый исходный код ACI.dev поощряет разработчиков к интеграции новых инструментов для улучшения экосистемы платформы. Например, добавьте API Twitter, чтобы расширить функциональность интеллекта.

QA

1. Какие языки программирования поддерживает ACI.dev?
   В основном поддерживается Python, через Python SDK для вызова API. Другие языки могут быть доступны через REST API, необходимо реализовать свой собственный HTTP запрос.
2. Как добавить новую интеграцию инструментов?
   Чтобы получить доступ к репозиториям GitHub, см. CONTRIBUTING.md ответить пением Integration Request TemplateОтправьте запрос на интеграцию инструмента или внесите свой код напрямую.
3. В чем преимущества унифицированного сервера MCP?
   пройти (законопроект, проверку и т.д.) ACI_SEARCH_FUNCTIONS ответить пением ACI_EXECUTE_FUNCTION Две мета-функции для унификации управления 600+ инструментами, уменьшения занятости контекстного окна LLM и повышения эффективности работы интеллигенции.
4. Нужно ли настраивать отдельную аутентификацию для каждого инструмента?
   Нет. ACI.dev обеспечивает унифицированную многопользовательскую аутентификацию, при которой разработчикам достаточно связать учетные записи в платформе, и интеллектуалы смогут получить безопасный доступ к инструменту.
5. Взимает ли ACI.dev плату?
   ACI.dev является платформой с открытым исходным кодом и бесплатна для использования. Некоторые инструменты могут потребовать от пользователей предоставления собственных API-ключей, что может повлечь за собой оплату услуг третьих сторон.
6. Как обеспечить безопасность эксплуатации "умного тела"?
   ACI.dev обеспечивает тонкое управление привилегиями и границы привилегий на естественном языке, позволяя разработчикам устанавливать область действия интеллектов через внешний портал или SDK.