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ừ 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.
- Runs and usage
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 đã dùng trong tuần thanh toán hiện tại và số tiền tương ứng.
- 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.
Tích hợp mọi nơi
- In your software
Add a reasoning step to an existing screen: a summary, a suggested reply, a classification.
- Trong các tự động hóa của bạn
A script or an automation tool launches a run at each event: a form received, a file dropped.
- Từ câu trả lời này sang câu trả lời tiếp theo
Kết quả của một lần chạy có thể trở thành trường của lần tiếp theo: mã của bạn nối các bước như mong muốn.
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.
Những gì bạn gửi
{
"app_id": "mapp_0ceacb46e5b3a99e91b6",
"data": {
"message": "My parcel has not arrived and the tracking has not moved for a week."
}
} Những gì bạn đọc lại
{
"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.
The runs your software started, one by one
Every call made through the API appears in the reasonings list, marked API, with its duration and its tokens. Each application shows the identifier your software calls.
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.
- Refusals are explicit
A call that cannot be accepted, for example while an invoice is overdue, is refused with its own status code.
Nhận khóa
API access is included with Ultineo Reasoning. There is no self-service sign-up: our team opens your project and hands you its first key.
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
Yes. Every project can call the API; a call is billed like any other run, on the tokens it uses.
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ó.