Appearance
AIプロファイル
AIプロファイルは、AIエージェント が利用する LLM の接続方法・権限・固定コンテキストをまとめた設定です。ワークフロー の LLM アクションでも利用します。
グローバルナビ > ワークスペース設定 > AIプロファイル から作成・管理します。AIエージェントとのチャット中は入力欄の AIプロファイル から、利用するプロファイルを切り替えられます。
種類
AIプロファイルを作成 から、次のいずれかを選びます。
| 種類 | 説明 |
|---|---|
| マネージド | Codatum が管理する AI モデルを使用します。APIキーは不要です |
| カスタム | OpenAI / Anthropic / Gemini / Vertex AI / OpenRouter / Fireworks / Amazon Bedrock などの APIキーを使用します |
カスタム は、ご契約内容により利用できない場合があります。
作成・管理
- グローバルナビ > ワークスペース設定 > AIプロファイル を開きます
- AIプロファイルを作成 から マネージド または カスタム を選びます
- 各項目を入力し、作成 します
既存プロファイルは一覧から開き、更新 で変更できます。
設定項目
名前
プロファイルの表示名です。
モデル選択 / プロバイダー / モデル
- マネージド: モデル選択 でモデルのティア(用途に応じた選択)を選びます。プロバイダーや個別モデル名は指定できません
- カスタム: プロバイダー と モデル、APIキーなどを設定します
Amazon Bedrock を使用する場合は、Bedrock APIキーとリージョンを設定します。
コンテキスト
AIエージェント実行時に固定で参照させる内容を指定します(任意)。
| 項目 | 説明 |
|---|---|
| ノートブックとフォルダ | 紐づけたノートブック、またはフォルダ内のノートブックを読み込みます。チームスペース内のフォルダやノートブックも指定できます |
| プレーンテキスト | テキストとして渡す追加の指示や説明です |
フォルダを紐づけた場合、そのフォルダ内のノートブックが読み込まれます。チームスペース内のフォルダを紐づけた場合、その AIプロファイルを利用するには対象フォルダの閲覧権限が必要になります。
WARNING
ワークフロー 実行時には、AIプロファイルのコンテキストは読み込まれません。
ツール権限
AIエージェントが使える範囲を、実行ユーザーの権限に加えて制限します。
| 項目 | 選択肢・内容 |
|---|---|
| ノートブックアクセス | 権限のある全てのノートブック / 表示中のノートブックのみ |
| コネクションアクセス | 権限のある全てのコネクション / 選択したコネクションのみ許可 / 選択したコネクションを拒否 |
| コネクタアクセス | オフ / 選択したコネクタのみ許可 / 全てのコネクタ |
| Web検索 | オフ / 特定のドメインで許可 / オン |
| Webページ取得 | オフ / 特定のドメインで許可 / オン |
ドメイン指定では、example.com や *.example.com の形式を使えます。
共有設定
プロファイルを利用できるメンバー・グループを管理します。
| 対象 | 説明 |
|---|---|
| ワークスペースオーナー | 常に含まれます(固定) |
| ワークスペースメンバー | メンバー全体への付与 |
| グループ・個別メンバー | グループ・メンバーを追加 から追加。ロールは オーナー / 利用者 を選択します |
- オーナー: プロファイルの編集などができます
- 利用者: この AIプロファイルを使ってチャットできます
会話をログに保存
オンにすると、このAIプロファイルでの会話メッセージは エージェント利用状況 のセッション詳細から確認できます。
コスト計測
カスタム AIプロファイルでは、コスト計測 をオンにすると推定コストを記録できます。記録した推定コストは、AIプロファイルの詳細画面に 今月(推定) として表示されます。
固定モデルでは、100万トークンあたりの 入力・キャッシュ済み入力・出力 の単価を USD で設定します。モデルにデフォルト単価がある場合は入力欄に反映されます。デフォルトに戻す で現在のデフォルト単価に戻せます。
モデル が Auto の場合は、実行時に選択されたモデルのデフォルト単価を使います。
推定コストには次の仕様があります。
- 計測をオンにしている期間の使用量だけを記録します
- 単価を変更しても、記録済みの推定コストは変更されません
- キャッシュ書き込みの割増、プロバイダー側の割引、バッチ料金、為替は反映しません
- 再試行や失敗したリクエストの一部は記録されない場合があります
- プロバイダーからの実際の請求額とは異なる場合があります
使用量上限
AIプロファイルごとに、コストの上限を設定できます(任意)。上限は次の2種類があり、両方を設定できます。
| 項目 | 説明 |
|---|---|
| プロファイル上限 | このプロファイル全体の使用量に対する上限です |
| ユーザーあたり上限 | 各ユーザーが直接開始した使用量に対する上限です。ワークフロー や APIキー 経由の実行は含まれません |
金額は USD で指定し、期間は 毎月 / 毎週 / 毎日 から選びます。期間はスコープ内で重複できません。上限は各スコープ最大 3 件です。詳細は 制約と上限値 を参照してください。
期間は UTC のカレンダーでリセットされ、週の起点は月曜です。いずれかの上限に達すると、そのプロファイルでの新規実行は拒否されます。エラーにはリセット日時(UTC)が含まれます。複数の期間を設定している場合、どれか 1 つでも超過すると停止します。
チェックはターン開始時など実行前に行います。進行中のターンは上限を超えて完了する場合があります。
- カスタム: コスト計測 がオンのときに設定できます。上限は推定コストに基づきます。計測をオフにすると上限は適用されなくなりますが、設定値は保持されます
- マネージド: 使用量上限 から設定します。上限はこのプロファイルの課金額に基づきます。ワークスペースの月間の使用量上限とは独立しており、先に達した方で停止します
開始画面
チャット開始時のウェルカム文言や、提案プロンプト(サジェスト)を設定できます(任意)。