跳转到内容

使用谷歌Gemini模型进行图像理解的多模态LLM,并利用LlamaIndex构建检索增强生成

在本笔记本中,我们将展示如何使用谷歌的Gemini Vision模型进行图像理解。

首先,我们展示几个目前为Gemini支持的函数:

  • completecomplete(同步与异步皆可):针对单个提示和图像列表
  • chatchat(同步与异步皆可):用于处理多条聊天消息
  • stream completestream complete(同步与异步皆可):用于完整输出的流式传输
  • stream chatstream chat(同步与异步均可):用于流式输出聊天内容

在本笔记本的第二部分,我们尝试使用 Gemini + Pydantic 来解析来自谷歌地图图像的结构化信息。

  • 定义具有属性字段的所需Pydantic类
  • gemini-pro-vision 模型理解每张图像并输出结构化结果

对于本笔记本的第三部分,我们建议使用 Gemini 和 LlamaIndex 为小型谷歌地图餐厅数据集构建一个简单的 Retrieval Augmented Generation 流程。

  • 基于步骤2的结构化输出构建向量索引
  • 使用 gemini-pro 模型综合结果,并根据用户查询推荐餐厅。

注意:google-generativeai 仅适用于特定国家和地区。

%pip install llama-index-multi-modal-llms-gemini
%pip install llama-index-vector-stores-qdrant
%pip install llama-index-embeddings-gemini
%pip install llama-index-llms-gemini
!pip install llama-index 'google-generativeai>=0.3.0' matplotlib qdrant_client
%env GOOGLE_API_KEY=...
import os
GOOGLE_API_KEY = "" # add your GOOGLE API key here
os.environ["GOOGLE_API_KEY"] = GOOGLE_API_KEY

Initialize GeminiMultiModal and Load Images from URLs

Section titled “Initialize GeminiMultiModal and Load Images from URLs”
from llama_index.llms.gemini import Gemini
from llama_index.core.llms import ChatMessage, ImageBlock
image_urls = [
"https://storage.googleapis.com/generativeai-downloads/data/scene.jpg",
# Add yours here!
]
gemini_pro = Gemini(model_name="models/gemini-1.5-flash")
msg = ChatMessage("Identify the city where this photo was taken.")
for img_url in image_urls:
msg.blocks.append(ImageBlock(url=img_url))
from PIL import Image
import requests
from io import BytesIO
import matplotlib.pyplot as plt
img_response = requests.get(image_urls[0])
print(image_urls[0])
img = Image.open(BytesIO(img_response.content))
plt.imshow(img)
https://storage.googleapis.com/generativeai-downloads/data/scene.jpg
<matplotlib.image.AxesImage at 0x128032e40>

png

在提示中使用图像进行聊天

Section titled “Chat using images in the prompt”
response = gemini_pro.chat(messages=[msg])
print(response.message.content)
That's New York City. More specifically, the photo shows a street in the **SoHo** neighborhood. The distinctive cast-iron architecture and the pedestrian bridge are characteristic of that area.
stream_response = gemini_pro.stream_chat(messages=[msg])
import time
for r in stream_response:
print(r.delta, end="")
# Add an artificial wait to make streaming visible in the notebook
time.sleep(0.5)
That's New York City. More specifically, the photo was taken in the **West Village** neighborhood of Manhattan. The distinctive architecture and the pedestrian bridge are strong clues.
response_achat = await gemini_pro.achat(messages=[msg])
print(response_achat.message.content)
That's New York City. More specifically, the photo was taken in the **West Village** neighborhood of Manhattan. The distinctive architecture and the pedestrian bridge are strong clues.

让我们看看如何进行异步流式传输:

import asyncio
streaming_handler = await gemini_pro.astream_chat(messages=[msg])
async for chunk in streaming_handler:
print(chunk.delta, end="")
# Add an artificial wait to make streaming visible in the notebook
await asyncio.sleep(0.5)
That's New York City. More specifically, the photo was taken in the **West Village** neighborhood of Manhattan. The distinctive architecture and the pedestrian bridge are strong clues.
image_urls = [
"https://picsum.photos/id/1/200/300",
"https://picsum.photos/id/26/200/300",
]
msg = ChatMessage("Is there any relationship between these images?")
for img_url in image_urls:
msg.blocks.append(ImageBlock(url=img_url))
response_multi = gemini_pro.chat(messages=[msg])
print(response_multi.message.content)
Yes, there is a relationship between the two images. Both images depict aspects of a **professional or business-casual lifestyle**.
* **Image 1:** Shows someone working on a laptop, suggesting remote work, freelancing, or a business-related task.
* **Image 2:** Shows a flat lay of accessories commonly associated with a professional or stylish individual: sunglasses, a bow tie, a pen, a watch, glasses, and a phone. These items suggest a certain level of personal style and preparedness often associated with business or professional settings.
The connection is indirect but thematic. They both visually represent elements of a similar lifestyle or persona.

