注意：以下翻译的准确性尚未经过验证。这是使用 AIP ↗ 从原始英文文本进行的机器翻译。
定义建模目标 API
以下文档描述了在建模目标中将模型绑定到Ontology，这在大多数应用案例中已不再推荐。请考虑直接将模型以函数形式部署，以便在下游应用中使用模型，包括Workshop、Slate、操作以及更多。
为了指定用户或应用程序应如何在Foundry中使用您的建模目标，您可以为您的目标创建一个API。
要为新目标定义输入和输出API，选择建模目标详情并编辑目标API部分。这将带您进入如下所示的定义建模目标API页面：
在左侧面板（如上所示）标记为定义初始目标API中，您可以选择以下方法之一来帮助开始填充建模目标API（或者您可以在右侧手动定义输入和输出）：
- 如果您选择Object类型，请继续查看映射目标API到Ontology的文档。
- 如果您已经有一个想要提交到此目标的模型，可以通过选择模型并按照下面的步骤从模型的API开始。目前，此工作流程仅支持Ontology支持的模型。
- 如果您希望目标API的输入或输出基于任何现有Foundry数据集的列，选择数据集将使您可以轻松创建基于这些列的属性，如此处文档中所述。
手动定义API输入和输出
要手动定义API，您可以直接指定输入和输出属性，然后选择一个Object类型以将属性映射到Ontology。
点击“添加输入”或“添加输出”按钮，并指定属性名称、类型和非必填的描述。类型应为以下之一：
booleandatetimedoublelongintegerstring
如果预期属性的类型未知，应使用any类型。
定义输入和输出属性后，您可以选择将它们映射到Object属性，如下一节所述。
API定义了提交到建模目标的任何模型的输入和输出格式。输入将作为单一数据框给出，并且该数据框的列名应与上图所示的输入部分中给定的名称相匹配。同样，建模目标将期望模型的输出数据框具有与输出中指定的列匹配的列。
将您的目标API映射到Ontology
您可以通过将每个字段映射（也称为绑定）到Ontology中的Object属性，为目标API中的每个字段提供附加的元数据。如果建模目标应使用来自Ontology的数据，或者将被用于支持由Ontology支持的操作应用程序，强烈建议进行属性映射。
例如，在Workshop应用中使用场景需要将您的目标API映射到Ontology。这是因为场景将在执行您的模型时使用这些输入映射来获取适当的输入数据，并使用输出映射来确定要覆盖的本体属性。
下图说明了输入和输出属性的映射含义：
- 对于输入属性，这表明该属性的数据应从映射的Object类型和属性中提取。
- 对于输出属性，这表明该属性的模型输出必须与映射的Object类型属性兼容，并且可能会写入该属性。
Ontology映射可被操作应用用于获取模型的输入，并随后用模型的输出覆盖Ontology属性。因此，如果您添加Ontology映射，了解应用可能如何使用您的目标非常重要。
要映射到Object属性，您可以在左侧选择“Object类型”，或在右上角切换“映射到Ontology”开关。从那里，选择您想映射到的“根”Object类型。可用于映射的Object属性将是此对象上的属性，以及任何通过多对一关系链接到所选对象的对象。
选择Object类型后，该Object类型的所有属性将可用于映射。要映射属性，请单击属性旁边的输入或输出按钮：
属性类型也可以通过左侧的拖动手柄拖动到输入或输出部分。
Object类型的所有属性也可以一次性添加，通过左侧的拖动手柄拖动整个Object卡片。
要从链接的Object类型映射属性，请滚动到左侧边栏的底部。如果有可用的链接对象，将显示添加链接对象类型按钮。选择该按钮并选择链接的Object类型。
该链接对象的属性现在可用于映射：
默认情况下，映射的属性将与它们映射到的Object属性类型具有相同的名称、类型和描述。如有需要，可以更改名称和描述以更好地适应目标。
完成映射后，选择保存按钮以保存输入和输出API映射到目标。此API将记录提交到此目标的模型的预期输入和输出规范。
在任何时候选择保存都将保存目标API属性，并带您回到主建模目标页面。
从数据集列添加属性
从左侧的下拉菜单中选择数据集，以开始从现有Foundry数据集中向目标API添加属性。
使用选择数据集按钮浏览文件目录并找到您的数据集。
如果您想在默认分支以外的分支上使用数据集，请使用分支选择器菜单。
选择数据集后，您将看到数据集的所有列列在侧边栏中。
使用输入或输出按钮将列添加到目标API的输入或输出。属性也可以通过列名左侧的拖动手柄拖入。所有来自数据集的属性可以通过数据集名左侧的拖动手柄一次性添加。
如果列的基本属性类型是建模目标API支持的类型，将会列出。否则，将列为“any”。
要将您正在使用的数据集保存为目标的相关文件，选择添加为目标的相关文件。在任何时候，您可以通过在侧边栏中选择更改选择另一个数据集。您也可以通过选择映射到Ontology并按照映射Object属性的说明将属性映射到Ontology。
选择保存将在任何时候保存目标API属性，并带您回到主目标页面。
从模型添加属性
从左侧的下拉菜单中选择模型，以开始从现有模型向目标API添加属性。
使用选择模型按钮浏览文件目录并选择一个模型。
选择模型后，您将看到模型的所有输入和输出属性列在侧边栏中。
使用输入或输出按钮将列添加到目标API的输入或输出。属性也可以通过列名左侧的拖动手柄拖入。所有来自模型的属性也可以通过模型名左侧的拖动手柄一次性添加。
要将您正在使用的模型保存为目标的相关文件，选择添加为目标的相关文件。在任何时候，您可以通过在侧边栏中选择更改选择另一个模型。您也可以通过选择映射到Ontology并按照映射Object属性的说明将属性映射到Ontology。
点击保存将在任何时候保存目标API属性，并带您回到主目标页面。