사용자 지정 별칭과 환경별 구성

사용자 지정 별칭(Custom alias)은 구성 매개변수, 기능 플래그나 환경별 설정을 저장하는 이름 있는 문자열 값입니다. TypeScript v2와 Python 함수에서 코드와 환경 값을 분리할 수 있습니다. 모델 참조와 소스 참조는 각각 모델 별칭, 소스 별칭을 사용합니다.

생성과 수정

Resource imports의 Platform SDK 탭에서 Custom aliases를 찾습니다.

New alias를 선택하고 Key와 Value를 입력한 뒤 Create로 만듭니다. 키는 저장소 안에서 고유해야 합니다. 설명용 설정으로 myAlias에 someValue를 넣을 수 있습니다.

연필 아이콘은 값을 바꾸고 ... 메뉴는 키 변경이나 삭제를 제공합니다. 키를 바꾸면 코드에서 참조하는 키도 맞춰야 합니다.

함수에서 값 읽기

TSv2의 getCustomValue.ts 예제입니다.

import { Aliases } from "@osdk/functions";

export default function getCustomValue(): string {
    return Aliases.custom("myAlias");
}

Python에서는 custom을 사용합니다.

from functions.aliases import custom
from functions.api import function


@function
def get_custom_value() -> str:
    return custom("myAlias")

반환은 문자열입니다. 기능 플래그를 저장했더라도 Boolean 객체로 자동 바뀌는 계약은 아닙니다.

Marketplace 입력

별칭을 사용하는 함수를 제품에 넣으면 별칭이 Inputs의 구성 매개변수로 자동 나타납니다. 설치자는 코드를 바꾸지 않고 자신의 환경 값을 선택할 수 있습니다.

Inputs의 별칭을 선택하여 Details > General에서 의미와 입력 기준을 설명합니다.

Details > Presets의 Manual overrides에서 사전 선택 값을 구성할 수 있습니다.

설치자는 설명을 읽고 사전 값을 고르거나 값을 수동으로 구성합니다. 설치 후 함수는 그 값을 해소합니다.

연결 대상별 기능

외부 API는 소스의 전송 설정과 인증을 사용하며 웹훅은 선언한 입출력과 실행 권한을 따릅니다. Foundry 자체의 API는 Platform SDK, 언어 모델은 모델 프록시에서 각각 필요한 클라이언트와 권한을 확인합니다.