第二部分:Gemini + Pydantic 用于从图像中解析结构化输出

Section titled “2nd Part: Gemini + Pydantic for Structured Output Parsing from an Image”
  • 利用 Gemini 进行图像推理
  • 使用 Pydantic 程序从 Gemini 图像推理结果生成结构化输出
from pathlib import Path
input_image_path = Path("google_restaurants")
if not input_image_path.exists():
Path.mkdir(input_image_path)
!curl -sL "https://docs.google.com/uc?export=download&id=1Pg04p6ss0FlBgz00noHAOAJ1EYXiosKg" -o ./google_restaurants/miami.png
!curl -sL "https://docs.google.com/uc?export=download&id=1dYZy17bD6pSsEyACXx9fRMNx93ok-kTJ" -o ./google_restaurants/orlando.png
!curl -sL "https://docs.google.com/uc?export=download&id=1ShPnYVc1iL_TA1t7ErCFEAHT74-qvMrn" -o ./google_restaurants/sf.png
!curl -sL "https://docs.google.com/uc?export=download&id=1WjISWnatHjwL4z5VD_9o09ORWhRJuYqm" -o ./google_restaurants/toronto.png
from pydantic import BaseModel
from PIL import Image
import matplotlib.pyplot as plt
class GoogleRestaurant(BaseModel):
"""Data model for a Google Restaurant."""
restaurant: str
food: str
location: str
category: str
hours: str
price: str
rating: float
review: str
description: str
nearby_tourist_places: str
google_image_url = "./google_restaurants/miami.png"
image = Image.open(google_image_url).convert("RGB")
plt.figure(figsize=(16, 5))
plt.imshow(image)
<matplotlib.image.AxesImage at 0x10953cce0>

png

from llama_index.multi_modal_llms.gemini import GeminiMultiModal
from llama_index.core.program import MultiModalLLMCompletionProgram
from llama_index.core.output_parsers import PydanticOutputParser
prompt_template_str = """\
can you summarize what is in the image\
and return the answer with json format \
"""
def pydantic_gemini(
model_name, output_class, image_documents, prompt_template_str
):
gemini_llm = GeminiMultiModal(model_name=model_name)
llm_program = MultiModalLLMCompletionProgram.from_defaults(
output_parser=PydanticOutputParser(output_class),
image_documents=image_documents,
prompt_template_str=prompt_template_str,
multi_modal_llm=gemini_llm,
verbose=True,
)
response = llm_program()
return response
from llama_index.core import SimpleDirectoryReader
google_image_documents = SimpleDirectoryReader(
"./google_restaurants"
).load_data()
results = []
for img_doc in google_image_documents:
pydantic_response = pydantic_gemini(
"models/gemini-1.5-flash",
GoogleRestaurant,
[img_doc],
prompt_template_str,
)
# only output the results for miami for example along with image
if "miami" in img_doc.image_path:
for r in pydantic_response:
print(r)
results.append(pydantic_response)
> Raw output: ```json
{
"restaurant": "La Mar by Gaston Acurio",
"food": "Peruvian & fusion",
"location": "500 Brickell Key Dr, Miami, FL 33131",
"category": "South American restaurant",
"hours": "Opens 6PM, Closes 11 PM",
"price": "$$$",
"rating": 4.4,
"review": "Chic waterfront offering Peruvian & fusion fare, plus bars for cocktails, ceviche & anticuchos.",
"description": "Chic waterfront offering Peruvian & fusion fare, plus bars for cocktails, ceviche & anticuchos.",
"nearby_tourist_places": "Brickell Key area with scenic views"
}
```
('restaurant', 'La Mar by Gaston Acurio')
('food', 'Peruvian & fusion')
('location', '500 Brickell Key Dr, Miami, FL 33131')
('category', 'South American restaurant')
('hours', 'Opens 6PM, Closes 11 PM')
('price', '$$$')
('rating', 4.4)
('review', 'Chic waterfront offering Peruvian & fusion fare, plus bars for cocktails, ceviche & anticuchos.')
('description', 'Chic waterfront offering Peruvian & fusion fare, plus bars for cocktails, ceviche & anticuchos.')
('nearby_tourist_places', 'Brickell Key area with scenic views')
> Raw output: ```json
{
"restaurant": "Mythos Restaurant",
"food": "American fare in a mythic underwater themed spot",
"location": "6000 Universal Blvd, Orlando, FL 32819, United States",
"category": "Restaurant",
"hours": "Open: Closes in 7 hrs, Islands of Adventure",
"price": "$$",
"rating": 4.3,
"review": "Overlooking Universal Studios/Island sea, this mythic underwater themed spot serves American fare.",
"description": "Dine-in, Delivery",
"nearby_tourist_places": "Universal Islands, Jurassic Park River Adventure"
}
```
> Raw output: ```json
{
"restaurant": "Sam's Grill & Seafood Restaurant",
"food": "Seafood",
"location": "374 Bush St, San Francisco, CA 94104, United States",
"category": "Seafood Restaurant",
"hours": "Open ⋅ Closes 8:30 PM",
"price": "$$$",
"rating": 4.4,
"review": "Modern spin-off adjacent Sam's Grill, for seafood, drinks & happy hour loungey digs with a patio.",
"description": "Modern spin-off adjacent Sam's Grill, for seafood, drinks & happy hour loungey digs with a patio.",
"nearby_tourist_places": "Chinatown, San Francisco"
}
```
> Raw output: ```json
{
"restaurant": "Lobster Port",
"food": "Seafood restaurant offering lobster, dim sum & Asian fusion dishes",
"location": "8432 Leslie St, Thornhill, ON L3T 7M6",
"category": "Seafood",
"hours": "Open 10pm",
"price": "$$",
"rating": 4.0,
"review": "Elegant, lively venue with a banquet-hall setup",
"description": "Elegant, lively venue with a banquet-hall setup offering lobster, dim sum & Asian fusion dishes.",
"nearby_tourist_places": "Nearby tourist places are not explicitly listed in the image but the map shows various points of interest in the surrounding area."
}
```


