ruby amazon bedrock

روبي أمازون بيدروك

التكامل السلس مع Amazon Bedrock API لإنشاء النصوص والصور المدعومة بالذكاء الاصطناعي في روبي؟ +؟. واجهة برمجة تطبيقات أمازون بيدروك.

Amazon Bedrock هي خدمة مُدارة بالكامل تجعل FMs من الشركات الناشئة الرائدة في مجال الذكاء الاصطناعي وAmazon متاحة عبر واجهة برمجة التطبيقات، بحيث يمكنك الاختيار من بين مجموعة واسعة من FMs للعثور على النموذج الأكثر ملاءمة لحالة الاستخدام الخاصة بك.

تثبيت

المجمع

أضف السطر التالي إلى Gemfile الخاص بالتطبيق الخاص بك:

 gem "ruby-amazon-bedrock" , "~> 0.2.4"

ومن ثم تنفيذ:

$ bundle install

تثبيت جوهرة

أو التثبيت باستخدام:

$ gem install ruby-amazon-bedrock -v 0.2.4

وتتطلب مع:

 require "amazon_bedrock" 

أوراق اعتماد

لتتمكن من استخدام Amazon Bedrock، ستحتاج إلى بيانات الاعتماد الآمنة الخاصة بك تمامًا مثل أي خدمة AWS أخرى. احصل على مفاتيحك من AWS IAM (إدارة الهوية والوصول) https://us-east-1.console.aws.amazon.com/iam

الوصول إلى النموذج

لاستخدام Bedrock، يجب عليك طلب الوصول إلى FMs الخاص بـ Bedrock. للقيام بذلك، سوف تحتاج إلى الحصول على أذونات IAM الصحيحة. بالنسبة لنماذج معينة، قد تحتاج أولاً إلى إرسال تفاصيل حالة الاستخدام قبل أن تتمكن من طلب الوصول.

تسعير النموذج

انتبه إلى أنه باستخدام ruby-amazon-bedrock Gem بالاشتراك مع Amazon Bedrock، قد تتحمل تكاليف مرتبطة باستخدام خدمات Amazon Bedrock. باعتبارك المستخدم، أنت وحدك المسؤول عن أي وجميع التكاليف التي تنشأ عن استخدامك لـ Amazon Bedrock. يمكنك رؤية المزيد من التفاصيل حول التسعير هنا

بداية سريعة

قم بإنشاء مثيل للعميل عن طريق تمرير بيانات اعتماد AWS IAM الخاصة بك:

 client = RubyAmazonBedrock :: Client . new (
  region : "AWS_REGION" ,
  access_key_id : "AWS_ACCESS_KEY_ID" ,
  secret_access_key : "AWS_SECRET_ACCESS_KEY"
)

أو انسخ .env.sample إلى ملف .env باستخدام بيانات اعتماد حسابك واستخدم متغير ENV . ملاحظة: هذه الخطوة مطلوبة لتشغيل الاختبارات باستخدام rspec

 client = RubyAmazonBedrock :: Client . new (
  region : ENV [ "AWS_REGION" ] ,
  access_key_id : ENV [ "AWS_ACCESS_KEY_ID" ] ,
  secret_access_key : ENV [ "AWS_SECRET_ACCESS_KEY" ]
)

ملفات تعريف AWS المسماة

يمكنك أيضًا استخدام ملفات تعريف AWS المسماة عن طريق تمرير وسيطة لوحة المفاتيح الخاصة profile . عند استخدام ملف تعريف مسمى، لن تكون هناك حاجة إلى تحديد region و access_key_id و access_token .

 client = RubyAmazonBedrock :: Client . new (
  profile : "AWS_PROFILE"
) 

خيارات

تعمل وسيطة الخيارات على تحسين مرونة الطريقة من خلال السماح بتكوينات إضافية خاصة بالنموذج. إذا لم يتم توفيرها بشكل صريح، فستكون الطريقة افتراضية لمجموعة من معلمات النموذج القياسية. يمكنك الاطلاع على مزيد من التفاصيل حول المعلمات الاختيارية للنموذج.

