Agent Insight Monitors
create
Create an Agent Insights monitor for an agent.
查詢參數
api-version
string
必要
The API version to use for this operation.
要求本文
agent_name
string
必要
The agent this monitor should analyze.
enabled
boolean
Whether scheduled insight generation should be armed. Defaults to false.
run_interval_hours
number
Interval between scheduled insight runs, in hours. Defaults to 6.
model_deployment_name
string
必要
The model deployment to use for analyzing traces. Accepts either the deployment name alone or with the connection name as '{connectionName}/modelDeploymentName'.
priorities
AgentInsightPriorities
Monitor analysis priorities.
categories
string[]
必要
Up to 20 distinct normalized category identifiers (128 UTF-8 bytes each). Empty uses defaults.
instructions
string | null
Analysis guidance, up to 2,000 UTF-8 bytes after trimming. Null or blank removes guidance.
回覆
The request has succeeded and a new resource has been created as a result.
標題
Location
string
必要
URL of the created monitor.
主體
id
string
必要
The monitor identifier.
agent_name
string
必要
The agent this monitor analyzes. There can be only one monitor per agent.
enabled
boolean
必要
Whether scheduled insight generation is armed for the monitor.
run_interval_hours
number
必要
Interval between scheduled insight runs, in hours.
model_deployment_name
string
必要
The model deployment to use for analyzing traces. Accepts either the deployment name alone or with the connection name as '{connectionName}/modelDeploymentName'.
estimated_cost
AgentInsightEstimatedCost
Estimated Agent Insights cost.
amount
number
必要
Estimated cost amount.
currency
enum
必要
Currency for the estimated cost amount. Agent Insights estimates are reported in US dollars.
suspension
AgentInsightSuspension | null
必要
Why the system suspended scheduled generation. Null when the monitor is not suspended.
code
string
必要
Stable, machine-readable suspension category.
message
string
必要
Human-readable description of the suspension.
details
object
Additional reason-specific suspension details.
agent_summary
AgentInsightSummary
Service-generated agent summary.
markdown
string
必要
Summary in Markdown.
priorities
AgentInsightPrioritiesRead
Monitor analysis priorities returned by the service.
categories
string[]
必要
Up to 20 distinct normalized category identifiers. Can include legacy names containing commas. Empty uses defaults.
instructions
string
Analysis guidance. Omitted when unavailable.
Request
POST /agent_insight_monitors HTTP/1.1
回應
Status: 201
Content-Type: application/json
Status: 4XX
Content-Type: application/json
Status: 5XX
Content-Type: application/json