> For the complete documentation index, see [llms.txt](https://docs.codatum.jp/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.codatum.jp/codatum-ai/ai-profile.md).

# AIプロファイル

## 概要

AIプロファイルは、Codatum Agentで使用するAIモデル、コンテキスト、ツール権限などをまとめた設定です。用途ごとにAIプロファイルを作成し、Agent画面で切り替えて利用できます。

## 種類

### Managed AI Profile

Codatumが管理するAIモデルを使用します。APIキーの設定は不要です。使用するモデルの種類を選択できます。

AIプロバイダーやエンドポイントは指定できません。セキュリティ要件などにより利用するプロバイダーや認証情報を指定する必要がある場合は、Custom AI Profileを使用してください。

### Custom AI Profile

BYOAI（Bring Your Own AI）方式で、お客様が用意したAPIキーやサービスアカウントを設定して利用します。AIプロバイダー、モデル、推論量などを指定できます。

Google Vertex AIを利用する場合は、サービスアカウントに`Vertex AI User`ロールを付与する必要があります。登録したシークレットは暗号化して保存されます。

{% hint style="info" %}
Custom AI Profileは有料オプションです。詳細はチャットまたは`support@codatum.com`までお問い合わせください。
{% endhint %}

## 設定方法

`ワークスペース設定` > `オプション` > `AIプロファイル`から設定します。`AIプロファイルを作成`を選択し、Managed AI ProfileまたはCustom AI Profileを作成します。

設定できる項目は、AIプロファイルの種類やご利用のプランによって異なります。

## コンテキスト

AIプロファイルには、次の情報をコンテキストとして設定できます。

* **プレーンテキスト**
  * 前提、用語、解釈方針などの補足情報を入力します。
* **Notebook**
  * 指定したNotebookの内容を読み込みます。
* **フォルダ**
  * 指定したフォルダと、そのサブフォルダ内にあるすべてのNotebookを読み込みます。

Notebookとフォルダは、Agent実行時に利用するユーザーが閲覧できる場合に限り読み込まれます。閲覧できないNotebookが含まれる場合、そのユーザーはAIプロファイルを利用できません。

{% hint style="warning" %}
AIプロファイルに設定したNotebookとフォルダは、ゲストのReport AgentとWorkflow実行では読み込まれません。プレーンテキストはゲストのReport Agentにも適用されますが、Workflow実行では使用されません。
{% endhint %}

フォルダ内の情報をすべて読み込む必要がない場合は、情報の索引となるNotebookだけを設定し、必要な情報をAgentに検索させる構成を推奨します。詳しくは[エージェントコンテキスト](/codatum-ai/agent-context.md)を参照してください。

## ツール権限

AIプロファイルごとに、Codatum Agentが利用できる情報とツールを設定できます。

### Notebookアクセス

* `権限のある全てのノートブック`
* `表示中のノートブックのみ`

### コネクションアクセス

* `権限のある全てのコネクション`
* `選択したコネクションのみ許可`
* `選択したコネクションを拒否`

### Web検索・Webページ取得

Web検索とWebページ取得は個別に設定できます。

* `オフ`
* `特定のドメインで許可`
* `オン`

特定のドメインで許可する場合は、`example.com`または`*.example.com`の形式で許可するドメインを指定します。

### エージェントコネクタ

* `オフ`
* `選択したコネクタのみ許可`
* `全てのコネクタ`

コネクタの設定については[エージェントコネクタ](/codatum-ai/agent-connector.md)を参照してください。

{% hint style="info" %}
AIプロファイルのツール権限は、利用するユーザー自身のアクセス権限を拡張するものではありません。ユーザーの権限とAIプロファイルの権限の両方で許可されている範囲だけを利用できます。
{% endhint %}

## 共有設定

AIプロファイルを利用・管理できる対象を、ワークスペースメンバー、グループ、ユーザー単位で設定できます。

* `オーナー`
  * AIプロファイルの設定を変更できます。
* `ユーザー`
  * AIプロファイルをAgentで利用できます。

ワークスペースオーナーは、すべてのAIプロファイルのオーナーとして扱われます。

## 会話ログ

`会話メッセージの内容をログに保存`を有効にすると、そのAIプロファイルを利用したAgentセッションのユーザーとAIのメッセージをワークスペース管理者が`エージェント利用状況`で確認できます。

この設定によって、会話メッセージの内容がCodatum開発者に共有されることはありません。Codatum開発者が品質改善のために記録する情報については、[Codatum Agentのデータの取り扱い](/codatum-ai/ai-agent.md)を参照してください。

## カスタム振る舞いと開始画面

ご利用のプランによっては、Agentの振る舞いとチャットの開始画面をAIプロファイルごとに設定できます。

* **カスタム振る舞い**
  * Agentが質問、説明、分析を行う際の追加指示を設定します。
* **標準の振る舞い**
  * AIプロファイルへ適用しない標準指示を無効にできます。
* **開始画面**
  * ウェルカムタイトル、説明、おすすめの質問を設定します。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.codatum.jp/codatum-ai/ai-profile.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.