مقدمو النماذج

Amazon Bedrock هي خدمة مُدارة بالكامل تجعل FMs من الشركات الناشئة الرائدة في مجال الذكاء الاصطناعي وAmazon متاحة عبر واجهة برمجة التطبيقات، بحيث يمكنك الاختيار من بين مجموعة واسعة من FMs للعثور على النموذج الأكثر ملاءمة لحالة الاستخدام الخاصة بك.

مختبرات AI21

تستخدم الشركات عائلة AI21's Jurassic التي تضم حاملي شهادات LLM الرائدة لإنشاء تطبيقات وخدمات تعتمد على الذكاء الاصطناعي وتستفيد من البيانات التنظيمية الحالية. يدعم Jurassic حالات الاستخدام عبر الصناعة بما في ذلك إنشاء النصوص الطويلة والقصيرة والإجابة على الأسئلة السياقية والتلخيص والتصنيف. تم تصميم Jurassic لاتباع تعليمات اللغة الطبيعية، وتم تدريبه على مجموعة ضخمة من نصوص الويب ويدعم ست لغات بالإضافة إلى اللغة الإنجليزية. شاهد المزيد...

الخيارات لهذه النماذج هي:

  {
    temperature : 0.5 ,     # float
    max_tokens : 200 ,      # integer
    stop_sequences : [ ] ,   # [string]
    top_p : 0.5 ,           # float
    count_penalty : 0 ,     # integer
    presence_penalty : 0 ,  # integer
    frequency_penalty : 0  # integer
  }

لمزيد من الوثائق حول أنواع بيانات المعلمات وقيمها، يمكنك [راجع المزيد من التفاصيل...] [https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters-jurassic2.html]

كيفية استدعاء نماذج AI21:

الجوراسي-2 الترا

يدعم: الإجابة على أسئلة الكتاب المفتوح، والتلخيص، وإنشاء المسودة، واستخراج المعلومات، والتفكير

اللغات: الإنجليزية، الإسبانية، الفرنسية، الألمانية، البرتغالية، الإيطالية، الهولندية

 client . invoke_model ( id : 'ai21.j2-ultra-v1' , prompt : "What's natural language processing?" , options : { } )

