에이전트 랩에서 사용자 지정 도구 만들기

마지막 업데이트 날짜: 2025년 5월 27일

watsonx.ai 가 Agent Lab에서 제공하는 도구 외에도, 사용자 지정 입력을 받아 특정 출력을 생성하는 자신만의 도구를 만들 수도 있습니다. 에이전트는 에이전트 구성의 다른 도구와 함께 사용자 지정 도구를 사용하여 사용자의 질문에 대한 답변을 생성할 수 있습니다.

시작하기 전에

에이전트 랩에서 사용자 지정 도구를 만들기 전에 배포 공간에 Python 통역사 AI 서비스 에셋을 배포해야 합니다. 배포 스페이스를 만드는 방법에 대한 자세한 내용은 배포 스페이스의 자산을 참조하세요.

맞춤형 도구 구성하기

에이전트 랩에서 사용자 지정 도구를 생성하려면, 에이전트 프레임워크가 도구를 등록하고 실행하는 데 사용하는 다음과 같은 세부 사항을 정의해야 합니다

사용자 지정 도구를 설정하려면 이름을 지정하고 도구가 수행하는 주요 기능을 설명합니다.
중요 : 사용자 지정 도구의 기능에 대한 자세한 설명을 제공하십시오. 여기에는 허용되는 입력 내용과 도구 응답 형식이 포함됩니다. 이 정보는 에이전트 프레임워크가 에이전트의 최종 응답을 생성하기 위해 툴을 사용할지 여부를 결정하기 위해 기초 모델에서 입력 컨텍스트로 사용됩니다.
사용자 지정 도구가 받아들이는 입력 형식을 JSON 스키마로 정의합니다. 각 입력에 대한 변수 이름, 입력의 의미, 입력의 데이터 유형을 지정합니다.
JSON 스키마에 정의된 입력 변수를 인수로 받아들이고 특정 응답을 반환하는 함수( Python )를 정의합니다. 해당 기능이 충족해야 하는 요구 사항에 대한 자세한 내용은 Python function specifications를 참조하십시오.
선택 사항 : 예제 입력을 제공하고 사용자 지정 도구를 실행하여 함수가 올바른 결과를 생성하는지 확인함으로써 함수를 테스트하고 디버깅할 수 있습니다.
생성을 클릭하여 사용자 지정 도구를 상담원에게 추가합니다.
선택 사항: 구성 아이콘( )을 클릭하여 사용자 지정 도구 구성을 업데이트할 수 있습니다.

Python 기능 사양

에이전트 프레임워크가 사용자 지정 도구를 사용하여 결과를 생성할 때 실행되는 Python (결과 생성) 함수를 정의해야 합니다. 함수 정의는 다음 사양을 충족해야 합니다

사용자 지정 도구의 작업을 수행하는 핵심 로직을 포함하는 하나의 Python 함수만 정의할 수 있습니다.
한 번에 한 세트의 입력으로만 기능을 테스트할 수 있습니다. 다른 값 집합을 테스트 입력으로 사용하려면 테스트 입력 JSON 스키마를 수동으로 편집하고 코드를 다시 실행해야 합니다.
Python 의 코드 패키지는 설치할 수 없지만, watsonx.ai 에 포함된 패키지는 가져올 수 있습니다.

포함된 패키지 목록을 보려면:
1. 프로젝트의 홈 페이지에서 관리 탭을 클릭합니다.
2. 환경을 클릭한 다음, 템플릿 탭을 클릭합니다
3. Python 에서 Runtime 24.1 를 열고 3.11 S 템플릿을 실행하면 Python 패키지 목록을 볼 수 있습니다.

에이전트 랩에서 만든 사용자 지정 도구의 예

사용자 지정 도구를 만들기로 선택하면 정의 페이지 에서 점진적으로 도구를 개발할 수 있습니다. 도구가 수용하는 입력 유형을 지정하고 에이전트 프레임워크가 사용자 지정 도구를 호출할 때 실행되는 함수( Python )를 정의해야 합니다. 테스트 페이지 에서 샘플 테스트 입력을 제공하고 코드를 검증하기 위해 함수를 실행할 수 있습니다.

다음 예는 두 정수의 곱을 계산하는 사용자 지정 도구를 정의합니다. 각 입력 매개변수를 지정하고 각 입력을 받아 곱셈 연산을 수행하는 함수( Python )를 정의합니다.

사용자 지정 도구의 이름을 지정하고, 입력 및 출력 형식, 도구가 수행하는 주요 작업 등 도구에 대한 자세한 설명을 제공하십시오. 예를 들어,

Name: Multiple numbers

Description: Use this tool when multiplying two numbers. The tool consists of a Python function named "multiply". The function takes two parameters, "number_1" and "number_2". Both parameters are expected to be numerical values, which can only be integers numbers.
The tool's primary operation is to multiply two input numbers by using the '*' operator in Python, which performs multiplication. The result of the operation is returned as the output of the tool.

Python 함수의 입력 매개변수를 정의하는 JSON 스키마를 제공하십시오. 여기에는 각 매개변수의 이름, 데이터 유형, 설명이 포함됩니다

{
"number_1": {
    "title": "Number 1",
    "description": "The first number to multiply",
    "type": "integer"
},
"number_2": {
    "title": "Number 2",
    "description": "The second number to multiply",
    "type": "integer"
}
}

두 개의 숫자를 입력으로 받아 그 값을 곱한 다음 결과를 반환하는 함수( Python )를 정의합니다.
```
def multiply (number_1, number_2):
  return number_1 * number_2
```
테스트 페이지 에서는, Python 함수의 인수로 정의한 JSON 스키마를 기반으로 테스트 입력에 대한 JSON 스키마가 자동으로 생성됩니다. 함수에 다음과 같이 두 개의 정수를 입력하십시오
```
{
"number_1": 4,
"number_2": 5
}
```
실행을 클릭하여 코드를 테스트하고 결과를 검증합니다. 결과 창에 제품이 20으로 표시됩니다.

상위 주제: 에이전트 연구소

주제가 도움이 되었습니까?

0/1000