도구 가져오기

GET

/v1/convai/tools/:tool_id

GET

/v1/convai/tools/:tool_id

curl -G https://api.elevenlabs.io/v1/convai/tools/tool_id \
     -d environment=environment

{
  "id": "id",
  "tool_config": {
    "type": "client",
    "description": "description",
    "name": "name",
    "assignments": [
      {
        "dynamic_variable": "user_name",
        "value_path": "user.name",
        "source": "response",
        "sanitize": false,
        "preserve_native_type": false
      }
    ],
    "dynamic_variables": {
      "dynamic_variable_placeholders": {
        "user_name": "John Doe"
      }
    },
    "execution_mode": "immediate",
    "expects_response": false,
    "interruption_mode": "allow",
    "parameters": {
      "description": "description",
      "dynamic_variable": "dynamic_variable",
      "constant_value": {
        "key": "value"
      },
      "is_omitted": true,
      "type": "object",
      "required": [
        "required"
      ],
      "properties": {
        "key": {
          "description": "A user-provided message",
          "type": "string"
        }
      }
    },
    "pre_tool_speech": "auto",
    "response_timeout_secs": 1,
    "tool_call_sound": "typing",
    "tool_call_sound_behavior": "auto",
    "tool_error_handling_mode": "auto"
  },
  "access_info": {
    "is_creator": true,
    "creator_name": "John Doe",
    "creator_email": "john.doe@example.com",
    "role": "admin",
    "anonymous_access_level_override": "admin",
    "access_source": "creator"
  },
  "usage_stats": {
    "avg_latency_secs": 1.1,
    "total_calls": 1
  },
  "response_mocks": [
    {
      "mock_result": "mock_result",
      "parameter_conditions": [
        {
          "eval": {
            "type": "anything"
          },
          "path": "path"
        }
      ],
      "is_error": true
    }
  ]
}

워크스페이스에서 사용할 수 있는 도구를 가져옵니다.

경로 매개변수

tool_idstring필수

요청한 도구의 ID입니다.

쿼리 매개변수

environmentstring선택 사항기본값 production

MCP 서버 URL, 헤더 또는 인증 연결에서 환경 변수를 참조할 때 값을 사용할 환경입니다. 대화가 실행되는 환경을 반영하며, 기본값은 production입니다.

응답

성공 응답

idstring

tool_configobject

도구 유형

access_infoobject

usage_statsobject

response_mockslist of objects선택 사항

선택적 파라미터 조건이 있는 모의 응답입니다. 위에서 아래 순서로 평가하며, 처음 일치하는 항목이 적용됩니다.

오류

422

Tools Get Request Unprocessable Entity Error