Observation:

  • Gemini 完美生成了我们为 Pydantic 类所需的所有元信息
  • 它还可以从 Google Maps 识别附近的公园Google Maps

第三部分:构建用于餐厅推荐的多模态RAG系统

Section titled “3rd Part: Build Multi-Modal RAG for Restaurant Recommendation”

我们的技术栈包含 Gemini + LlamaIndex + Pydantic 结构化输出功能

构建文本节点以建立向量存储。存储每家餐厅的元数据和描述。

Section titled “Construct Text Nodes for Building Vector Store. Store metadata and description for each restaurant.”
from llama_index.core.schema import TextNode
nodes = []
for res in results:
text_node = TextNode()
metadata = {}
for r in res:
# set description as text of TextNode
if r[0] == "description":
text_node.text = r[1]
else:
metadata[r[0]] = r[1]
text_node.metadata = metadata
nodes.append(text_node)

使用 Gemini 嵌入构建向量存储以实现密集检索。将餐厅索引为节点存入向量存储

Section titled “Using Gemini Embedding for building Vector Store for Dense retrieval. Index Restaurants as nodes into Vector Store”
from llama_index.core import VectorStoreIndex, StorageContext
from llama_index.embeddings.gemini import GeminiEmbedding
from llama_index.llms.gemini import Gemini
from llama_index.vector_stores.qdrant import QdrantVectorStore
from llama_index.core import Settings
from llama_index.core import StorageContext
import qdrant_client
# Create a local Qdrant vector store
client = qdrant_client.QdrantClient(path="qdrant_gemini_3")
vector_store = QdrantVectorStore(client=client, collection_name="collection")
# Using the embedding model to Gemini
Settings.embed_model = GeminiEmbedding(
model_name="models/embedding-001", api_key=GOOGLE_API_KEY
)
Settings.llm = Gemini(api_key=GOOGLE_API_KEY)
storage_context = StorageContext.from_defaults(vector_store=vector_store)
index = VectorStoreIndex(
nodes=nodes,
storage_context=storage_context,
)
query_engine = index.as_query_engine(
similarity_top_k=1,
)
response = query_engine.query(
"recommend a Orlando restaurant for me and its nearby tourist places"
)
print(response)
For a delightful dining experience, I recommend Mythos Restaurant, known for its American cuisine and unique underwater theme. Overlooking Universal Studios' Inland Sea, this restaurant offers a captivating ambiance. After your meal, explore the nearby tourist attractions such as Universal's Islands of Adventure, Skull Island: Reign of Kong, The Wizarding World of Harry Potter, Jurassic Park River Adventure, and Hollywood Rip Ride Rockit, all located near Mythos Restaurant.