注意：以下翻译的准确性尚未经过验证。这是使用 AIP ↗ 从原始英文文本进行的机器翻译。
外部函数
外部函数允许您从一个函数调用webhooks，并使用它们与外部系统交互。您可以从使用Workshop、操作和函数构建的应用程序中调用这些系统。
要在函数中使用webhook，您必须首先配置支持webhooks功能的数据连接源。通常这将是一个REST API源。一旦您有了配置了webhooks的源，您可以将该源导入到您的函数库中，并创建调用webhooks和其他逻辑的函数。
您可以将外部函数应用于各种应用案例，包括以下内容：
- 使用一个单一函数向外部服务器发出HTTP请求并创建记录，然后将匹配的记录写入Ontology。
- 将webhook调用包裹在自定义前后处理逻辑中。如果需要从函数输入到所需webhook请求输入参数的自定义逻辑，或者在进行Ontology编辑之前需要对webhook响应进行后处理，这将特别有用。
- 使用中间处理逻辑将多个外部webhook请求和Ontology编辑连接在一起。单个webhook无法执行动态数量的外部请求，但可以使用外部函数来实现。
- 使用只读请求查询外部系统，以在Workshop应用程序中暂时呈现数据。
目前外部函数可能无法直接从TypeScript代码中进行任意API调用，而不首先在数据连接中将请求定义为webhook。
概念
- 数据连接源表示与外部系统的连接，包括如何到达该系统的任何配置（例如网络详细信息），以及安全存储的凭据。
- Webhooks是某些源类型支持的一项功能，允许您构建结构化请求以交互方式运行并向该系统发送请求。
- Ontology编辑函数是一个函数，可以稍后配置为基于函数的操作以写回到一个对象。它使用
@OntologyEditFunction()装饰器进行注释。 - 查询函数是一个只读函数，不能有任何副作用，比如改变外部系统。它使用
@Query()装饰器进行注释。
设置指南
在以下设置指南中，我们将逐步创建一个调用免费公共词典API ↗的webhook。如果您已经有一个配置了webhooks的现有源，请继续前往函数中的外部源以从函数中调用webhooks。
此处说明的词典API与Palantir无关，可能随时更改。本教程不构成对生产应用案例使用此API的认可、推荐或建议。
创建数据连接源
要从函数连接到外部系统，您必须具有一个可以连接到所需外部API的REST API源。您可以按照以下说明配置新的REST API源。
- 导航到Foundry中的数据连接应用程序并选择新建源。从选项列表中选择REST API。
-
查看概览页面，然后选择右下角的继续。系统将提示您选择连接运行时：直接连接，通过代理或通过代理代理。直接连接是与互联网可访问的任何事物交互时的首选方法，我们将使用它连接到我们的免费词典API。
-
为您的源选择一个名称，并选择应保存到的项目。
-
在域部分填写API源的连接信息。我们的免费词典API示例的配置如下所示：
- 对于此示例，我们还需要创建必要的出口策略。如果您完成了上一步，策略将在网络连接部分中自动建议：
- 选择保存，然后选择保存并继续以完成源设置。在我们配置要在此源上使用的webhook之前，请返回源的概览页面并确保设置了API名称。此名称用于在代码中引用源。
在数据连接源上创建webhook
现在，您必须在之前配置的REST API源上设置webhook。在您可以从函数中调用webhook之前，您必须配置webhook并为其指派API名称。一个数据连接源可能有多个与之关联的webhooks。请注意，您的源API名称在命名空间中应是唯一的，并且webhook API名称在源中必须是唯一的。
请按照以下步骤配置一个webhook，以请求词典API来获取单个单词的定义。
- 在源的概览页面上，选择创建webhook。为webhook命名、描述并指定API名称。与API源一样，我们将在代码中引用webhook。
- 定义一个在执行webhook时传入的参数。在我们的示例中，我们将使用一个单一字符串输入参数
wordToDefine。
- 现在，在URL中填入词典资源路径，并在最后引用输入参数，如下所示：
在我们的示例中，API是一个不修改任何数据的GET请求。因此，我们将保留默认设置Read API，允许webhook在两种类型的函数中使用：@Query()和@OntologyEditFunction()。标记为Write API的webhooks可能只能在@OntologyEditFunction()中使用。
- 在下一页面，您将看到一个面板，允许您以当前配置执行webhook。如果您运行webhook，您将看到未解析的响应：
- Webhooks允许从外部系统返回的响应对象中提取字段，并根据类型化模式解析字段。在此示例中，我们将提取每个返回词性的一组定义。运行webhook以确保对常见单词（例如“technology”）返回一些输出。
一旦保存了webhook，它便可在整个平台上使用。
下一步
要开始在函数中使用此源，请继续查看函数中的外部源指南。