Cloudflare Agents: создание интерактивных интеллектов в реальном времени в пограничных сетях

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

Cloudflare Agents - это фреймворк с открытым исходным кодом от Cloudflare, призванный помочь разработчикам создавать интеллектуальные агенты ИИ в глобальных пограничных сетях. Он дает агентам возможность сохранять состояние, взаимодействовать в режиме реального времени и работать автономно, и в настоящее время проект находится в активной разработке. Основные функции включают управление состоянием и взаимодействие в реальном времени через WebSocket, которые уже можно использовать для создания чат-ботов или автоматизированных инструментов для решения задач. Cloudflare Agents нацелен на создание распределенной интеллектуальной агентской системы, в которой агенты могут работать глобально с поддержкой механизмов сна и пробуждения. Разработчики могут присоединиться к этому проекту с открытым исходным кодом, выполнив простую процедуру установки, и вместе работать над развитием технологий искусственного интеллекта.

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

• Основная структура агента: Обеспечивает функциональность управления состоянием, при которой агенты могут запоминать исторические данные о взаимодействии.
• связь в реальном времени: Поддерживает мгновенный диалог между агентом и клиентом через WebSocket.
• Маршрутизация HTTP: Обработка веб-запросов и взаимодействие с внешними службами.
• Интеграция с React: Встроенные крючки React для фронтенд-разработчиков.
• Базовый чат с искусственным интеллектом: Поддержка построения простых интеллектуальных диалоговых систем.
• Разрабатываемые функции: Включает в себя расширенную систему памяти, поддержку аудио и видео WebRTC, а также возможности электронной почты.

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

Cloudflare Agents - это инструмент, ориентированный на разработчиков и требующий базовых знаний программирования перед использованием. Ниже приведено подробное руководство по установке и эксплуатации, которое поможет вам быстро начать работу и максимально использовать его возможности.

Процесс установки

Cloudflare Agents устанавливается через npm и поддерживает новые проекты или добавление к существующим. Вот шаги.

Новые строительные проекты

1. Проверка окружения
   Убедитесь, что на вашем компьютере установлены Node.js (рекомендуется версия 16 или выше) и npm. Откройте терминал и введите node -v ответить пением npm -v Просмотрите номер версии.
2. Создать проект
   Выполните следующую команду в терминале:

npm create cloudflare@latest -- --template cloudflare/agents-starter

Вам будет предложено ввести имя проекта и выбрать каталог, после чего будет создан базовый проект.
3. Перейдите в каталог проекта
импорт cd 你的项目名称 Перейдите в папку только что созданного проекта.
4. Начало местного развития
Бег:

npm run dev

Это запустит локальный сервер, и вы сможете получить доступ к локальному адресу через браузер (обычно это http://localhost:8787), чтобы увидеть эффект.

Добавить к существующему проекту

1. Перейдите в каталог проекта
   конечное использование cd чтобы перейти к существующей папке проекта.
2. Установка SDK
   Вход:

npm install agents-sdk

Это добавит в проект основную библиотеку Cloudflare Agents.
3. Код конфигурации
Введено в код agents-sdkОбратитесь к официальной документации по использованию.

Основные функции

Создание простого чат-агента с искусственным интеллектом

1. Написание кода прокси-сервера
   Создайте файл в проекте (например. worker.ts), введите следующий код:

import { Agent } from "agents-sdk";
export class ChatAgent extends Agent {
async onRequest(request) {
const message = await request.text();
return new Response(`你说：${message}`);
}
}

Этот агент будет просто отвечать на вводимые пользователем слова.
2. Развертывание на Cloudflare
Запускается в терминале:

npx wrangler@latest deploy

Следуя подсказкам, войдите в свою учетную запись Cloudflare, и по завершении развертывания вам будет предоставлен URL-адрес.
3. функция тестирования
Посетите развернутый URL-адрес с помощью браузера или отправьте сообщение с помощью такого инструмента, как Postman, чтобы проверить, работает ли ответ.

Общение в реальном времени с помощью WebSocket

1. Настройка поддержки WebSocket
   Измените код агента, чтобы включить в него связь в реальном времени:

   import { Agent } from "agents-sdk";
   export class RealTimeAgent extends Agent {
   async onConnect(connection) {
   connection.send("已连接！");
   }
   async onMessage(connection, message) {
   connection.send(`收到消息：${message}`);
   }
   }
   

2. внешний брокер соединений
   Добавьте его во внешний код:

   const ws = new WebSocket("wss://你的代理URL");
   ws.onmessage = (event) => console.log(event.data);
   ws.send("你好");
   

   Таким образом, создается канал связи в реальном времени, по которому сообщения отправляются и ответы на них поступают немедленно.

3. эксплуатационное испытание
   После развертывания запустите внешний код с помощью консоли инструмента разработчика браузера, чтобы посмотреть, как работает взаимодействие с сообщениями.

Статус управляющего агента

1. Сохранение и обновление статуса
   Добавьте управление состояниями в агент:

   export class StateAgent extends Agent {
   async onRequest(request) {
   this.state.count = (this.state.count || 0) + 1;
   return new Response(`访问次数：${this.state.count}`);
   }
   }
   

2. Постоянство состояния проверки
   Посетите URL-адрес прокси несколько раз после развертывания и посмотрите, продолжает ли увеличиваться счетчик, доказывая, что состояние сохраняется.
3. сценарий применения
   Управление состоянием подходит для сценариев, в которых необходимо записывать историю, например количество взаимодействий с пользователем или ход выполнения задачи.

Детали процесса эксплуатации

• локальная отладка: Беги npm run dev Включите режим разработки и автоматически обновляйте код после внесения изменений для удобства тестирования.
• Развертывание начинается: Использование npx wrangler@latest deploy Публикуйте агентов в глобальной сети Cloudflare.
• Доступ к документам: Доступ официальный документ Получите больше примеров кода и подробную информацию об API.
• Участие в жизни общества: Если у вас есть предложения по улучшению, вы можете отправить проблемы или код на GitHub и принять участие в развитии проекта.

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

• переменная окружения: Если вам нужно вызвать внешнюю модель ИИ (например, OpenAI), сделайте это в wrangler.toml файл для настройки ключа API.
• сетевые требования: Для развертывания требуется стабильное сетевое соединение, чтобы не было перебоев при входе в Cloudflare.
• Учебные ресурсы: Официально предоставлено Игровая площадка Пример (находится в репозитории GitHub в разделе examples/playground), вы можете запустить ссылку напрямую.

С помощью описанных выше шагов вы сможете легко создать агента искусственного интеллекта. Преимуществом агентов Cloudflare является их глобально распределенное развертывание и функции сохранения состояния, которые подходят для сценариев приложений, требующих низкой задержки и высокой доступности.