# Foundry Workspaceの使用

ユーザーがFoundry Workspaceでagentを使用するには、各LLMプロジェクトの *Generic Chat in LLM Console* 権限が必要です。

少なくとも1つのプロジェクトで *Generic Chat* 権限を持っている場合、Treasure コンソールのグローバルメニューにFoundry Workspaceアイコンが表示されます。ユーザーは、*Home* タブでWorkspaceに公開されているプロジェクトとagentのリストを確認できます。

*Home* 画面は2つのエリアに分かれており、上部エリアにはTreasure Dataが提供するプロダクトagent(スクリーンショットの例ではTD-Managed: Creative Studio)が表示され、下部エリアにはカスタムプロジェクトとagentが表示されます。

![](/assets/foundry-workspace-home.45289db854c5b460c448e089c13e56d9fc04ad1f4b7798b65d42f5ad01678b9f.91c26685.png)

## Foundry WorkspaceでAgentを使用する

特定のagentを使用するには、agentアイコン(ダイヤモンドアイコンとagentタイトルが付いたボックス)をクリックします

1. **Agentをクリック**: 特定のプロジェクト内の特定のagentアイコンをクリックします
2. **フォームに入力**: フォームタイプのagentは、agentへの入力を提供するためのフォームを提供します。フォームに入力します。
3. **Generateボタンをクリック**: フォームタイプのagentでは、コンテンツを生成するためにGenerateボタンをクリックする必要があります


この図は、Treasure Dataが提供する *Creative Studio* の *Image Generation Agent* の例です。

![](/assets/foundry-workspace-agent-list.cccb2f63061bdff9bbbb4f335143fabba4e90cf4ab8ab0becf6e0776ac5f34f9.91c26685.png)

## Foundry Workspace でスケジュール実行を設定する

### 前提条件

スケジュール実行は、Foundry Workspace に公開されている **フォームタイプのエージェント** のみで利用できます。

また、スケジュールを設定する前に、一度フォームからエージェントを実行し、出力結果が期待どおりか確認することを推奨します。

### スケジュールを作成する

1. **Foundry Workspace** を開き、自動化したいフォームタイプのエージェントを選択します。
2. 一度フォームを入力して実行し、結果が期待どおりか確認します。
3. フォーム画面から **スケジュール設定 (Set up schedule)** などのスケジュール設定アクションを選択します。
4. スケジュールを設定します：
  - **頻度**: 日次 / 週次 / 月次
  - **開始日 / 終了日** と **タイムゾーン**
  - スケジュール作成者に対する **通知メール送信の有無**
5. スケジュールを保存すると、現在のフォーム入力値が毎回の実行条件として固定されます。


![スケジュール設定フォーム](/assets/foundry-workspace-schedule-form.0685b4598154e7c0f6db819b541efadcf492502c63811a035c1e26dbaaab3eb9.91c26685.png)

以後、エージェントは設定したスケジュールに従って自動的に実行されます。

### スケジュールの確認と管理

Foundry Workspace の **Scheduled Run** ビュー（またはタブ）を開くと、自分がアクセス権を持つスケジュール一覧を確認できます。

![スケジュール実行一覧](/assets/foundry-workspace-scheduled-runs.9482e2bed27000c7f8dff55a37625b9cb4084382fe8a337d9af21520eecc47ae.91c26685.png)

スケジュール一覧からは、次の操作が可能です。

- 各フォームインターフェースごとのスケジュールと、その基本情報（名前、頻度、次回実行予定、メール通知の有無）を確認する
- 既存のスケジュールを編集し、頻度・期間・メール通知設定を変更する
- スケジュールを削除し、今後の自動実行を停止する


そのエージェントの実行権限（execute 権限）を持つユーザーであれば、同じスケジュールを閲覧・編集・削除できます。

### 通知と履歴

スケジュール実行が完了すると、スケジュール作成者は任意でメール通知を受け取ることができ、メール内のリンクから Workspace 上の成果物にアクセスできます。

各スケジュール実行は、手動実行と同様に成果物と履歴エントリとして保存されます。

### 制限事項

- スケジュール実行は、現時点では Foundry Workspace 上の **フォームタイプのエージェントのみ** が対象です。
- **Audience Agent** で行う分析をスケジュールすることはできません。
- 通知メールの送信先はスケジュール作成者のみです。


### 直近90日などの動的な期間を扱う場合

スケジュール実行では、毎回同じロジックが再評価されます。
「直近 90 日」のような動的な期間を扱いたい場合は、固定の日付をハードコードせず、次のように指定することを推奨します。

- **SQL の場合**: 実行時点の現在日付から 90 日前を計算し、その条件を `WHERE` 句で使用します（例: `current_date - interval '90 day'` を基準に期間を指定）。
- **プロンプトの場合**: `now` に対して相対的な期間として記述します（例: 「実行時点を基準に直近 90 日間のデータを分析してください」など）。


このようにしておくと、スケジュール設定を変更しなくても、毎回の実行で自動的に対象期間（直近 90 日）がスライドします。

## ランタイムリソースのアップロードと使用

Workspaceでは、サポートされているAgentで使用できるリソースをユーザーがアップロードすることができます。以下のスクリーンショットは、*Creative Studio* の *Brand Guildeline* agentの例です。

ユーザーは、*Text reource* 選択ボックスから既存のリソースの中からアップロード済みのリソースを選択できます。

![](/assets/foundry-workspace-runtime-select.7522e7cce75268c26ee118198aef9ecd8a1ee15c12cda3b1999d21c3b592aed6.91c26685.png)

ランタイムリソースをアップロードするには

1. Workspaceの **Resources** タブに移動します。
![](/assets/foundry-workspace-resources-tab.75998e5537c023a9d3c7c8d1976377740431b47523b546ad81d9253788bb27ae.91c26685.png)
2. **Create resource** ボタンをクリックします。
![](/assets/foundry-workspace-create-resource.c34f4b1cb47556a936aa31ec3ca7067917c781ae5f8afd56a9c62ae1dbfab4a5.91c26685.png)
3. フォームに入力します。
![](/assets/foundry-workspace-resource-form.9865743f00612221ab330940841ed71304e74cac65b738b7bdab53ab9159abde.91c26685.png)


| フィールド | 説明 |
|  --- | --- |
| Name | リソースの名前 |
| Description | リソースの説明 |
| Text | リソースのテキストコンテンツ。このデータは、このリソースがformのinterfaceで選択されたときに使用されます。最大18,000文字までサポートしています。 |