> 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-agent.md).

# AIエージェント (ベータ版)

{% hint style="warning" %}
この機能は現在ベータ版です。仕様については予告なく変更となる場合があります。
{% endhint %}

Codatum Agentは、Codatum上のデータやナレッジ、外部サービスを横断し、自然言語で調査・分析・業務上の操作を進めるためのAIエージェントです。カタログ、Notebook、Web、連携先サービスなどのコンテキストを参照し、目的に応じて必要な情報とツールを選択します。

Notebookの作成・編集は、分析結果や調査内容を整理して共有するためにCodatum Agentが利用できる手段の一つです。

## 主な機能

* テーブルやカラムの探索
* SQLの作成と実行
* 実行結果の分析
* Notebookの作成・編集
* SQLブロックやチャートの追加・編集
* Notebook、テーブル、保存済みクエリなどの参照
* Web検索とWebページの取得
* [エージェントコネクタ](/codatum-ai/agent-connector.md)を利用した外部サービスとの連携

利用できる機能は、ユーザーの権限、選択したAIプロファイル、操作モード、現在表示している画面によって異なります。

## 利用条件と有効化

Codatum Agentは、AIエージェント機能を利用できるプランで提供されます。ワークスペース管理者が`ワークスペース設定` > `オプション` > `Codatum AI`でAIエージェントを有効にすると利用できます。

AIエージェントが使用するモデルや権限は[AIプロファイル](/codatum-ai/ai-profile.md)で設定します。

## 表示モード

### サイドパネル

画面上のAIエージェントアイコンから開きます。Notebookを表示している場合は、現在のNotebookやページをコンテキストとして利用できます。

### フルページ

AIエージェントを独立した画面で表示します。特定のNotebookを起点としないデータ探索や、長い会話を確認する場合に利用できます。

サイドパネルとフルページでは、同じチャットセッションを継続できます。

## 操作モード

### Askモード

クエリの実行を含むデータ分析を行いますが、Notebookの作成・編集は行いません。Notebookを変更せずにデータを調べる場合に使用します。

### Agentモード

Askモードで利用できる操作に加えて、Notebookの作成・編集、SQLブロックやチャートの追加などを行います。

Notebookの書き込み権限がないユーザーはAskモードに固定されます。

## コンテキスト

Codatum Agentは、次の情報をコンテキストとして利用します。

* 現在表示しているページとNotebook
* メッセージ内で`@`を使って指定したテーブル、Notebook、保存済みクエリ
* 現在のNotebookで指定できるSQLブロックやチャート
* 自動読み込みされるエージェントコンテキスト
* AIプロファイルに設定された補足情報、Notebook、フォルダ

入力欄のコンテキスト使用量を開くと、自動読み込みされるコンテキストと使用量を確認できます。エージェントコンテキストの読み込み条件と推奨構成については、[エージェントコンテキスト](/codatum-ai/agent-context.md)を参照してください。

## 権限

Codatum Agentが実行できる操作は、次の条件をすべて満たす範囲に制限されます。

1. **ユーザーのアクセス権限**
   * ユーザーが閲覧または編集できるNotebook、テーブル、コネクションだけを利用できます。
2. **操作モード**
   * AskモードではNotebookを作成・編集するツールを利用できません。
3. **AIプロファイルの権限**
   * Notebookの参照範囲、利用可能なコネクション、Web検索・Webページ取得のドメイン、エージェントコネクタを制限できます。
4. **ツール実行時の承認**
   * SQLや外部サービスの操作について、実行前の確認を必須にできます。

AIプロファイルの権限は、ユーザー自身のアクセス権限を拡張するものではありません。

## ツール実行と承認

SQLの実行、MCPツールの実行、エージェントコネクタからのHTTPリクエストでは、実行前に承認を求める場合があります。

ユーザー設定では、次の操作の自動承認を設定できます。

* SQL実行
  * 全コネクション共通またはコネクション単位で設定できます。
  * BigQueryでは、ドライラン結果に基づく最大スキャンサイズを設定できます。
* `MCPツール実行`
* `Connector HTTPリクエスト`

{% hint style="warning" %}
自動承認を有効にすると、確認操作を挟まずにクエリや外部サービスの操作が実行されます。AIプロファイルの権限と接続先の権限を確認したうえで設定してください。
{% endhint %}

## Agent画面と設定

Agent画面では、次の操作ができます。

* 新しいチャットの開始
* 過去のチャット履歴の表示
* セッションの開始時刻やトークン使用量の確認
* サイドパネルとフルページの切り替え
* Codatumチームへのフィードバック送信

入力欄の設定メニューでは、次の項目を変更できます。

* AskモードとAgentモード
* 優先的に利用するコネクション
* SQL、MCPツール、Connector HTTPリクエストの自動承認
* 個人、チームスペース、Notebookのエージェントコンテキストの自動読み込み
* AIプロファイル
* 応答言語
* Enterキーの動作

異なる目的の分析を始める場合は、新しいチャットを開始することで、不要な会話履歴によるコンテキスト使用量の増加を避けられます。

## 利用状況

ワークスペース管理者は、`ワークスペース設定` > `エージェント利用状況`で、セッション数やトークン使用量などを確認できます。利用状況データの保持期間は30日です。

AIプロファイルで会話メッセージのログ保存が無効になっている場合、利用状況には統計情報が記録されますが、メッセージ本文は表示されません。

## データの取り扱い

Codatumが利用する外部LLMサービスは、送信されたデータをモデルの学習に使用しないことを規約で保証しています。

AIエージェントが分析や処理を行うため、次の情報が選択したLLMサービスへ送信される場合があります。

* 入力したメッセージ
* Notebookやページの内容
* `@`で指定した参照情報
* テーブルのスキーマやデータ
* SQLの実行結果
* エージェントコンテキスト

Codatum開発者は、品質改善のために利用日時、ユーザー・ワークスペースの識別情報、エラー、トークン使用量の目安、処理時間を記録します。入力・応答の本文、`@`で追加した参照情報、SQLの実行結果、データソースの実データは記録しません。

ご利用にあたっては、お客様の社内AI利用ポリシーをご確認ください。

## 関連ページ

* [エージェントコンテキスト](/codatum-ai/agent-context.md)
* [エージェントコネクタ](/codatum-ai/agent-connector.md)
* [AIプロファイル](/codatum-ai/ai-profile.md)


---

# 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-agent.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.