API Ultineo Reasoning
Chạy các ứng dụng trong danh mục từ phần mềm của riêng bạn. API dùng JSON qua HTTPS, xác thực mọi lệnh gọi bằng khóa dự án và trả lời mọi lệnh gọi trong cùng một khuôn phản hồi.
Xây dựng quanh ứng dụng, lượt chạy và khóa
- Ứng dụng
Tạo ứng dụng từ một mô hình, các trường đầu vào và hướng dẫn của nó, sau đó liệt kê, xem và chỉnh sửa các ứng dụng của bạn.
- Lượt chạy và hạn mức
Một lệnh gọi khởi chạy ứng dụng cùng dữ liệu đầu vào; lệnh gọi khác đọc lại lượt chạy cùng câu trả lời. Bản tóm tắt cho biết số token còn lại trong chu kỳ thanh toán của bạn.
- Khóa
Khóa dự án có phạm vi quyền, thời hạn tùy chọn và trạng thái bạn có thể tắt.
Integrate it anywhere
- In your software
Add a reasoning step to an existing screen: a summary, a suggested reply, a classification.
- In your automations
A script or an automation tool launches a run at each event: a form received, a file dropped.
- From one answer to the next
The answer of one run can become a field of the next: your code chains the steps as it sees fit.
The same run, through the API
Your software sends the application’s identifier and its fields, then reads the run back until it is finished.
What you send
{
"app_id": "mapp_0ceacb46e5b3a99e91b6",
"data": {
"message": "My parcel has not arrived and the tracking has not moved for a week."
}
}What you read back
{
"id": "runi_1b7f4e0c96a2d8531fca",
"object": "reasoning",
"status": "finished",
"response": { "miid_9a4c07e5b312df8641ca": "urgent" },
"tokens": { "input": 412, "output": 3, "total": 415 },
"duration": 1.84
}Xác thực và phạm vi quyền
- Khóa bearer
Gửi khóa dự án của bạn trong header Authorization của mọi lệnh gọi, chỉ qua HTTPS.
- Giới hạn trong một dự án
Mỗi khóa gắn với một dự án và không bao giờ có thể đọc hoặc ghi dữ liệu của dự án khác, dù yêu cầu là gì.
- Lưu dưới dạng giá trị băm
Chỉ giá trị băm của khóa được lưu giữ, vì vậy khóa chỉ được hiển thị đầy đủ một lần. Khóa bị mất sẽ được thay thế, không bao giờ được khôi phục.
Khởi chạy một lượt chạy và đọc câu trả lời
- Tạo
Nêu tên ứng dụng và cung cấp một giá trị cho mỗi trường đầu vào, gắn với tên trường mà ứng dụng trả về.
- Theo dõi
Lượt chạy là bất đồng bộ: hãy đọc lại lượt chạy cho đến khi trạng thái là hoàn tất hoặc thất bại. Cả hai đều là trạng thái cuối cùng.
- Đọc
Lượt chạy hoàn tất mang theo câu trả lời, thời lượng và số token đầu vào và đầu ra.
Một khuôn phản hồi cho mọi câu trả lời
- Cùng ba trường
Mọi câu trả lời đều mang mã trạng thái, một tiêu đề ngắn và phần phản hồi, dù thành công hay thất bại.
- Thông báo ổn định
Thông báo lỗi là các chuỗi tiếng Anh ổn định, nêu rõ phạm vi quyền còn thiếu hoặc giá trị bị từ chối.
- Giới hạn của gói được nêu rõ
Lệnh gọi không nằm trong gói, hoặc sẽ vượt quá hạn mức của gói, bị từ chối với mã trạng thái riêng.
Nhận khóa
Quyền truy cập API đi kèm các gói trả phí của Ultineo Reasoning. Hiện chưa có đăng ký tự phục vụ: đội ngũ của chúng tôi mở dự án của bạn và trao cho bạn khóa đầu tiên của dự án.
Kết nối phần mềm của bạn với Ultineo Reasoning
Hãy cho chúng tôi biết bạn muốn tự động hóa điều gì, chúng tôi sẽ mở dự án và khóa API của dự án cho bạn.
Câu hỏi về API
Các gói trả phí. Gói miễn phí cho phép truy cập các ứng dụng nhưng không có API.
Không. Chỉ dẫn thuộc về chủ sở hữu ứng dụng. API trả về các trường đầu vào, tức là những gì bên gọi điền vào.
Lệnh tạo lượt chạy trả về ngay với trạng thái mới. Hãy đọc lại lượt chạy cho đến khi hoàn tất để nhận câu trả lời.
Có. Mỗi khóa có phạm vi quyền và thời hạn tùy chọn, và một khóa không bao giờ có thể tạo khóa khác có phạm vi rộng hơn phạm vi của chính nó.