メインコンテンツまでスキップ

AWS Bedrock

Icon-Architecture/48/Arch_Amazon-Bedrock_48
AI agent を AWS Bedrock を通じて利用可能な foundation model に接続します。Amazon Nova、Anthropic Claude、その他のプロバイダーを含みます。​

概要​

AWS Bedrock connector を使用すると、Amazon Bedrock を通じて foundation model にアクセスできます。これは、インフラが AWS 上にあり Bedrock の managed model access を使いたい場合や、Amazon Nova のように Bedrock 経由でのみ利用できるモデルへのアクセスが必要な場合に便利です。

この connector は以下をサポートします:

  • Bedrock Converse API を使用した chat completions
  • Function calling（tool use）

connector のセットアップ​

AWS Bedrock connector を追加するには、次の手順を完了してください:

  1. Squid Console に移動し、アプリケーションを選択します。
  2. Connectors タブをクリックします。
  3. Available Connectors をクリックし、AWS Bedrock connector を見つけます。次に Add Connector をクリックします。
  4. 次の詳細を入力します:
  • Connector ID: 任意の一意な ID（例: my-bedrock）。これはコード内で参照する integrationId です。
  • Region: Bedrock サービスが利用可能な AWS region（例: us-east-1、us-west-2）。使用したいモデルがこの region で有効化されていることを確認してください。
  • API Key: AWS Bedrock API key。
  • Models: この connector を通じて利用可能なモデルを定義する JSON 配列。各モデルには次のフィールドが必要です:
フィールド型説明
modelNamestringBedrock model identifier（例: us.amazon.nova-2-lite-v1:0）
displayNamestringモデルの人間向け表示名
maxOutputTokensnumberモデルがレスポンスで生成できる最大 token 数
contextWindowTokensnumbertoken での総 context window サイズ

例:

[
  {
    "modelName": "us.amazon.nova-2-lite-v1:0",
    "displayName": "Amazon Nova 2 Lite",
    "maxOutputTokens": 5120,
    "contextWindowTokens": 300000
  }
]
  1. Add Connector をクリックします。

connector の使用​

設定が完了したら、connector ID と model name を指定して AI agent と一緒に connector を使用します:

Client code
await squid.ai().agent('my-agent').updateModel({
  integrationId: 'my-bedrock',
  model: 'us.amazon.nova-2-lite-v1:0',
});

リクエストごとに model を上書きすることもできます:

Client code
const response = await squid
  .ai()
  .agent('my-agent')
  .ask('Summarize our Q4 report', {
    model: {
      integrationId: 'my-bedrock',
      model: 'us.amazon.nova-2-lite-v1:0',
    },
  });

Embeddings​

Squid アプリケーションが Squid の AWS regions のいずれかで実行されている場合、Amazon Titan Text Embeddings v2（titan-embed-text-v2）は、knowledge base を作成 する際にデフォルトで利用可能な embedding model として表示されます。これは Bedrock connector 自体とは別のものであり、追加の設定は不要です。