В этом руководстве мы настраиваем систему агентов искусственного интеллекта от начала до конца на базе CrewAI и моделей Google Gemini. Сначала мы устанавливаем все необходимые пакеты, безопасно настраиваем ключ Gemini, а затем создаём набор специализированных агентов, включая исследования, анализ данных, создание контента и обеспечение качества, каждый из которых оптимизирован для быстрой последовательной совместной работы.
Установка необходимых пакетов
“`python
import subprocess
import sys
import os
def install_packages():
“””Install required packages in Colab”””
packages = [
“crewai”,
“crewai-tools”,
“google-generativeai”,
“python-dotenv”,
“langchain-google-genai”
]
for package in packages:
try:
print(f” Installing {package}…”)
subprocess.check_call([sys.executable, “-m”, “pip”, “install”, package, “-q”])
print(f” {package} installed successfully!”)
except Exception as e:
print(f” Failed to install {package}: {e}”)
print(” Setting up Google Colab environment…”)
install_packages()
print(” All packages installed!”)
“`
Настройка ключа API
“`python
import warnings
warnings.filterwarnings(‘ignore’)
from crewai import Agent, Task, Crew, Process
from crewai_tools import FileReadTool
from langchaingooglegenai import ChatGoogleGenerativeAI
import google.generativeai as genai
from google.colab import userdata
import time
import json
from datetime import datetime
def setupapikey():
“””Setup Gemini API key in Colab”””
try:
apikey = userdata.get(‘GEMINIAPI_KEY’)
print(” API key loaded from Colab secrets!”)
return api_key
except:
print(” Gemini API key not found in Colab secrets.”)
print(“Please follow these steps:”)
print(“1. Go to https://makersuite.google.com/app/apikey”)
print(“2. Create a free API key”)
print(“3. In Colab, go to (Secrets) in the left sidebar”)
print(“4. Add a new secret named ‘GEMINIAPIKEY’ with your API key”)
print(“5. Enable notebook access for the secret”)
print(“6. Re-run this cell”)
from getpass import getpass
api_key = getpass(“Or enter your Gemini API key here (it will be hidden): “)
return api_key
GEMINIAPIKEY = setupapikey()
“`
Класс системы агентов ColabGemini
“`python
class ColabGeminiAgentSystem:
def init(self, api_key):
“””Initialize the Colab-optimized Gemini agent system”””
self.apikey = apikey
self.setup_gemini()
self.setup_tools()
self.setup_agents()
self.results_history = []
def setup_gemini(self):
“””Configure Gemini API for Colab”””
try:
genai.configure(apikey=self.apikey)
model = genai.GenerativeModel(‘gemini-1.5-flash’)
response = model.generate_content(“Hello, this is a test.”)
print(” Gemini API connection successful!”)
self.llm = ChatGoogleGenerativeAI(
model=”gemini-1.5-flash”,
googleapikey=self.api_key,
temperature=0.7,
convertsystemmessagetohuman=True
)
except Exception as e:
print(f” Gemini API setup failed: {str(e)}”)
raise
# … (продолжение класса)
“`
Использование системы агентов
“`python
print(” Initializing Colab AI Agent System…”)
try:
agentsystem = ColabGeminiAgentSystem(GEMINIAPI_KEY)
print(” System ready for use!”)
except Exception as e:
print(f” System initialization failed: {e}”)
print(“Please check your API key and try again.”)
def runquickexamples():
“””Run quick examples to demonstrate the system”””
print(“\n Quick Start Examples”)
print(“=” * 40)
print(“\n1. Quick Analysis Example:”)
topic1 = “Machine Learning in Business”
result1 = agentsystem.executecolabproject(topic1, tasktype=”quick”)
if result1:
print(f”\n Quick Analysis Result:”)
print(result1)
print(“\n2. Deep Analysis Example:”)
topic2 = “Sustainable Energy Solutions”
result2 = agentsystem.executecolabproject(topic2, tasktype=”analysis”)
if result2:
print(f”\n Deep Analysis Result:”)
print(result2)
“`
Мы создаём основу для рабочего процесса: класс ColabGeminiAgentSystem, который интегрирует Gemini в LangChain, определяет инструмент для чтения файлов и запускает четырёх специализированных агентов: исследователь, аналитик данных, создатель контента и QA, каждый из которых готов к совместной работе над задачами.
1. Какие ключевые шаги включает в себя процесс установки необходимых пакетов для работы с CrewAI и Gemini?
Ответ: для начала работы с системой агентов искусственного интеллекта на базе CrewAI и моделей Google Gemini необходимо выполнить следующие шаги:
* Импортировать необходимые модули и функции.
* Определить список пакетов, которые нужно установить (`packages = [“crewai”, “crewai-tools”, “google-generativeai”, “python-dotenv”, “langchain-google-genai”]`).
* Пройти по списку пакетов и установить каждый из них с помощью `subprocess.check_call`.
2. Какие меры предосторожности следует предпринять при настройке ключа Gemini?
Ответ: при настройке ключа Gemini рекомендуется:
* Использовать секретные переменные Colab для хранения ключа API.
* Создать бесплатный API-ключ на https://makersuite.google.com/app/apikey.
* Добавить новый секрет с именем `GEMINIAPIKEY` в Colab и включить доступ к нему для ноутбука.
* В случае возникновения проблем с загрузкой ключа API из секретов Colab, можно ввести ключ вручную с помощью `getpass`.
3. Какие основные компоненты включает в себя класс системы агентов ColabGemini?
Ответ: класс системы агентов ColabGemini включает в себя следующие основные компоненты:
* Метод `init` для инициализации системы агентов.
* Метод `setup_gemini` для настройки API Gemini.
* Метод `setup_tools` для настройки инструментов.
* Метод `setup_agents` для настройки агентов.
* Список `results_history` для хранения результатов работы агентов.
* Переменная `api_key` для хранения ключа API Gemini.