📚 参考書籍
※この記事は書籍の一部をベースに再構成しています。もう少し踏み込んだ内容(設計や具体例)は書籍の中でまとめているので、気になる方はそちらもどうぞ。
####『ゼロから触ってわかった!AI Agent Observability入門― MLflow・Databricksで実践するAIエージェントの評価・監視・安全性・説明可能性』
本書は、AI Agentを「作って動かす」だけでなく、その品質をどう観測し、どう評価し、どう守り、どう説明可能にするかを体系的に学ぶための入門書です。
https://link.amazon/B04VaTlR3
📚 その他参考書籍一覧
※全書籍・全ブログ・週刊Databricksリリース情報
https://modern-tech-hub.mellow-launc-5442.chatgpt.site/books
⚡Databricks Agent Engineering入門⚡ Unity Catalog Connectionとは?外部DB・API・MCPへの安全な接続設計
AI GatewayがAgentのAI利用を統制する一方、外部DBやAPIの接続先・認証情報を管理するのがUnity Catalog Connectionです。
1. Connectionとは何か?
Connectionは、外部システムの接続先・認証情報・設定をUnity Catalogで管理するセキュリティ保護可能なオブジェクトです。
APIキーをAgentへ直書きすると、キー更新やAgent追加のたびに修正が必要です。
Agent / Tool → Connection → 外部システム
**「どう接続するか」と「何を実行するか」**を分離できます。
2. 外部データベースにはLakehouse Federation
ConnectionはPostgreSQL、MySQL、SQL Server、Oracle、Snowflakeなどにも対応します。
Lakehouse FederationのQuery Federationでは、主に次のように構成します。
- Connection:ホスト・認証情報・接続設定を管理
- Foreign Catalog:外部DBのテーブルをUnity Catalog経由で公開
- Agent / SQL:許可されたテーブルを参照
外部データの複製なしで読み取りクエリを実行でき、Foreign Catalogの権限も別途必要です。
3. REST API・MCPにはHTTP Connection
HTTP Connectionは外部HTTPサービスの接続先と資格情報を管理します。
- CRMやチケット管理のREST API
- 社内業務API
- 外部MCPサーバー
Bearer TokenやOAuthなどの認証方式に対応します。
2026年11月現在、Schema単位はGA、Metastore単位はPublic Previewです。
外部MCPサーバーはHTTP Connectionを作成後、Unity GatewayへMCP Serviceとして登録し、公開されたToolを利用します。
4. USE CONNECTIONで利用者を制限する
Connectionは作成しただけですべてのAgentから使えるわけではありません。
HTTP Connectionを利用するユーザーやDatabricks AppsのService Principalには、必要に応じてUSE CONNECTIONを付与します。
GRANT USE CONNECTION
ON CONNECTION crm_api
TO `agent_app_sp`;
※接続名・主体名は例です。Foreign Catalogの作成ではCREATE FOREIGN CATALOGなど、用途によって必要な権限が異なります。
例えば、営業AgentにはCRM接続を許可し、文書作成Agentには許可しない設計ができます。
5. Connection ProxyでSecretを渡さない
外部REST APIには、DatabricksのHTTP Connection Proxyを利用できます。
Agent → Databricks認証 → Connection Proxy → 外部API
AgentはDatabricksへ認証し、Proxyが外部サービス用資格情報を付与します。
外部APIキーをAgentに持たせずに済みます。ただし通信先の制限にはネットワークポリシーも必要です。
6. Connection・Tool・Skillの違い
混同しやすい3つの役割を整理します。
| 要素 | 主な役割 |
|---|---|
| Connection | どこへ・どう認証して接続するか |
| Tool | 接続先で何を実行できるか |
| Skill | Toolをどう組み合わせて業務を進めるか |
CRM接続だけでは顧客検索はできません。検索操作をToolに、業務手順をSkillに定義します。
まとめると
- Connectionで接続情報と認証情報を共通管理する
- 外部DBはForeign Catalogと組み合わせて参照する
- REST APIや外部MCPはHTTP Connectionを利用する
-
USE CONNECTIONなどで利用主体を制限する - Connection Proxyで資格情報の直接配布を減らす
ConnectionはAgentの能力ではなく、安全な外部接続の土台です。共有資産化すれば、Agentが増えても管理を集約できます。
