View a markdown version of this page

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

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

管理自定义代理

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

编辑自定义代理

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

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

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

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

  3. 在代理详细信息页面上,选择编辑。

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

  5. 修改要更新的字段:

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

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

    • 技能 — 使用搜索字段添加或删除技能。

    • 内存存储 -使用搜索字段添加或移除代理可以访问的内存存储。

  6. 选择保存。

未修改的字段会保留其当前值。除非您对其进行更改,否则会保留代理分配的工具和附加的内存存储区。

要使用 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.
Attach the payments-runbook memory store to certificate-checker, and remove the directives store.

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

查看调用历史记录

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

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

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

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

  3. 选择 History 选项卡。

调用表显示以下信息:

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

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

调用状态:

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

查看调用轨迹

调用轨迹显示了代理工作的完整追踪——代理在单次调用期间产生的每一次工具调用、结果和文本输出。

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

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

  2. 查看轨迹时间表。

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

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

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

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

  • 生成的输出 -代理生成的任何项目或建议,以链接形式显示在时间表的末尾。

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

删除自定义代理

重要

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

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

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

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

Delete the custom agent weekly-health-report.

在删除之前,聊天会确认代理名称和类型。如果代理具有活动触发器,则它们将与代理一起删除。