AI가 도구 파라미터를 지정하도록 하기
Tools Agent에 연결된 도구를 구성할 때, 많은 파라미터를 AI 모델 자체가 채울 수 있습니다. 이를 수행하는 두 가지 방법이 있으며, 두 방법 간에 전환할 수 있습니다. 도구의 편집 대화 상자에서 적절한 각 파라미터 필드 끝에 추가 버튼이 있습니다:
Tools Agent에 연결된 도구를 구성할 때, 많은 파라미터를 AI 모델 자체가 채울 수 있습니다. AI 모델은 작업의 컨텍스트와 다른 연결된 도구의 정보를 사용하여 적절한 세부 정보를 채웁니다.
이를 수행하는 두 가지 방법이 있으며, 두 방법 간에 전환할 수 있습니다.
모델이 파라미터를 채우도록 하기#
도구의 편집 대화 상자에서 적절한 각 파라미터 필드 끝에 추가 버튼이 있습니다:
이 버튼을 활성화하면, AI Agent가 추가적인 사용자 입력 없이 표현식을 자동으로 채웁니다. 필드 자체는 해당 파라미터가 모델에 의해 자동으로 정의되었음을 나타내는 메시지로 채워집니다.
파라미터를 직접 정의하려면 이 상자의 'X'를 클릭하여 사용자 정의 값으로 되돌리십시오. 'expression' 필드에는 이 기능이 생성한 표현식이 포함되어 있지만, 이제 다음 섹션에 설명된 대로 추가 세부 정보를 입력하기 위해 편집할 수 있습니다.
이 기능을 활성화하면 이미 수동으로 추가한 정의를 덮어씁니다.
$fromAI() 함수 사용하기#
$fromAI() 함수는 AI를 사용하여 Tools AI agent에 연결된 도구의 파라미터를 동적으로 채웁니다.
$fromAI() 함수는 AI Agent 노드에 연결된 도구에서만 사용할 수 있습니다. $fromAI() 함수는 Code 도구나 다른 비도구 클러스터 서브 노드에서는 작동하지 않습니다.
$fromAI() 함수를 사용하려면 필수 key 파라미터와 함께 호출하십시오:
{{ $fromAI('email') }}
key 파라미터와 $fromAI() 함수의 다른 인수들은 기존 값에 대한 참조가 아닙니다. 대신, 이 인수들을 AI 모델이 올바른 데이터를 채우는 데 사용하는 힌트로 생각하십시오.
예를 들어 email이라는 키를 선택하면, AI 모델은 컨텍스트, 다른 도구, 입력 데이터에서 이메일 주소를 찾습니다. 채팅 워크플로에서는 다른 곳에서 찾을 수 없는 경우 사용자에게 이메일 주소를 요청할 수도 있습니다. 선택적으로 AI 모델에 추가 컨텍스트를 제공하기 위해 description과 같은 다른 파라미터를 전달할 수 있습니다.
파라미터#
$fromAI() 함수는 다음 파라미터를 받습니다:
| 파라미터 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
key |
string | :white_check_mark: | 인수의 키 또는 이름을 나타내는 문자열. 길이가 1~64자 사이여야 하며 소문자, 대문자, 숫자, 언더스코어, 하이픈만 포함할 수 있습니다. |
description |
string | :x: | 인수를 설명하는 문자열. |
type |
string | :x: | 데이터 타입을 지정하는 문자열. string, number, boolean, 또는 json 중 하나일 수 있습니다 (기본값: string). |
defaultValue |
any | :x: | 인수에 사용할 기본값. |
예시#
예를 들어, 다음 $fromAI() 표현식을 사용하여 필드에 이름을 동적으로 채울 수 있습니다:
$fromAI("name", "The commenter's name", "string", "Jane Doe")
선택적 파라미터가 필요 없다면 다음과 같이 간단하게 사용할 수 있습니다:
$fromAI("name")
재고 수량을 동적으로 채우려면 다음과 같은 $fromAI() 표현식을 사용할 수 있습니다:
$fromAI("numItemsInStock", "Number of items in stock", "number", 5)
필드의 일부만 모델의 동적 값으로 채우려면 일반 표현식에서도 사용할 수 있습니다. 예를 들어, 모델이 이메일의 subject 파라미터를 채우되 항상 생성된 값 앞에 'Generated by AI:' 문자열을 붙이려면 다음 표현식을 사용할 수 있습니다:
Generated by AI: {{ $fromAI("subject") }}
템플릿#
다음 템플릿에서 $fromAI() 함수가 실제로 동작하는 것을 확인할 수 있습니다: