View a markdown version of this page

管理自定义代理 - AWS DevOps 代理人

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

管理自定义代理

创建自定义代理后,您可以编辑其配置,查看其调用历史记录,并在不再需要时将其删除。

编辑自定义代理

您可以使用表单或通过聊天编辑自定义代理。该表单允许您更新姓名、系统提示和技能。要修改代理的工具,请使用聊天。

要使用表单编辑自定义代理,请执行以下操作:

  1. 在您的代理 Web 应用程序中导航到 DevOps 代理页面。

  2. 选择要编辑的自定义代理。

  3. 在代理详情页面上,选择编辑

  4. 在对话框中,选择 “表单”。

  5. 修改要更新的字段:

    • 名称-更新代理的标识符(与创建时限制相同:小写、连字符、最多 64 个字符)。

    • 系统提示-修改代理的指令(最少 10 个字符,最多 50,000 个字符)。

    • 技能-使用搜索字段添加或移除技能。

  6. 选择保存

您未修改的字段会保留其当前值。通过表单进行编辑时,会保留代理分配的工具。

要使用 Chat 编辑自定义代理,请执行以下操作:

您可以通过询问 Chat 来更新任何字段(包括工具)。例如:

Update weekly-health-report to also check for Lambda function errors.
Add the use_kubectl tool to my cluster-audit-agent.
Change the system prompt of certificate-checker to also report certificates expiring within 30 days.

Chat 会检索当前代理配置,应用您请求的更改,并在保存之前进行确认。您未提及的字段保持不变。

查看调用历史记录

代理详细信息页面显示自定义代理所有调用的完整历史记录,包括状态、触发源和时间戳。

要查看调用历史记录,请执行以下操作:

  1. 在您的代理 Web 应用程序中导航到 DevOps 代理页面。

  2. 选择要检查的自定义代理。

  3. 选择 History 选项卡。

调用表显示以下信息:

说明
调用 调用代理时提供的任务标题或描述。
Status 当前调用状态(见下文)。
触发者 调用是如何开始的 — 计划运行的触发器名称,或按需调用的 “手动”。
已启动 开始调用的日期和时间。
上次更新时间 最近一次状态变更的日期和时间。

您可以按状态筛选调用次数,也可以按标题进行搜索。该表每 10 秒自动刷新一次,以显示正在运行的调用的更新状态。

调用状态:

Status 说明
待启动 调用已排队等待调度。
运行 代理正在积极执行。
成功 调用成功完成。
失败 调用遇到错误并停止。
已超时 调用超过了 1 小时的超时限制。
已取消 调用在完成之前被手动取消。

查看调用轨迹

调用轨迹显示代理工作的完整轨迹,即代理在一次调用期间生成的每个工具调用、结果和文本输出。

要查看调用轨迹,请执行以下操作:

  1. 从 “历史记录” 选项卡中,选择要检查的调用。

  2. 查看轨迹时间表。

时间轴显示以下步骤类型:

  • 工具调用-代理调用了哪些工具以及使用了哪些参数。

  • 工具结果-每个工具返回的响应。

  • 文本输出-代理在调用期间生成的消息。

  • 生成的输出-代理生成的任何构件或推荐,在时间轴末尾显示为链接。

对于正在运行的调用,轨迹会实时更新。您可以通过选择轨迹视图顶部的 “取消” 来取消正在运行的调用。

删除自定义代理

重要

删除自定义代理不会影响已在进行的调用。正在运行的调用会一直持续到它们完成、超时或被取消。但是,删除后无法再次调用该代理。

您可以使用 Chat 删除自定义代理。删除是永久性的,无法撤消。

要删除自定义代理,请执行以下操作:

让 Chat 按姓名删除代理。例如:

Delete the custom agent weekly-health-report.

聊天确认代理人姓名和类型,然后再删除。如果代理有活动触发器,则会将其与代理一起删除。