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

AWS Bedrock

Icon-Architecture/48/Arch_Amazon-Bedrock_48
AI agents を AWS Bedrock 経由で利用可能な foundation models（Amazon Nova、Anthropic Claude、その他のプロバイダーを含む）に接続します。​

概要​

AWS Bedrock connector を使用すると、Amazon Bedrock を通じて foundation models にアクセスできます。これは、インフラが AWS 上にあり Bedrock のマネージドなモデルアクセスを利用したい場合や、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 service を利用できる AWS region（例: us-east-1, us-west-2）。使用したいモデルがこの region で有効化されていることを確認してください。
  • API Key: AWS Bedrock API key。
  • Models: この connector で利用可能なモデルを定義する JSON array。各モデルには次のフィールドが必要です。
FieldTypeDescription
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 application が Squid の AWS regions のいずれかで動作している場合、Amazon Titan Text Embeddings v2（titan-embed-text-v2）は、knowledge base の作成 時にデフォルトで利用可能な embedding model として表示されます。これは Bedrock connector 自体とは別であり、追加の設定は不要です。