在管理的代理目录中查找和使用代理和工具

您可以在受管代理目录中找到受管代理和工具，然后将这些代理和工具纳入您的 gen AI 解决方案中。

目录可包含以下类型的条目：

人工智能代理是一个软件实体，可定义自身的配置、能力以及与输入、工具和环境的交互。您的组织可以为代理添加代码或端点。
工具是一种功能或程序，特工可以调用它来执行任务。 IBM 提供了一套精心策划的工具。您的组织可以添加自定义工具。

目录中的代理或工具条目包括加载和运行该代理或工具所需的所有元数据。

需求

您必须是默认清单或任何其他清单中具有任何角色的协作者，才能访问受管理的代理目录。

查找和查看代理或工具

查找和查看代理或工具：

从导航菜单中选择人工智能治理 > 受管代理目录。
浏览代理和工具、设置过滤器或输入搜索关键词。您可以按提供商名称、 清单 ID、类别、框架或运行时详细信息进行筛选。您可以在名称、描述和摘要字段中进行搜索。您可以按照最后修改时间、 工具名称或代理名称 ，以升序或降序对清单中的代理和工具进行排序。
单击代理或工具旁边的箭头图标，打开详细信息页面。

比较代理或工具

您可以比较两个代理或两个工具的用户定义指标，如准确性、延迟、成本、安全分数和自定义指标分数。

比较两种代理或两种工具：

从导航菜单中选择人工智能治理 > 受管代理目录。
找到要比较的第一个代理或工具，然后单击代理或工具磁贴上的三点菜单 (⋮)。
从下拉菜单中单击 " 选择比较 "，然后所有代理和工具磁贴上都会出现复选框。
点击要比较的代理或工具的复选框。
单击 " 比较 "查看并排比较。

加载和调用代理和工具

要在代理应用程序中加载和调用代理或工具，请调用 watsonx.governance Python SDK 中的代理调用 invoke API 调用或工具调用工具加载器。 SDK 从清单中读取代理或工具元数据（代码或端点），按名称加载代理或工具，使用用户输入启动代理或工具，并返回响应。

要使用 watsonx.governance Python SDK 加载代理，请运行

from ibm_watsonx_gov.agent_catalog.core.agent_loader import load_agent
agent = load_agent(agent_name=<AGENT_NAME>)
response = agent.invoke({"<placeholder property name>": "<placeholder property value>"})

要加载工具，请运行

from ibm_watsonx_gov.tools import load_tool
tool = load_tool(tool_name=<TOOL_NAME>)
tool.invoke({"<placeholder property name>": "<placeholder property value>"})

开箱即用 (OOTB) 工具

以下工具已从目录中准备就绪，可随时使用。

天气: 获取指定地点的天气信息。
Web 搜寻器: 获取特定网页的内容。
维基百科搜索: 使用维基百科网站返回给定查询的结果。
DuckDuckGo 搜索: 使用 DuckDuckGo 搜索引擎来获取给定查询的结果。
Google搜索: 使用 Google 搜索引擎来获取给定查询的结果。
Chroma Vector DB: 查询并搜索 Chroma Vector 商店，以从数据库中获取结果。
JailBreak 探测器: 该工具可检测输入提示中的越狱尝试。越狱是一种提示符注入技术，旨在绕过安全防护措施、突破限制或操控系统行为。检测这些情况可确保交互过程安全、合规，并符合预期用途。
HAP 探测器: 该工具可检测用户输入中的仇恨言论、辱骂性语言和粗俗用语。该系统会分析文本中是否存在针对个人或群体的有害、冒犯性或贬损性表述，这些表述可能基于种族、性别、宗教或其他个人特征。该工具通过阻止互动中出现有害或不安全的言论，有助于维护一个相互尊重且专业的环境。
个人身份信息检测器: 该工具可检测用户输入中的个人身份信息（PII）。它会分析文本，以识别姓名、地址、电话号码、电子邮件地址及其他个人信息等敏感内容。该工具旨在通过识别和处理可能泄露个人身份的信息，从而保障隐私并确保合规。