# Response
{ :id => 1234 ,
 :prompt =>
  { :text => "Describe how an LLM works" ,
   :tokens =>
    [ { :generatedToken => { :token => "▁Describe" , :logprob => - 10.674324035644531 , :raw_logprob => - 10.674324035644531 } ,
 :completions =>
  [ { :data =>
    { :text =>
       " n Natural language processing (NLP) is a field of computer science, artificial intelligence, and linguistics concerned with the interactions between computers and human (natural) languages, in particular how to program computers to process and analyze large amounts of natural language data. The goal of NLP is to provide computers with the ability to read, understand, and generate human language." ,
      :tokens =>
       [ { :generatedToken => { :token => "<|newline|>" , :logprob => 0.0 , :raw_logprob => - 0.00046850196667946875 } ,

الجوراسي -2 منتصف

 client . invoke_model ( id : 'ai21.j2-mid-v1' , prompt : "What's GenAI?" , options : { } )

# Response
{ :id => 1234 ,
 :prompt =>
  { :text => "What's GenAI?" ,
   :tokens =>
    [ { :generatedToken => { :token => "▁What's" , :logprob => - 9.553738594055176 , :raw_logprob => - 9.553738594055176 } ,
      :topTokens => nil ,
      :textRange => { :start => 0 , :end => 6 } } ,
 :completions =>
  [ { :data =>
     { :text =>
       " n GenAI is a proposed standard for a generic AI language, which would allow AI systems to communicate and reason with each other in a common language. The goal of GenAI is to create a universal language that can be used by all AI systems, regardless of their specific task or underlying architecture. This would make it easier for AI systems to work together and learn from each other, and it would also make it easier for humans to interact with and understand AI systems." ,
      :tokens =>
       [ { :generatedToken => { :token => "<|newline|>" , :logprob => 0.0 , :raw_logprob => - 0.0009662011871114373 } ,

أمازون تيتان

يتم تدريب نماذج Amazon Titan Foundation مسبقًا على مجموعات البيانات الكبيرة، مما يجعلها نماذج قوية ذات أغراض عامة. استخدمها كما هي، أو قم بتخصيصها عن طريق ضبط النماذج ببياناتك الخاصة لمهمة معينة دون إضافة تعليقات توضيحية إلى كميات كبيرة من البيانات. شاهد المزيد...

الخيارات لهذه النماذج هي:

  {
    temperature : 0.5 ,   # float
    top_p : 0.5 ,         # float
    max_tokens : 512 ,    # integer
    stop_sequences : [ ]  # [string]
  }

لمزيد من الوثائق حول أنواع بيانات المعلمات وقيمها، يمكنك [راجع المزيد من التفاصيل...] [https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters-titan-text.html]

كيفية الاتصال بنماذج Amazon Titan النصية:

تيتان نص G1 - لايت

https://us-east-1.console.aws.amazon.com/bedrock/home?region=us-east-1#/providers?model=amazon.titan-text-lite-v1

الدعم: إنشاء النص، إنشاء التعليمات البرمجية، تنسيق النص الغني، التنسيق (الوكلاء)، الضبط الدقيق.

 client . invoke_model ( id : 'amazon.titan-text-lite-v1' , prompt : 'Generate a story about rubies and gems' , options : { } )

# Response
{ :inputTextTokenCount => 8 ,
 :results =>
  [ { :tokenCount => 294 ,
    :outputText =>
     " n Once upon a time, there was a king who was very fond of rubies and gems. He had a collection of the most beautiful rubies and gems ..." ,
    :completionReason => "FINISH" } ] }

تيتان نص G1-اكسبرس

https://us-east-1.console.aws.amazon.com/bedrock/home?region=us-east-1#/providers?model=amazon.titan-text-express-v1

 client . invoke_model ( id : 'amazon.titan-text-express-v1' , prompt : 'Generate a post about cats formatted with HTML tags' , options : { } )

# Response
{ :inputTextTokenCount => 9 ,
 :results =>
  [ { :tokenCount => 330 ,
    :outputText =>
     " n <h1>Cats</h1> n n Cats are small, furry, carnivorous mammals that are loved by many people around the world. They come in a variety of colors, shapes, and sizes, and have unique personalities that make them great companions. n n " ,
    :completionReason => "FINISH" } ] }

الدعم: إنشاء النص، إنشاء التعليمات البرمجية، تنسيق النص الغني، التنسيق (الوكلاء)، الضبط الدقيق

أنثروبي

تقدم Anthropic مجموعة Claude من نماذج اللغات الكبيرة المصممة خصيصًا للمحادثات والتلخيص والأسئلة والأجوبة وأتمتة سير العمل والبرمجة والمزيد. أفاد العملاء الأوائل أن كلود من غير المرجح أن ينتج مخرجات ضارة، وأسهل في التحدث معه، وأكثر قابلية للتوجيه - حتى تتمكن من الحصول على المخرجات المطلوبة بجهد أقل. يستطيع كلود أيضًا توجيه الأمور المتعلقة بالشخصية والنبرة والسلوك.

الخيارات لهذه النماذج هي:

  {
    temperature : 0.3 ,   # float
    top_p : 0.5 ,         # float
    top_k : 0.5 ,         # float
    max_tokens : 1000 ,   # integer
    stop_sequences : [ ]  # [string]
  }

لمزيد من الوثائق حول أنواع بيانات المعلمات وقيمها، يمكنك [راجع المزيد من التفاصيل...] [https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters-claude.html]

كيفية استدعاء النماذج الأنثروبولوجية:

كلود فوري 1.2

https://us-east-1.console.aws.amazon.com/bedrock/home?region=us-east-1#/providers?model=anthropic.claude-instant-v1

يدعم: الإجابة على الأسئلة، واستخراج المعلومات، وإزالة معلومات تحديد الهوية الشخصية، وإنشاء المحتوى، وتصنيف الاختيارات المتعددة، ولعب الأدوار، ومقارنة النص، والتلخيص، وتوثيق الأسئلة والأجوبة مع الاقتباس

 client . invoke_model ( id : 'anthropic.claude-instant-v1' , prompt : 'What is a neural network?' )

# Response
{ :completion =>
  " A neural network is a type of machine learning model inspired by the human brain. The key elements of neural networks are: n n - Neurons..."
 : stop_reason = > "stop_sequence" ,
 :stop => " n n Human:" }

كلود 1.3

https://us-east-1.console.aws.amazon.com/bedrock/home?region=us-east-1#/providers?model=anthropic.claude-v1

يدعم: الإجابة على الأسئلة، واستخراج المعلومات، وإزالة معلومات تحديد الهوية الشخصية، وإنشاء المحتوى، وتصنيف الاختيارات المتعددة، ولعب الأدوار، ومقارنة النص، والتلخيص، وتوثيق الأسئلة والأجوبة مع الاقتباس

 client . invoke_model ( id : 'anthropic.claude-v1' , prompt : "You will be acting as a AI customer success agent for a company called Acme Dynamics." )

# Response
{ :completion =>
  " Okay, thanks for providing the context. My name is Claude, I'm an AI assistant created by Anthropic to be helpful, harmless, and honest. How can I assist you as a customer success agent for Acme Dynamics today?" ,
 :stop_reason => "stop_sequence" ,
 :stop => " n n Human:" }

كلود 2

https://us-east-1.console.aws.amazon.com/bedrock/home?region=us-east-1#/providers?model=anthropic.claude-v2

يدعم: الإجابة على الأسئلة، واستخراج المعلومات، وإزالة معلومات تحديد الهوية الشخصية، وإنشاء المحتوى، وتصنيف الاختيارات المتعددة، ولعب الأدوار، ومقارنة النص، والتلخيص، وتوثيق الأسئلة والأجوبة مع الاقتباس

 client . invoke_model ( id : 'anthropic.claude-v2' , prompt : "I'm going to provide some text. I want to remove all person
ally identifying information from this text and replace it with XXX. It's very important that PII such as names, phone numbers,
 and home and email addresses, get replaced with XXX." )

# Response
{ :completion =>
  " Here is the text with personally identifying information replaced with XXX: n n XXX lives at XXX in the city of XXX. XXX can be reached at phone..." ,
 :stop_reason => "stop_sequence" ,
 :stop => " n n Human:" }

التحم

نماذج Cohere هي نماذج إنشاء نص لحالات الاستخدام التجاري. يتم تدريب نماذج Cohere على البيانات التي تدعم تطبيقات الأعمال الموثوقة، مثل إنشاء النص والتلخيص وكتابة النصوص والحوار والاستخراج والإجابة على الأسئلة.

خيارات نماذج الأوامر هي:

  {
    temperature : 0.3 ,           # float
    top_p : 0.5 ,                 # float
    top_k : 0.5 ,                 # float
    max_tokens : 1000 ,           # integer
    stop_sequences : [ ] ,         # [string]
    num_generations : 2 ,         # integer
    return_likelihoods : 'ALL' ,  # string
    stream : true ,               # boolean
    truncate : 'END'             # srtring
  }

لمزيد من الوثائق حول أنواع بيانات المعلمات وقيمها، يمكنك [راجع المزيد من التفاصيل...] [https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters-cohere-command.html]

كيفية استدعاء نماذج أوامر Cohere:

يأمر

https://us-east-1.console.aws.amazon.com/bedrock/home?region=us-east-1#/providers?model=cohere.command-text-v14

يدعم: التلخيص وكتابة النصوص والحوار والاستخراج والإجابة على الأسئلة.

 client . invoke_model ( id : 'cohere.command-text-v14' , prompt : 'Generate a twit about why Ruby on Rails is a great tool for building a startup. Write a few hashtags' )

# Response
{ :generations =>
  [ { :finish_reason => "COMPLETE" ,
    :id => "b82658a5-8f36-4a94-a1f1-7802aa418904" ,
    :text =>
     " Sure! Here's a tweet: n n Ruby on Rails is a powerful framework for building web applications. It is highly scalable, has robust community support, and is the perfect choice for startups looking to build fast and ship often. #RoR #RubyOnRails #Startup #Tech #Efficient n n What do you think?" } ] ,
 :id => "d5d5149f-ea5a-47ae-ae37-8324882b06c7" ,
 :prompt => "Generate a twit about why Ruby on Rails is a great tool for building a startup. Write a few hashtags:" }

ضوء القيادة

https://us-east-1.console.aws.amazon.com/bedrock/home?region=us-east-1#/providers?model=cohere.command-light-text-v14

يدعم: التلخيص وكتابة النصوص والحوار والاستخراج والإجابة على الأسئلة.

 client . invoke_model ( id : 'cohere.command-light-text-v14' , prompt : 'Generate a facebook post about GenAI models available at Amazon Bedrock' )

# Response
{ :generations =>
  [ { :finish_reason => "MAX_TOKENS" ,
    :id => "b58eaa37-915e-4f26-b37c-6b4875516648" ,
    :text =>
     " Introducing the latest innovation at Amazon Bedrock - our state-of-the-art GenAI models! ? n n Our team has been working tirelessly to bring you the best in artificial intelligence, and we're excited to share the results with you. With our GenAI models, you can now: n n - Develop applications that can understand and respond to human language with incredible accuracy, thanks to our state-of-the-art Large Language Models (LLMs). n -" } ] ,
 :id => "0d2f2c74-cae9-434b-b5d5-f44aaeb1a587" ,
 :prompt => "Generate a facebook post about GenAI models available at Amazon Bedrock:" }

خيارات تضمين النماذج هي:

  {
    input_type : 'classification' , # string
    truncate : 'END'               # string
  }

لمزيد من الوثائق حول أنواع بيانات المعلمات وقيمها، يمكنك [راجع المزيد من التفاصيل...] [https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters-embed.html]

كيفية استدعاء نماذج التضمين Cohere:

تضمين اللغة الإنجليزية

https://us-east-1.console.aws.amazon.com/bedrock/home?region=us-east-1#/providers?model=cohere.embed-english-v3

يدعم: البحث الدلالي، وتوليد الاسترجاع المعزز (RAG)، والتصنيف، والتجميع.

 # WIP
# client.invoke_model(id: 'cohere.embed-english-v3', prompt: 'Your prompt goes here ...')

تضمين متعدد اللغات

https://us-east-1.console.aws.amazon.com/bedrock/home?region=us-east-1#/providers?model=cohere.embed-multilingual-v3

 # WIP
# client.invoke_model(id: 'cohere.embed-multilingual-v3', prompt: 'Your prompt goes here ...')

ميتا

تتطلع Meta إلى إطلاق العنان لقوة نماذج اللغات الكبيرة. أحدث إصدار لدينا من Llama أصبح الآن في متناول الأفراد والمبدعين والباحثين والشركات من جميع الأحجام حتى يتمكنوا من تجربة أفكارهم وابتكارها وتوسيع نطاقها بشكل مسؤول.

الخيارات لهذه النماذج هي:

  {
    max_tokens : 128 ,  # integer
    temperature : 0.9 , # float
    top_p : 0.7        # float
  }

كيفية استدعاء نماذج ميتا:

لاما 2 دردشة 13ب

https://us-east-1.console.aws.amazon.com/bedrock/home?region=us-east-1#/providers?model=meta.llama2-13b-chat-v1

الدعم: Llama 2 مخصص للاستخدام التجاري والبحثي باللغة الإنجليزية. نماذج الدردشة المضبوطة مخصصة للتطبيقات القائمة على الدردشة.

 client . invoke_model ( id : 'meta.llama2-13b-chat-v1' , prompt : 'Generate an Instagram Post about the Metaverse' )

# Resopnse
{ :generation =>
  " n n Hey #Instagram community!  I'm super excited to share my latest discovery with you all - the #Metaverse! ? n n Have you heard of it? It's like a virtual world where you can be anyone and do anything! ? From exploring new planets to attending virtual concerts, the possibilities are endless! ? n n I've been spending some time in the #Metaverse lately, and let me tell you, it's a game changer!  Not only is it a ton of fun, but it's also a great way to connect with people from all over the world. ? n n I've made some amazing friends in the #Metaverse, and we've had some incredible adventures together! ?? n n So, what are you waiting for? Come join me in the #Metaverse and let's explore this amazing virtual world together! ? n n #Metaverse #VirtualReality #VR #Gaming #Adventure #Fun #Community #Friends #Instagram #SocialMedia" ,
 :prompt_token_count => 11 ,
 :generation_token_count => 275 ,
 :stop_reason => "stop" }

اللاما 2 الدردشة 70B

https://us-east-1.console.aws.amazon.com/bedrock/home?region=us-east-1#/providers?model=meta.llama2-70b-chat-v1

الدعم: Llama 2 مخصص للاستخدام التجاري والبحثي باللغة الإنجليزية. نماذج الدردشة المضبوطة مخصصة للتطبيقات القائمة على الدردشة.

 client . invoke_model ( id : 'meta.llama2-70b-chat-v1' , prompt : 'Generate a Facebook add to promote a new website that is selling Ruby on Rails and AI courses' )

# Response
{ :generation =>
  ". n n The ad should be targeted at people who are interested in learning Ruby on Rails and AI, and should highlight the benefits of taking the courses on the website. n n Here is a sample ad that could be used to promote the website: n n Headline: Unlock Your Potential with Ruby on Rails and AI Courses n n Body: Are you interested in learning Ruby on Rails and AI? Look no further! Our website offers a range of courses that will teach you everything you need to know to get started with these exciting technologies. n n Our Ruby on Rails courses will show you how to build powerful web applications using the popular framework, while our AI courses will teach you the fundamentals of machine learning and deep learning. ..." ,
 :prompt_token_count => 22 ,
 :generation_token_count => 512 ,
 :stop_reason => "length" }

الاستقرار منظمة العفو الدولية

Stability AI هي شركة الذكاء الاصطناعي التوليدي مفتوحة المصدر الرائدة عالميًا، وتتعاون مع شركاء من القطاعين العام والخاص لتوفير البنية التحتية للجيل القادم لجمهور عالمي.

الخيارات لهذه النماذج هي:

  {
    cfg_scale : 20 ,  # integer
    seed : 1 ,        # integer
    steps : 10       # integer
  }

كيفية استدعاء نماذج الذكاء الاصطناعي للاستقرار:

اس دي اكس ال 0.8

https://us-east-1.console.aws.amazon.com/bedrock/home?region=us-east-1#/providers?model=stability.stable-diffusion-xl-v0

يدعم: توليد الصور، تحرير الصور

 client . invoke_model ( id : 'stability.stable-diffusion-xl-v0' , prompt : 'Generate an image of an orca jumping out of the water' , options : { file_path : 'path/to/your/image.jpg' } )
# NOTE: If file_path is not provided the image will be saved at 'image.jpg'

# Success Response
{
  result : :success ,
  file_path : 'path/to/your/image.jpg'
}

# Failure Response
{
  result : :failure ,
  error : ErrorClass
}

مثال على الصورة التي تم إنشاؤها

اس دي اكس ال 1.0

 client . invoke_model ( id : 'stability.stable-diffusion-xl-v1' , prompt : 'Generate an image of a white gold ring with a ruby on it' , options : { file_path : 'path/to/your/image.jpg' } )
# NOTE: If file_path is not provided the image will be saved at 'image.jpg'

# Success Response
{
  result : :success ,
  file_path : 'path/to/your/image.jpg'
}

# Failure Response
{
  result : :failure ,
  error : ErrorClass
}

مثال على الصورة التي تم إنشاؤها