![]() |
![]() |
![]() |
Bu hızlı başlangıç kılavuzu, Gemini API için Python SDK'nın nasıl kullanılacağını Google'ın büyük Gemini dil modellerine erişmenizi sağlar. Bu hızlı başlangıç kılavuzunda şunları öğreneceksiniz:
- Gemini'ı kullanmak için geliştirme ortamınızı ve API erişimini ayarlayın.
- Metin girişlerinden metin yanıtları oluşturun.
- Çok modlu girişlerden (metin ve resimler) metin yanıtları oluşturun.
- Çok dönüşlü sohbetler (sohbet) için Gemini'ı kullanın.
- Büyük dil modelleri için yerleştirmeleri kullanın.
Ön koşullar
Bu hızlı başlangıç kılavuzunu Google Colab, Bu not defterini doğrudan tarayıcıda çalıştıran ve yapılandırmalısınız.
Alternatif olarak, bu hızlı başlangıç kılavuzunu yerel olarak tamamlamak için geliştirme şu gereksinimleri karşılamasını sağlar:
- Python 3.9+
- Not defterini çalıştırmak için
jupyter
yüklemesi.
Kurulum
Python SDK'sını yükleyin
Gemini API için Python SDK'sı
google-generativeai
paketi.
Bağımlılığı pip kullanarak yükleyin:
pip install -q -U google-generativeai
Paketleri içe aktarma
Gerekli paketleri içe aktarın.
import pathlib
import textwrap
import google.generativeai as genai
from IPython.display import display
from IPython.display import Markdown
def to_markdown(text):
text = text.replace('•', ' *')
return Markdown(textwrap.indent(text, '> ', predicate=lambda _: True))
# Used to securely store your API key
from google.colab import userdata
API anahtarınızı oluşturun
Gemini API'yi kullanabilmek için önce bir API anahtarı edinmeniz gerekir. Şu durumda: yoksa Google AI Studio'da tek tıklamayla anahtar oluşturun.
Colab'de, anahtarı "🔑" bölümünün altında gizli anahtar yöneticisine ekleyin tıklayın.
GOOGLE_API_KEY
adını verin.
API anahtarınızı aldıktan sonra SDK'ya iletin. Bunu iki şekilde yapabilirsiniz:
- Anahtarı,
GOOGLE_API_KEY
ortam değişkenine yerleştirin (SDK, otomatik olarak oradan teslim alır). - Anahtarı
genai.configure(api_key=...)
adlı cihaza geçirin
# Or use `os.getenv('GOOGLE_API_KEY')` to fetch an environment variable.
GOOGLE_API_KEY=userdata.get('GOOGLE_API_KEY')
genai.configure(api_key=GOOGLE_API_KEY)
Modelleri listeleyin
Artık Gemini API'yi çağırmaya hazırsınız. Mevcut öğeleri görmek için list_models
kullanın
Gemini modelleri:
gemini-1.5-flash
: en hızlı çok modlu modelimizgemini-1.5-pro
: en yetenekli ve akıllı çok modlu modelimiz
for m in genai.list_models():
if 'generateContent' in m.supported_generation_methods:
print(m.name)
Metin girişlerinden metin oluşturun
Yalnızca metin içeren istemler için Gemini 1.5 modelini veya Gemini 1.0 Pro modelini kullanın:
model = genai.GenerativeModel('gemini-1.5-flash')
generate_content
yöntemi, aşağıdakiler de dahil olmak üzere çok çeşitli kullanım alanlarını ele alabilir:
kullanılan modele bağlı olarak, birden çok dönüşlü sohbet ve çok modlu giriş
destekler. Kullanılabilir modeller giriş olarak yalnızca metin ve resimleri ve metin destekler
çıkış olarak kullanabilirsiniz.
En basit senaryoda, bir komut dizesini
GenerativeModel.generate_content
yöntem:
%%time
response = model.generate_content("What is the meaning of life?")
CPU times: user 110 ms, sys: 12.3 ms, total: 123 ms Wall time: 8.25 s
Basit durumlarda tek ihtiyacınız response.text
erişimcisidir. Göstermek için
biçimlendirilmiş Markdown metni için to_markdown
işlevini kullanın:
to_markdown(response.text)
The query of life's purpose has perplexed people across centuries, cultures, and continents. While there is no universally recognized response, many ideas have been put forth, and the response is frequently dependent on individual ideas, beliefs, and life experiences. 1. **Happiness and Well-being:** Many individuals believe that the goal of life is to attain personal happiness and well-being. This might entail locating pursuits that provide joy, establishing significant connections, caring for one's physical and mental health, and pursuing personal goals and interests. 2. **Meaningful Contribution:** Some believe that the purpose of life is to make a meaningful contribution to the world. This might entail pursuing a profession that benefits others, engaging in volunteer or charitable activities, generating art or literature, or inventing. 3. **Self-realization and Personal Growth:** The pursuit of self-realization and personal development is another common goal in life. This might entail learning new skills, pushing one's boundaries, confronting personal obstacles, and evolving as a person. 4. **Ethical and Moral Behavior:** Some believe that the goal of life is to act ethically and morally. This might entail adhering to one's moral principles, doing the right thing even when it is difficult, and attempting to make the world a better place. 5. **Spiritual Fulfillment:** For some, the purpose of life is connected to spiritual or religious beliefs. This might entail seeking a connection with a higher power, practicing religious rituals, or following spiritual teachings. 6. **Experiencing Life to the Fullest:** Some individuals believe that the goal of life is to experience all that it has to offer. This might entail traveling, trying new things, taking risks, and embracing new encounters. 7. **Legacy and Impact:** Others believe that the purpose of life is to leave a lasting legacy and impact on the world. This might entail accomplishing something noteworthy, being remembered for one's contributions, or inspiring and motivating others. 8. **Finding Balance and Harmony:** For some, the purpose of life is to find balance and harmony in all aspects of their lives. This might entail juggling personal, professional, and social obligations, seeking inner peace and contentment, and living a life that is in accordance with one's values and beliefs. Ultimately, the meaning of life is a personal journey, and different individuals may discover their own unique purpose through their experiences, reflections, and interactions with the world around them.
API bir sonuç döndüremezse şunu kullanın:
GenerateContentResponse.prompt_feedback
isteyerek güvenlik endişeleri nedeniyle engellenip engellenmediğini kontrol edin.
response.prompt_feedback
safety_ratings { category: HARM_CATEGORY_SEXUALLY_EXPLICIT probability: NEGLIGIBLE } safety_ratings { category: HARM_CATEGORY_HATE_SPEECH probability: NEGLIGIBLE } safety_ratings { category: HARM_CATEGORY_HARASSMENT probability: NEGLIGIBLE } safety_ratings { category: HARM_CATEGORY_DANGEROUS_CONTENT probability: NEGLIGIBLE }
Gemini, tek bir istem için birden fazla olası yanıt üretebilir. Bu
olası yanıtlar candidates
adı verilir ve seçmek için bunları inceleyebilirsiniz
ve en uygun olanı seçmeye çalışın.
Şununla yanıt adaylarını görüntüleyin:
GenerateContentResponse.candidates
:
response.candidates
[ content { parts { text: "The query of life\'s purpose has perplexed people across centuries, cultures, and continents. While there is no universally recognized response, many ideas have been put forth, and the response is frequently dependent on individual ideas, beliefs, and life experiences.\n\n1. **Happiness and Well-being:** Many individuals believe that the goal of life is to attain personal happiness and well-being. This might entail locating pursuits that provide joy, establishing significant connections, caring for one\'s physical and mental health, and pursuing personal goals and interests.\n\n2. **Meaningful Contribution:** Some believe that the purpose of life is to make a meaningful contribution to the world. This might entail pursuing a profession that benefits others, engaging in volunteer or charitable activities, generating art or literature, or inventing.\n\n3. **Self-realization and Personal Growth:** The pursuit of self-realization and personal development is another common goal in life. This might entail learning new skills, pushing one\'s boundaries, confronting personal obstacles, and evolving as a person.\n\n4. **Ethical and Moral Behavior:** Some believe that the goal of life is to act ethically and morally. This might entail adhering to one\'s moral principles, doing the right thing even when it is difficult, and attempting to make the world a better place.\n\n5. **Spiritual Fulfillment:** For some, the purpose of life is connected to spiritual or religious beliefs. This might entail seeking a connection with a higher power, practicing religious rituals, or following spiritual teachings.\n\n6. **Experiencing Life to the Fullest:** Some individuals believe that the goal of life is to experience all that it has to offer. This might entail traveling, trying new things, taking risks, and embracing new encounters.\n\n7. **Legacy and Impact:** Others believe that the purpose of life is to leave a lasting legacy and impact on the world. This might entail accomplishing something noteworthy, being remembered for one\'s contributions, or inspiring and motivating others.\n\n8. **Finding Balance and Harmony:** For some, the purpose of life is to find balance and harmony in all aspects of their lives. This might entail juggling personal, professional, and social obligations, seeking inner peace and contentment, and living a life that is in accordance with one\'s values and beliefs.\n\nUltimately, the meaning of life is a personal journey, and different individuals may discover their own unique purpose through their experiences, reflections, and interactions with the world around them." } role: "model" } finish_reason: STOP index: 0 safety_ratings { category: HARM_CATEGORY_SEXUALLY_EXPLICIT probability: NEGLIGIBLE } safety_ratings { category: HARM_CATEGORY_HATE_SPEECH probability: NEGLIGIBLE } safety_ratings { category: HARM_CATEGORY_HARASSMENT probability: NEGLIGIBLE } safety_ratings { category: HARM_CATEGORY_DANGEROUS_CONTENT probability: NEGLIGIBLE } ]
Varsayılan olarak model, oluşturma işleminin tamamını tamamladıktan sonra bir yanıt döndürür. bahsedeceğim. Ayrıca yanıtı oluşturuldukça akış olarak yayınlayabilirsiniz. modeli, oluşturulduktan hemen sonra yanıt parçalarını döndürecektir.
Yanıtları akış şeklinde sunmak için GenerativeModel.generate_content(...,
stream=True)
simgesini kullanın.
%%time
response = model.generate_content("What is the meaning of life?", stream=True)
CPU times: user 102 ms, sys: 25.1 ms, total: 128 ms Wall time: 7.94 s
for chunk in response:
print(chunk.text)
print("_"*80)
The query of life's purpose has perplexed people across centuries, cultures, and ________________________________________________________________________________ continents. While there is no universally recognized response, many ideas have been put forth, and the response is frequently dependent on individual ideas, beliefs, and life experiences ________________________________________________________________________________ . 1. **Happiness and Well-being:** Many individuals believe that the goal of life is to attain personal happiness and well-being. This might entail locating pursuits that provide joy, establishing significant connections, caring for one's physical and mental health, and pursuing personal goals and aspirations. 2. **Meaning ________________________________________________________________________________ ful Contribution:** Some believe that the purpose of life is to make a meaningful contribution to the world. This might entail pursuing a profession that benefits others, engaging in volunteer or charitable activities, generating art or literature, or inventing. 3. **Self-realization and Personal Growth:** The pursuit of self-realization and personal development is another common goal in life. This might entail learning new skills, exploring one's interests and abilities, overcoming obstacles, and becoming the best version of oneself. 4. **Connection and Relationships:** For many individuals, the purpose of life is found in their relationships with others. This might entail building ________________________________________________________________________________ strong bonds with family and friends, fostering a sense of community, and contributing to the well-being of those around them. 5. **Spiritual Fulfillment:** For those with religious or spiritual beliefs, the purpose of life may be centered on seeking spiritual fulfillment or enlightenment. This might entail following religious teachings, engaging in spiritual practices, or seeking a deeper understanding of the divine. 6. **Experiencing the Journey:** Some believe that the purpose of life is simply to experience the journey itself, with all its joys and sorrows. This perspective emphasizes embracing the present moment, appreciating life's experiences, and finding meaning in the act of living itself. 7. **Legacy and Impact:** For others, the goal of life is to leave a lasting legacy or impact on the world. This might entail making a significant contribution to a particular field, leaving a positive mark on future generations, or creating something that will be remembered and cherished long after one's lifetime. Ultimately, the meaning of life is a personal and subjective question, and there is no single, universally accepted answer. It is about discovering what brings you fulfillment, purpose, and meaning in your own life, and living in accordance with those values. ________________________________________________________________________________
Akış sırasında, bazı yanıt özellikleri siz yineleme yapana kadar kullanılamaz tüm yanıt parçalarını bir araya getirir. Bu, aşağıda gösterilmiştir:
response = model.generate_content("What is the meaning of life?", stream=True)
prompt_feedback
özelliği çalışır:
response.prompt_feedback
safety_ratings { category: HARM_CATEGORY_SEXUALLY_EXPLICIT probability: NEGLIGIBLE } safety_ratings { category: HARM_CATEGORY_HATE_SPEECH probability: NEGLIGIBLE } safety_ratings { category: HARM_CATEGORY_HARASSMENT probability: NEGLIGIBLE } safety_ratings { category: HARM_CATEGORY_DANGEROUS_CONTENT probability: NEGLIGIBLE }
Ancak text
gibi özellikler şunları yapmaz:
try:
response.text
except Exception as e:
print(f'{type(e).__name__}: {e}')
IncompleteIterationError: Please let the response complete iteration before accessing the final accumulated attributes (or call `response.resolve()`)
Resim ve metin girişlerinden metin oluşturun
Gemini, çok modlu girişleri işleyebilen çeşitli modeller sunar (Gemini 1.5 hem metin hem de resim girmenizi sağlar. Şurayı incelemeyi unutmayın: istemler için resim gereksinimleri.
İstem girişi hem metin hem de resim içerdiğinde
Metin çıkışı oluşturmak için GenerativeModel.generate_content
yöntemi:
Bir resim ekleyelim:
curl -o image.jpg https://t0.gstatic.com/licensed-image?q=tbn:ANd9GcQ_Kevbk21QBRy-PgB4kQpS79brbmmEG7m3VOTShAn4PecDU5H5UxrJxE3Dw1JiaG17V88QIol19-3TM2wCHw
% Total % Received % Xferd Average Speed Time Time Time Current Dload Upload Total Spent Left Speed 0 0 0 0 0 0 0 0 --:--:-- --:--:-- --:--:-- 0 100 405k 100 405k 0 0 6982k 0 --:--:-- --:--:-- --:--:-- 7106k
import PIL.Image
img = PIL.Image.open('image.jpg')
img
Gemini 1.5 modelini kullanın ve resmi generate_content
ile modele iletin.
model = genai.GenerativeModel('gemini-1.5-flash')
response = model.generate_content(img)
to_markdown(response.text)
Chicken Teriyaki Meal Prep Bowls with brown rice, roasted broccoli and bell peppers.
Bir istemde hem metin hem de resim sağlamak için dizeleri içeren bir liste iletin ve resimler:
response = model.generate_content(["Write a short, engaging blog post based on this picture. It should include a description of the meal in the photo and talk about my journey meal prepping.", img], stream=True)
response.resolve()
to_markdown(response.text)
Meal prepping is a great way to save time and money, and it can also help you to eat healthier. This meal is a great example of a healthy and delicious meal that can be easily prepped ahead of time. This meal features brown rice, roasted vegetables, and chicken teriyaki. The brown rice is a whole grain that is high in fiber and nutrients. The roasted vegetables are a great way to get your daily dose of vitamins and minerals. And the chicken teriyaki is a lean protein source that is also packed with flavor. This meal is easy to prepare ahead of time. Simply cook the brown rice, roast the vegetables, and cook the chicken teriyaki. Then, divide the meal into individual containers and store them in the refrigerator. When you're ready to eat, simply grab a container and heat it up. This meal is a great option for busy people who are looking for a healthy and delicious way to eat. It's also a great meal for those who are trying to lose weight or maintain a healthy weight. If you're looking for a healthy and delicious meal that can be easily prepped ahead of time, this meal is a great option. Give it a try today!
Sohbet görüşmeleri
Gemini, birden fazla kez serbest biçimli sohbetler yapmanızı sağlar. İlgili içeriği oluşturmak için kullanılan
ChatSession
sınıfı,
Bu nedenle, generate_content
ürününün aksine, depoladığınız
liste halinde takip edin.
Sohbeti başlatın:
model = genai.GenerativeModel('gemini-1.5-flash')
chat = model.start_chat(history=[])
chat
<google.generativeai.generative_models.ChatSession at 0x7b7b68250100>
İlgili içeriği oluşturmak için kullanılan
ChatSession.send_message
yöntemi, şununla aynı GenerateContentResponse
türünü döndürür:
GenerativeModel.generate_content
.
Ayrıca, iletiniz ve yanıtınız sohbet geçmişine eklenir:
response = chat.send_message("In one sentence, explain how a computer works to a young child.")
to_markdown(response.text)
A computer is like a very smart machine that can understand and follow our instructions, help us with our work, and even play games with us!
chat.history
[ parts { text: "In one sentence, explain how a computer works to a young child." } role: "user", parts { text: "A computer is like a very smart machine that can understand and follow our instructions, help us with our work, and even play games with us!" } role: "model" ]
Görüşmeyi sürdürmek için mesaj göndermeye devam edebilirsiniz. Şunu kullanın:
Sohbeti yayınlamak için stream=True
bağımsız değişken:
response = chat.send_message("Okay, how about a more detailed explanation to a high schooler?", stream=True)
for chunk in response:
print(chunk.text)
print("_"*80)
A computer works by following instructions, called a program, which tells it what to ________________________________________________________________________________ do. These instructions are written in a special language that the computer can understand, and they are stored in the computer's memory. The computer's processor ________________________________________________________________________________ , or CPU, reads the instructions from memory and carries them out, performing calculations and making decisions based on the program's logic. The results of these calculations and decisions are then displayed on the computer's screen or stored in memory for later use. To give you a simple analogy, imagine a computer as a ________________________________________________________________________________ chef following a recipe. The recipe is like the program, and the chef's actions are like the instructions the computer follows. The chef reads the recipe (the program) and performs actions like gathering ingredients (fetching data from memory), mixing them together (performing calculations), and cooking them (processing data). The final dish (the output) is then presented on a plate (the computer screen). In summary, a computer works by executing a series of instructions, stored in its memory, to perform calculations, make decisions, and display or store the results. ________________________________________________________________________________
glm.Content
nesne, her biri şunları içeren glm.Part
nesne listesi içeriyor:
bir metin (dize) veya satır içi_veriler (glm.Blob
) (bu örnekte bir blob ikili program içerir)
verileri ve mime_type
. Sohbet geçmişi, glm.Content
listesi olarak mevcut.
şunun içindeki nesneler:
ChatSession.history
:
for message in chat.history:
display(to_markdown(f'**{message.role}**: {message.parts[0].text}'))
**user**: In one sentence, explain how a computer works to a young child. **model**: A computer is like a very smart machine that can understand and follow our instructions, help us with our work, and even play games with us! **user**: Okay, how about a more detailed explanation to a high schooler? **model**: A computer works by following instructions, called a program, which tells it what to do. These instructions are written in a special language that the computer can understand, and they are stored in the computer's memory. The computer's processor, or CPU, reads the instructions from memory and carries them out, performing calculations and making decisions based on the program's logic. The results of these calculations and decisions are then displayed on the computer's screen or stored in memory for later use. To give you a simple analogy, imagine a computer as a chef following a recipe. The recipe is like the program, and the chef's actions are like the instructions the computer follows. The chef reads the recipe (the program) and performs actions like gathering ingredients (fetching data from memory), mixing them together (performing calculations), and cooking them (processing data). The final dish (the output) is then presented on a plate (the computer screen). In summary, a computer works by executing a series of instructions, stored in its memory, to perform calculations, make decisions, and display or store the results.
Jetonları say
Büyük dil modellerinde bir bağlam penceresi bulunur ve bağlam uzunluğu genellikle
jeton sayısı ile ölçülür. Gemini API ile şunları yapabilirsiniz:
herhangi bir genai.protos.Content
nesnesindeki jeton sayısını belirler.
Örneğin, bir sorgu dizesini
GenerativeModel.count_tokens
yöntemini kullanın:
model.count_tokens("What is the meaning of life?")
total_tokens: 7
Benzer şekilde, ChatSession
için token_count
kontrol edebilirsiniz:
model.count_tokens(chat.history)
total_tokens: 501
Yerleştirmeleri kullanma
Yerleştirme Bilgiyi kayan nokta sayılarından oluşan bir liste olarak sunmak için kullanılan bir tekniktir hesaplamanız gerekir. Gemini ile metinleri (kelimeler, cümleler ve bloklar) kullanarak, karşılaştırmayı ve kontrastı daha kolay hale getirir. yerleştirme. Örneğin, aynı konuyu paylaşan iki metin yaklaşımın benzer yerleştirmelere sahip olması gerekir. kosinüs benzerliği gibi matematiksel karşılaştırma tekniklerini kullanır. Proje yönetiminin ve neden yerleştirmeleri kullanmanız gerektiği hakkında daha fazla bilgi için Yerleştirmeler rehberini inceleyin.
Yerleştirmeleri oluşturmak için embed_content
yöntemini kullanın. Yöntemde
yerleştirme (task_type
):
Görev Türü | Açıklama |
---|---|
RETRIEVAL_QUERY | Belirtilen metnin, arama/alma ayarındaki bir sorgu olduğunu belirtir. |
RETRIEVAL_DOCUMENT | Belirtilen metnin, arama/alma ayarındaki bir doküman olduğunu belirtir. Bu görev türünü kullanmak için title gereklidir. |
SEMANTIC_SIMILARITY | Belirtilen metnin Semantik Metin Benzerliği (STS) için kullanılacağını belirtir. |
SINIFLANDIRMA | Yerleştirmelerin sınıflandırma için kullanılacağını belirtir. |
KÜMELEME | Yerleştirmelerin kümeleme için kullanılacağını belirtir. |
Aşağıda, belge almak amacıyla tek bir dize için bir yerleştirme oluşturulur:
result = genai.embed_content(
model="models/embedding-001",
content="What is the meaning of life?",
task_type="retrieval_document",
title="Embedding of single string")
# 1 input > 1 vector output
print(str(result['embedding'])[:50], '... TRIMMED]')
[-0.003216741, -0.013358698, -0.017649598, -0.0091 ... TRIMMED]
Dize gruplarını işlemek için content
içindeki dizelerin listesini iletin:
result = genai.embed_content(
model="models/embedding-001",
content=[
'What is the meaning of life?',
'How much wood would a woodchuck chuck?',
'How does the brain work?'],
task_type="retrieval_document",
title="Embedding of list of strings")
# A list of inputs > A list of vectors output
for v in result['embedding']:
print(str(v)[:50], '... TRIMMED ...')
[0.0040260437, 0.004124458, -0.014209415, -0.00183 ... TRIMMED ... [-0.004049845, -0.0075574904, -0.0073463684, -0.03 ... TRIMMED ... [0.025310587, -0.0080734305, -0.029902633, 0.01160 ... TRIMMED ...
genai.embed_content
işlevi, dizeleri veya dize listelerini kabul eder.
aslında genai.protos.Content
türü etrafında oluşturulmuştur (ör.
GenerativeModel.generate_content
) seçin.
glm.Content
nesneleri, API'deki birincil sohbet birimleridir.
genai.protos.Content
nesnesi çok modlu olsa da embed_content
yöntemi yalnızca metin yerleştirmeleri destekler. Bu tasarım API'ye
possibility ile çok modlu yerleştirmelere genişletebilirsiniz.
response.candidates[0].content
parts { text: "A computer works by following instructions, called a program, which tells it what to do. These instructions are written in a special language that the computer can understand, and they are stored in the computer\'s memory. The computer\'s processor, or CPU, reads the instructions from memory and carries them out, performing calculations and making decisions based on the program\'s logic. The results of these calculations and decisions are then displayed on the computer\'s screen or stored in memory for later use.\n\nTo give you a simple analogy, imagine a computer as a chef following a recipe. The recipe is like the program, and the chef\'s actions are like the instructions the computer follows. The chef reads the recipe (the program) and performs actions like gathering ingredients (fetching data from memory), mixing them together (performing calculations), and cooking them (processing data). The final dish (the output) is then presented on a plate (the computer screen).\n\nIn summary, a computer works by executing a series of instructions, stored in its memory, to perform calculations, make decisions, and display or store the results." } role: "model"
result = genai.embed_content(
model = 'models/embedding-001',
content = response.candidates[0].content)
# 1 input > 1 vector output
print(str(result['embedding'])[:50], '... TRIMMED ...')
[-0.013921871, -0.03504407, -0.0051786783, 0.03113 ... TRIMMED ...
Benzer şekilde, sohbet geçmişi genai.protos.Content
nesnelerinden oluşan bir liste içerir.
embed_content
işlevine doğrudan iletebilirsiniz:
chat.history
[ parts { text: "In one sentence, explain how a computer works to a young child." } role: "user", parts { text: "A computer is like a very smart machine that can understand and follow our instructions, help us with our work, and even play games with us!" } role: "model", parts { text: "Okay, how about a more detailed explanation to a high schooler?" } role: "user", parts { text: "A computer works by following instructions, called a program, which tells it what to do. These instructions are written in a special language that the computer can understand, and they are stored in the computer\'s memory. The computer\'s processor, or CPU, reads the instructions from memory and carries them out, performing calculations and making decisions based on the program\'s logic. The results of these calculations and decisions are then displayed on the computer\'s screen or stored in memory for later use.\n\nTo give you a simple analogy, imagine a computer as a chef following a recipe. The recipe is like the program, and the chef\'s actions are like the instructions the computer follows. The chef reads the recipe (the program) and performs actions like gathering ingredients (fetching data from memory), mixing them together (performing calculations), and cooking them (processing data). The final dish (the output) is then presented on a plate (the computer screen).\n\nIn summary, a computer works by executing a series of instructions, stored in its memory, to perform calculations, make decisions, and display or store the results." } role: "model" ]
result = genai.embed_content(
model = 'models/embedding-001',
content = chat.history)
# 1 input > 1 vector output
for i,v in enumerate(result['embedding']):
print(str(v)[:50], '... TRIMMED...')
[-0.014632266, -0.042202696, -0.015757175, 0.01548 ... TRIMMED... [-0.010979066, -0.024494737, 0.0092659835, 0.00803 ... TRIMMED... [-0.010055617, -0.07208932, -0.00011750793, -0.023 ... TRIMMED... [-0.013921871, -0.03504407, -0.0051786783, 0.03113 ... TRIMMED...
Gelişmiş kullanım alanları
Aşağıdaki bölümlerde, projenizin gelişmiş kullanım alanları ve Gemini API için Python SDK'sı.
Güvenlik ayarları
safety_settings
bağımsız değişkeni, modelin neleri engelleyeceğini ve
hem istemlere hem de yanıtlara izin verir. Varsayılan olarak güvenlik ayarları içerikleri engeller.
içerik genelinde güvenli olmayan içerik olma olasılığı orta ve/veya yüksek
seçin. Güvenlik hakkında daha fazla bilgi edinin
Ayarlar'da bulabilirsiniz.
Şüpheli bir istem girip modeli varsayılan güvenlik ayarlarıyla çalıştırın. ve hiçbir aday döndürmez:
response = model.generate_content('[Questionable prompt here]')
response.candidates
[ content { parts { text: "I\'m sorry, but this prompt involves a sensitive topic and I\'m not allowed to generate responses that are potentially harmful or inappropriate." } role: "model" } finish_reason: STOP index: 0 safety_ratings { category: HARM_CATEGORY_SEXUALLY_EXPLICIT probability: NEGLIGIBLE } safety_ratings { category: HARM_CATEGORY_HATE_SPEECH probability: NEGLIGIBLE } safety_ratings { category: HARM_CATEGORY_HARASSMENT probability: NEGLIGIBLE } safety_ratings { category: HARM_CATEGORY_DANGEROUS_CONTENT probability: NEGLIGIBLE } ]
prompt_feedback
, istemi hangi güvenlik filtresinin engellediğini söyler:
response.prompt_feedback
safety_ratings { category: HARM_CATEGORY_SEXUALLY_EXPLICIT probability: NEGLIGIBLE } safety_ratings { category: HARM_CATEGORY_HATE_SPEECH probability: NEGLIGIBLE } safety_ratings { category: HARM_CATEGORY_HARASSMENT probability: NEGLIGIBLE } safety_ratings { category: HARM_CATEGORY_DANGEROUS_CONTENT probability: NEGLIGIBLE }
Şimdi aynı istemi güvenlik ayarlarıyla modele sunun. sorunuza yanıt alabilirsiniz.
response = model.generate_content('[Questionable prompt here]',
safety_settings={'HARASSMENT':'block_none'})
response.text
Ayrıca her adayın kendi safety_ratings
bilgisinin (isteme göre) olduğunu unutmayın.
başarılı olur ancak bireysel yanıtlar güvenlik kontrollerini geçemez.
Mesajları kodlama
Önceki bölümlerde, istem göndermenizi kolaylaştırmak için SDK kullanılıyordu. bağlantı kurmalısınız. Bu bölüm, öncekine ait tamamen yazılmış bir eşdeğeri sunar Böylece, teklifin ne kadar önemli olduğuna ilişkin alt düzey SDK, mesajları kodlar.
SDK, mesajınızı genai.protos.Content
nesnesine dönüştürmeye çalışır.
Her biri şunlardan birini içeren genai.protos.Part
nesnenin listesini içerir:
- bir
text
(dize) inline_data
(genai.protos.Blob
); burada bir blob,data
vemime_type
.- veya diğer veri türlerini kapsar.
Ayrıca, bu sınıfların herhangi birini eşdeğer bir sözlük olarak da iletebilirsiniz.
Bu nedenle, önceki örnekteki tamamen yazılan eşdeğeri şu şekildedir:
model = genai.GenerativeModel('gemini-1.5-flash')
response = model.generate_content(
genai.protos.Content(
parts = [
genai.protos.Part(text="Write a short, engaging blog post based on this picture."),
genai.protos.Part(
inline_data=genai.protos.Blob(
mime_type='image/jpeg',
data=pathlib.Path('image.jpg').read_bytes()
)
),
],
),
stream=True)
response.resolve()
to_markdown(response.text[:100] + "... [TRIMMED] ...")
Meal prepping is a great way to save time and money, and it can also help you to eat healthier. By ... [TRIMMED] ...
Birden çok dönüşlü görüşmeler
Daha önce gösterilen genai.ChatSession
sınıfı birçok kullanım alanını işleyebilir ancak
varsayımlarda bulunmaktır. Kullanım alanınız bu sohbete uymuyorsa
uygulanması durumunda, genai.ChatSession
değerinin yalnızca bir sarmalayıcı olduğunu
yaklaşık
GenerativeModel.generate_content
Tekli isteklere ek olarak birden çok dönüşlü konuşmaları da işleyebilir.
Tek tek mesajlar genai.protos.Content
nesne veya uyumlu
önceki bölümlerde göründüğü gibi. Sözlük olarak
role
ve parts
anahtarları gerektirir. Bir ileti dizisindeki role
şunlardan biri olabilir:
İstemleri sağlayan user
veya yanıtları sağlayan model
.
genai.protos.Content
nesne içeren bir liste iletirseniz şu şekilde ele alınır:
çok dönüşlü sohbet:
model = genai.GenerativeModel('gemini-1.5-flash')
messages = [
{'role':'user',
'parts': ["Briefly explain how a computer works to a young child."]}
]
response = model.generate_content(messages)
to_markdown(response.text)
Imagine a computer as a really smart friend who can help you with many things. Just like you have a brain to think and learn, a computer has a brain too, called a processor. It's like the boss of the computer, telling it what to do. Inside the computer, there's a special place called memory, which is like a big storage box. It remembers all the things you tell it to do, like opening games or playing videos. When you press buttons on the keyboard or click things on the screen with the mouse, you're sending messages to the computer. These messages travel through special wires, called cables, to the processor. The processor reads the messages and tells the computer what to do. It can open programs, show you pictures, or even play music for you. All the things you see on the screen are created by the graphics card, which is like a magic artist inside the computer. It takes the processor's instructions and turns them into colorful pictures and videos. To save your favorite games, videos, or pictures, the computer uses a special storage space called a hard drive. It's like a giant library where the computer can keep all your precious things safe. And when you want to connect to the internet to play games with friends or watch funny videos, the computer uses something called a network card to send and receive messages through the internet cables or Wi-Fi signals. So, just like your brain helps you learn and play, the computer's processor, memory, graphics card, hard drive, and network card all work together to make your computer a super-smart friend that can help you do amazing things!
Görüşmeyi sürdürmek için yanıtı ve başka bir mesajı ekleyin.
messages.append({'role':'model',
'parts':[response.text]})
messages.append({'role':'user',
'parts':["Okay, how about a more detailed explanation to a high school student?"]})
response = model.generate_content(messages)
to_markdown(response.text)
At its core, a computer is a machine that can be programmed to carry out a set of instructions. It consists of several essential components that work together to process, store, and display information: **1. Processor (CPU):** - The brain of the computer. - Executes instructions and performs calculations. - Speed measured in gigahertz (GHz). - More GHz generally means faster processing. **2. Memory (RAM):** - Temporary storage for data being processed. - Holds instructions and data while the program is running. - Measured in gigabytes (GB). - More GB of RAM allows for more programs to run simultaneously. **3. Storage (HDD/SSD):** - Permanent storage for data. - Stores operating system, programs, and user files. - Measured in gigabytes (GB) or terabytes (TB). - Hard disk drives (HDDs) are traditional, slower, and cheaper. - Solid-state drives (SSDs) are newer, faster, and more expensive. **4. Graphics Card (GPU):** - Processes and displays images. - Essential for gaming, video editing, and other graphics-intensive tasks. - Measured in video RAM (VRAM) and clock speed. **5. Motherboard:** - Connects all the components. - Provides power and communication pathways. **6. Input/Output (I/O) Devices:** - Allow the user to interact with the computer. - Examples: keyboard, mouse, monitor, printer. **7. Operating System (OS):** - Software that manages the computer's resources. - Provides a user interface and basic functionality. - Examples: Windows, macOS, Linux. When you run a program on your computer, the following happens: 1. The program instructions are loaded from storage into memory. 2. The processor reads the instructions from memory and executes them one by one. 3. If the instruction involves calculations, the processor performs them using its arithmetic logic unit (ALU). 4. If the instruction involves data, the processor reads or writes to memory. 5. The results of the calculations or data manipulation are stored in memory. 6. If the program needs to display something on the screen, it sends the necessary data to the graphics card. 7. The graphics card processes the data and sends it to the monitor, which displays it. This process continues until the program has completed its task or the user terminates it.
Oluşturma yapılandırması
generation_config
bağımsız değişkeni, oluşturma parametrelerini değiştirmenize olanak tanır.
Modele gönderdiğiniz her istem,
model de yanıtlar oluşturur.
model = genai.GenerativeModel('gemini-1.5-flash')
response = model.generate_content(
'Tell me a story about a magic backpack.',
generation_config=genai.types.GenerationConfig(
# Only one candidate for now.
candidate_count=1,
stop_sequences=['x'],
max_output_tokens=20,
temperature=1.0)
)
text = response.text
if response.candidates[0].finish_reason.name == "MAX_TOKENS":
text += '...'
to_markdown(text)
Once upon a time, in a small town nestled amidst lush green hills, lived a young girl named...
Sırada ne var?
- İstem tasarımı, istenen sonuca ulaştıran istemleri oluşturma sürecidir temel yanıtları oluşturuyor. İyi yapılandırılmış istemler yazmak, bir dilden doğru ve yüksek kaliteli yanıtlar sağlamanın önemli bir parçasıdır. modeli. İstemle ilgili en iyi uygulamalar hakkında bilgi edinin yazma bölümüne bakın.
- Gemini, farklı kullanım ihtiyaçlarını karşılamak için çeşitli model varyasyonları sunar. (ör. giriş türleri ve karmaşıklık, sohbet ya da diğer iletişim ve boyut kısıtlamalarına sahip olabilirsiniz. Mevcut Gemini modelleri.