도구 업데이트

PATCH

/v1/convai/tools/:tool_id

PATCH

/v1/convai/tools/:tool_id

curl -X PATCH https://api.elevenlabs.io/v1/convai/tools/tool_id \
     -H "Content-Type: application/json" \
     -d '{
  "tool_config": {
    "type": "client",
    "description": "description",
    "name": "name",
    "expects_response": false
  }
}'

{
  "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입니다.

요청

에이전트가 LLM에 제공할 수 있는 도구입니다.

tool_configobject필수

도구 구성

response_mockslist of objects선택 사항

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

응답

성공 응답

idstring

tool_configobject

도구 유형

access_infoobject

usage_statsobject

response_mockslist of objects선택 사항

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

오류

422

Tools Update Request Unprocessable Entity Error

경로 매개변수

헤더

요청

응답

오류