도구 호출

애플리케이션 또는 공급자가 작업을 실행하고 결과를 반환합니다. 도구 호출을 제안하는 모델은 호출이 성공하는 것과 다르며, 둘 다 사용자의 전체 작업이 완료되는 것과 다릅니다.

주요 시사점

• 권위와 주장의 형태를 검증합니다.
• 부작용에 대비한 안전한 재시도를 설계하세요.
• 결과 상태를 확인합니다.

각 도구의 목적, 입력 스키마, 출력 형태 및 부작용을 정의합니다. 좁은 범위의 작업은 일반 명령 인터페이스보다 유효성을 검사하기가 더 쉽습니다. 도구 설명은 사용자의 요청을 넘어서는 모델 권한을 부여하지 않고 작업이 적절한 경우를 설명해야 합니다. 애플리케이션 코드의 입력 및 권한을 검증합니다. 올바른 형식의 인수라도 잘못된 계정, 대상 또는 금액을 식별할 수 있습니다. 도구 설명에 비밀을 유지하고 요청하는 사용자가 액세스할 수 있는 정보만 반환합니다. 오류와 불확실한 결과를 명시적으로 처리합니다. 외부 작업이 완료되기 전이나 후에 네트워크 시간 초과가 발생할 수 있습니다. 가능한 경우 작업 식별자 또는 다시 읽기 확인을 사용하여 재시도가 완료된 작업을 복제하지 않도록 하세요. 실행 후 정확한 결과를 제공하고 의도한 상태를 확인합니다. 웹사이트나 문서에서 반환된 텍스트를 신뢰할 수 없는 콘텐츠로 처리합니다. 단지 도구를 통해 도착했다는 이유만으로 새로운 작업을 승인할 수는 없습니다. 전체 도구 사용 루프의 일부로 테스트 취소, 잘못된 응답, 액세스 취소 및 부분 완료를 테스트합니다.

1. 작업 생성 도구가 요청 식별자 데모-17을 수락한다고 상상해 보세요. 작업이 생성된 후 응답 시간이 초과됩니다.
2. 다른 작업을 생성하기 전에 데모-17을 찾아보세요. 서비스가 멱등성을 지원하는 경우 재시도에 동일한 식별자를 재사용합니다.
3. 결과 작업과 내용을 확인한 후에만 완료를 보고하십시오.

이 구성된 예는 불확실한 전송을 외부 활동의 실제 결과와 분리합니다.