このドキュメントは AI によって自動翻訳されています。不正確な部分がある場合は、英語版 を参照してください。ナレッジベースの種類ごとに API が分かれていますが、どちらも同じ API キーを使います。
API キーの作成
キーを作成、表示、削除できるのは、ワークスペースのオーナーと管理者だけです。
アクセス範囲の選択
キーの作成時に、すべてのナレッジベースへのアクセスを許可するか、選んだナレッジベースだけに限定するかを決めます。選べるのはどちらの種類のナレッジベースでもかまいません。連携先が扱うナレッジベースだけを選んでください。 特定のナレッジベースを指定しない操作も呼び出す場合は、代わりにすべてのナレッジベースへのアクセスを許可します。従来型ナレッジベースの一覧取得や作成、タグの管理、利用可能なモデルの取得 などがこれにあたります。 アクセス範囲は後から変更できません。変更が必要な場合は、キーを置き換えてください。キーの置き換え
キーのアクセス範囲を変更する場合やキーをローテーションする場合は、新しいキーを作成して連携先を切り替えてから、古いキーを削除します。削除したキーはすぐに使えなくなります。 Agent ナレッジベースのリサーチタスクと削除ジョブは、それを開始したキーでしか読み取れません。古いキーを削除する前に、それらの完了を待ち、結果を読み取っておいてください。キーが拒否される場合
従来型ナレッジベースの 403
forbidden は上記のいくつかの原因で返るため、エラーの message を読んで区別してください。
従来型ナレッジベースにアクセス範囲を限定したキーは、そのナレッジベースからアップグレードした Agent ナレッジベースには使えません。Agent ナレッジベースにアクセスするには、それを含むキーに 置き換えてください。
キーのワークスペースに存在しない Agent ナレッジベース ID を指定すると、無効なキーと同じく 401 knowledge_fs_invalid_credential が返ります。キーを置き換える前に、ID を確認してください。