>-
from azure.identity import DefaultAzureCredential
from agent_framework.foundry import FoundryChatClient
# クライアント作成
client = FoundryChatClient(
project_endpoint=os.environ["AZURE_AI_PROJECT_ENDPOINT"],
model=os.environ["MODEL_NAME"],
credential=DefaultAzureCredential(),
)
# エージェント作成
agent = client.as_agent(
name="data-search-agent",
instructions="あなたは旅行データの分析エージェントです。",
tools=[search_sales_history, analyze_trends],
)
# 実行
result = await agent.run("沖縄の夏季売上データを分析して")
from agent_framework import tool
@tool
async def search_sales_history(
query: str,
season: str | None = None,
region: str | None = None,
) -> str:
"""Fabric Lakehouse の sales_history を SQL EP 経由で検索する。
Args:
query: 検索クエリ
season: 季節フィルタ（spring/summer/autumn/winter）
region: 地域フィルタ
"""
# SQL EP 経由でクエリ実行
...
from agent_framework.orchestrations import SequentialBuilder
workflow = SequentialBuilder(
participants=[
data_search_agent, # Agent1
marketing_plan_agent, # Agent2
regulation_agent, # Agent3
brochure_agent, # Agent4
]
).build()
result = await workflow.run("沖縄3泊4日の夏季ファミリー向け企画を作って")
from agent_framework import Middleware
class ContentSafetyMiddleware(Middleware):
"""入力時に Content Safety チェックを実行する middleware"""
async def on_request(self, context, call_next):
# Prompt Shield チェック
is_safe = await check_prompt_shield(context.input)
if not is_safe:
raise ValueError("入力が Content Safety チェックに失敗しました")
# 次の middleware / エージェントに渡す
return await call_next() # 引数なし
from agent_framework import load_settings
from typing import TypedDict
class AppSettings(TypedDict):
project_endpoint: str
model_name: str
content_safety_endpoint: str
settings = load_settings(AppSettings)
| ✅ 正しい | ❌ 間違い |
|---|---|
FoundryChatClient | AzureOpenAIResponsesClient |
client.as_agent(...) | Agent(chat_client=...) |
@tool | @ai_function |
await agent.run("文字列") | agent.run(Message(...)) |
SequentialBuilder(participants=[...]).build() | .participants() fluent |
await call_next() | call_next(context) |
TypedDict + load_settings() | Pydantic Settings |
AZURE_AI_PROJECT_ENDPOINT / FOUNDRY_PROJECT_ENDPOINT | AZURE_OPENAI_ENDPOINT |