HttpAgent
HttpAgent 继承 AbstractAgent,提供基于 HTTP 的远程智能体连接。它处理请求/响应周期,并把 HTTP 事件流转换为标准 AG-UI 事件。
import { HttpAgent } from "@ag-ui/client"配置
创建 HTTP 智能体时需要提供 HttpAgentConfig:
interface HttpAgentConfig extends AgentConfig {
url: string // 智能体服务的端点 URL
headers?: Record<string, string> // 可选 HTTP 请求头
}创建 HttpAgent
const agent = new HttpAgent({
url: "https://api.example.com/v1/agent",
headers: {
Authorization: "Bearer your-api-key",
},
})方法
runAgent()
向配置的端点发起 HTTP 请求以执行智能体。
runAgent(parameters?: RunAgentParameters, subscriber?: AgentSubscriber): Promise<RunAgentResult>parameters 遵循标准 RunAgentParameters;可选 subscriber 可为本次运行单独提供订阅者。
返回值
interface RunAgentResult {
result: any // 智能体返回的最终结果
newMessages: Message[] // 本次运行新增的消息
}subscribe()
添加跨多次运行生效的订阅者。
subscribe(subscriber: AgentSubscriber): { unsubscribe: () => void }abortRun()
通过 AbortController 取消当前 HTTP 请求。
abortRun(): void受保护方法
requestInit()
配置 HTTP 请求。覆盖此方法可自定义请求方式。
protected requestInit(input: RunAgentInput): RequestInit默认实现:
{
method: "POST",
headers: {
...this.headers,
"Content-Type": "application/json",
Accept: "text/event-stream",
},
body: JSON.stringify(input),
signal: this.abortController.signal,
}run()
用 HTTP 请求实现 AbstractAgent 的抽象 run()。
run(input: RunAgentInput): RunAgent属性
url:智能体服务端点 URLheaders:随请求发送的 HTTP 头abortController:用于取消请求的AbortController
自定义请求
常见需求是动态注入鉴权令牌或追踪头:
class AuthedHttpAgent extends HttpAgent {
protected requestInit(input: RunAgentInput): RequestInit {
return {
...super.requestInit(input),
headers: {
...(super.requestInit(input).headers as Record<string, string>),
"X-Request-Id": crypto.randomUUID(),
},
}
}
}服务端应返回 text/event-stream,并按流式模式逐个发出事件。