Tác tử AI

Tác tử AI là một trợ lý nhiều bước. Nó đọc cuộc hội thoại, lập kế hoạch, gọi công cụ (công cụ AI của bạn, công cụ MCP và tìm kiếm cơ sở tri thức), xem kết quả, rồi gọi lại mô hình cho đến khi có câu trả lời. Nút Tạo chat completion bằng AI chỉ gọi mô hình một lần rồi trả lời; nút Tác tử AI có thể tiếp tục xử lý qua nhiều lượt gọi mô hình và công cụ, trong các giới hạn bạn đặt, trước khi trả lời.

Hãy dùng tác tử khi một yêu cầu cần nhiều bước, ví dụ "tìm đơn hàng của khách, kiểm tra tình trạng giao hàng và đề xuất ngày giao mới". Với câu trả lời trực tiếp dựa trên hướng dẫn và cơ sở tri thức, nút AI đơn giản và rẻ hơn.

Các thành phần

Thành phần	Là gì	Nơi thiết lập
AI Harness	Bộ máy chạy vòng lặp của tác tử: của riêng MonoChat, một agent SDK hoặc một dịch vụ agent được lưu trữ.	Cài đặt › Tự động hóa › AI Harness
Mô hình	Các mô hình AI mà tác tử dùng để suy nghĩ: một mô hình chính, một mô hình dự phòng tùy chọn và một mô hình nhanh tùy chọn. Harness được lưu trữ dùng mô hình của nhà cung cấp riêng.	Nút Tác tử AI
Công cụ	Phạm vi AI, hàm Công cụ AI và công cụ MCP.	Nút Tác tử AI
Ngân sách thực thi	Giới hạn về lượt gọi mô hình, lượt gọi công cụ, token, thời lượng và số lần thử lại cho mỗi lượt chạy.	Nút Tác tử AI
Lượt chạy	Một lần thực thi của tác tử. Mọi lượt chạy đều được ghi lại trong Lượt chạy AI Agent.	Do nút hoặc API tạo ra

AI Harness

Cài đặt › Tự động hóa › AI Harness liệt kê các harness mà tác tử của bạn có thể chạy trên đó: những harness MonoChat cung cấp cho mọi không gian làm việc và những harness bạn thêm bằng thông tin xác thực của riêng mình.

Harness	Nơi chạy	Mô hình sử dụng	Ai thêm
MonoChat Native	Bên trong MonoChat	Mô hình AI của bạn	MonoChat
OpenAI Agents SDK	Bên trong MonoChat	Mô hình AI của bạn	MonoChat
Claude Agent SDK	Trên trình chạy tác tử của MonoChat	Mô hình AI của bạn	MonoChat
pi	Trên trình chạy tác tử của MonoChat	Mô hình AI của bạn	MonoChat
OpenAI Agents API	Trên đám mây của OpenAI	Các mô hình được phép của harness	Bạn, bằng khóa API OpenAI của bạn (MonoChat cũng có thể cung cấp một khóa)
Claude Managed Agents	Trên đám mây của Anthropic	Các mô hình được phép của harness	Bạn, bằng khóa API Anthropic của bạn (MonoChat cũng có thể cung cấp một khóa)
Custom Endpoint	Trên máy chủ của riêng bạn	Mô hình AI của bạn (tùy chọn)	Bạn, bằng điểm cuối và secret của bạn

Các harness chạy trên MonoChat do MonoChat cung cấp; không gian làm việc của bạn chỉ có thể thêm các harness dùng thông tin xác thực riêng. Claude Agent SDK và pi cần trình chạy tác tử của MonoChat: ở nơi chưa thiết lập trình chạy này, lượt chạy trên chúng sẽ thất bại với thông báo "Harness này không khả dụng trên máy chủ này."

Dù dùng harness nào, MonoChat vẫn nắm quyền kiểm soát: mọi lượt gọi mô hình của harness dùng mô hình AI của bạn đều đi qua MonoChat (nên tính phí và ngân sách đều được áp dụng), mọi lượt gọi công cụ chạy các hàm, công cụ MCP và phạm vi AI trong không gian làm việc của bạn, và ngân sách được thực thi trên mọi harness.

Thêm harness

Vào Cài đặt › Tự động hóa › AI Harness và bấm + (Tạo).
Nhập Tên và, nếu muốn, Mô tả.
Chọn Harness. Mỗi lựa chọn cho biết nơi nó chạy.
Trong Thông tin xác thực, nhập những gì harness cần:
- OpenAI Agents API, Claude Managed Agents: Khóa API.
- Custom Endpoint: Điểm cuối và Khóa API.
Với harness được lưu trữ, điền Mô hình được phép: nhập tên mô hình của nhà cung cấp (ví dụ ID mô hình của OpenAI hoặc Anthropic). Dùng Thêm mô hình để thêm tối đa 10 mô hình. Các tác tử trên harness này chỉ có thể chọn trong danh sách này.
Bấm Lưu.

Khi bạn sửa một harness, không thể đổi loại Harness, và trường khóa hiển thị Khóa API (để trống để giữ khóa đã lưu).

Claude Managed Agents

Lần đầu một harness loại này được sử dụng, MonoChat tạo một agent và một môi trường trong tài khoản Anthropic đó và dùng lại chúng về sau.

Custom Endpoint

Harness Custom Endpoint gửi các lượt chạy đến dịch vụ của riêng bạn, ví dụ một tác tử tự lưu trữ. Với mỗi lượt chạy, MonoChat gửi một POST đến <Endpoint>/runs kèm Authorization: Bearer <API Key>. Nội dung gồm ID lượt chạy, hướng dẫn, đầu vào, các tin nhắn hội thoại, ngân sách, các bí danh mô hình (agent-main, agent-fallback, agent-fast) và ba URL kèm token cho lượt chạy này:

một cổng mô hình (model gateway, các URL gốc tương thích OpenAI …/v1 và tương thích Anthropic) gọi các mô hình AI của nút và thực thi ngân sách,
một máy chủ MCP cung cấp các công cụ của lượt chạy,
một URL sự kiện để dịch vụ của bạn báo cáo kết quả (completed kèm result, hoặc failed kèm error).

Token của lượt chạy sẽ ngừng hoạt động khi lượt chạy kết thúc.

Nút Tác tử AI

Thêm tác tử vào luồng bằng nút Tác tử AI, trong nhóm nút lai (hybrid) ở trình thiết kế luồng. Xem Luồng để biết cách thêm và kết nối nút.

Các trường

Mục	Trường	Mô tả
	Tên	Tên nút hiển thị trên canvas.
	AI Harness	Bắt buộc. Harness chạy tác tử.
	Hướng dẫn	Hướng dẫn hệ thống của tác tử: vai trò, giọng điệu, quy tắc và những gì được phép hoặc không được phép làm.
	Nhiệm vụ (thêm vào hướng dẫn của tác tử; có thể dùng thẻ)	Việc nút này yêu cầu tác tử làm. Nó được thêm sau phần hướng dẫn và có thể dùng cùng các thẻ như câu lệnh của nút AI, ví dụ để đưa dữ liệu khách hàng vào.
Mô hình	Mô hình chính	Mô hình tác tử sử dụng. Bắt buộc với mọi harness trừ Custom Endpoint.
	Mô hình dự phòng (sau giới hạn mềm)	Mô hình mà tác tử chuyển sang khi đạt giới hạn mềm về số lượt gọi mô hình, thường là mô hình rẻ hơn hoặc nhanh hơn.
	Mô hình nhanh (tác vụ nền nhẹ)	Mô hình mà harness có thể dùng cho các lượt gọi nền nhẹ.
	Mô hình (một trong các mô hình được phép của harness)	Hiển thị thay cho ba trường trên đối với harness được lưu trữ.
Phiên tác tử	Phiên	Tiếp tục phiên tác tử hiện có (mặc định) hoặc Bắt đầu phiên tác tử mới. Xem Phiên tác tử.
	Khóa nhiệm vụ (phiên tác tử riêng cho mỗi nhiệm vụ)	Tùy chọn. Giữ một phiên tác tử riêng cho mỗi khóa trong cùng một cuộc hội thoại, ví dụ `booking` và `support`.
	Giới hạn lịch sử tin nhắn	Số tin nhắn hội thoại mà tác tử nhận được.
	Mô hình AI chuyển giọng nói thành văn bản	Một mô hình có Chuyển giọng nói thành văn bản. Tin nhắn thoại trong cuộc hội thoại đến với tác tử dưới dạng văn bản.
Cài đặt công cụ	Phạm vi AI	Các cơ sở tri thức mà tác tử có thể tìm kiếm. Chúng được cung cấp cho tác tử như một công cụ tìm kiếm cơ sở tri thức.
	Công cụ AI	Các hàm loại Công cụ AI mà tác tử có thể gọi.
	Thiết lập công cụ nội dung máy khách MCP AI	Mở ngăn nơi bạn thêm công cụ MCP. Xem Máy khách MCP.
Tin nhắn	Chuyển tin nhắn trung gian cho khách hàng	Mặc định tắt. Khi bật, những gì tác tử viết trong lúc còn đang xử lý (ví dụ "Để tôi kiểm tra đơn hàng của bạn") được gửi cho khách hàng; khi tắt, nó được thêm vào phiên dưới dạng tin nhắn thì thầm mà chỉ đội ngũ của bạn thấy.
	Gửi câu trả lời	Mặc định bật. Gửi câu trả lời cuối cùng của tác tử cho khách hàng. Tắt để chỉ dùng câu trả lời bên trong luồng.
Ngân sách thực thi	Số lần gọi mô hình tối đa	Mặc định 4.
	Giới hạn mềm: số lần gọi mô hình	Tùy chọn. Sau chừng này lượt gọi mô hình, tác tử chuyển sang mô hình dự phòng. Phải thấp hơn Số lần gọi mô hình tối đa và cần có mô hình dự phòng.
	Số lần gọi công cụ tối đa	Mặc định 6. Với `0`, lượt chạy kết thúc ở trạng thái Vượt ngân sách ngay khi tác tử cố gọi công cụ.
	Tổng token tối đa	Mặc định 20000. Token đầu vào và đầu ra của tất cả các lượt gọi mô hình trong lượt chạy.
	Thời lượng tối đa (giây)	Mặc định 30.
	Số lần thử lại tối đa	Mặc định 2. Số lần một lượt gọi mô hình thất bại được thử lại.

mẹo

Hãy viết các quy tắc ổn định trong Hướng dẫn và công việc cụ thể của bước này trong Nhiệm vụ. Nhờ vậy, nhiều nút Tác tử AI trong một luồng có thể dùng chung hướng dẫn và chỉ khác nhau ở nhiệm vụ.

cảnh báo

Harness được lưu trữ không hỗ trợ giới hạn mềm, vì chúng không thể chuyển sang mô hình dự phòng. Hãy để trống Giới hạn mềm: số lần gọi mô hình cho chúng.

Điều gì xảy ra khi luồng đến nút

MonoChat kiểm tra số dư và cài đặt của nút, rồi bắt đầu một lượt chạy. Lượt chạy ở trạng thái Đang chờ, sau đó Đang chạy. Thực thể luồng chờ tại nút.
Tác tử nhận hướng dẫn và nhiệm vụ, và, khi luồng thuộc về một cuộc hội thoại, nhận các tin nhắn của cuộc hội thoại đó tới Giới hạn lịch sử tin nhắn, với tin nhắn thoại đã được phiên âm.
Tác tử gọi mô hình và công cụ cho đến khi có câu trả lời hoặc chạm một giới hạn. Văn bản nó viết giữa các lượt gọi công cụ được xử lý như tin nhắn trung gian.
Khi lượt chạy kết thúc:
- nếu nó Hoàn thành và Gửi câu trả lời đang bật, câu trả lời được gửi cho khách hàng. Câu trả lời dài được chia thành nhiều tin nhắn khi vượt giới hạn của kênh (4096 ký tự trên WhatsApp);
- nếu kết thúc theo cách khác, một tin nhắn thì thầm "Tác tử AI đã dừng: trạng thái. lỗi" được thêm vào phiên cho đội ngũ của bạn.
Luồng tiếp tục ở đầu ra khớp với cách lượt chạy kết thúc.

Các lượt chạy của cùng một phiên tác tử được xử lý lần lượt, theo thứ tự.

Đầu ra

Đầu ra	Khi nào
Hoàn thành	Tác tử kết thúc với một câu trả lời.
Vượt ngân sách	Lượt chạy đã dùng hết Số lần gọi mô hình tối đa, Số lần gọi công cụ tối đa hoặc Tổng token tối đa.
Hết thời gian	Lượt chạy đạt Thời lượng tối đa (giây).
Thù ghét, Jailbreak, Tự gây hại, Tình dục, Bạo lực	Bộ lọc nội dung của nhà cung cấp mô hình đã dừng lượt chạy vì danh mục này. Đây là các đầu ra giống nút AI.
Khi thất bại	Lượt chạy thất bại vì lý do khác, hoặc bị hủy. Việc dừng do bộ lọc nội dung cũng đi vào đây ở các nút được lưu trước khi có các đầu ra này; hãy mở và lưu lại nút đó để có chúng.

Hãy kết nối ít nhất Hoàn thành và Khi thất bại. Một mẫu phổ biến là chuyển Vượt ngân sách, Hết thời gian và Khi thất bại đến nút Phân công phiên để một đồng nghiệp tiếp quản.

Phiên tác tử

Phiên tác tử là bộ nhớ của tác tử giữa các lượt chạy. MonoChat giữ một phiên tác tử đang hoạt động cho mỗi cuộc hội thoại, harness và khóa nhiệm vụ.

Tiếp tục phiên tác tử hiện có dùng lại phiên đó, nên tác tử tiếp tục từ chỗ đã dừng. Trên harness được lưu trữ, phiên riêng của nhà cung cấp cũng được tiếp tục.
Bắt đầu phiên tác tử mới đóng phiên đang hoạt động và bắt đầu lại từ đầu, ví dụ khi bắt đầu một chủ đề mới.
Khóa nhiệm vụ giữ các phiên độc lập song song trong cùng một cuộc hội thoại.

Thanh toán

Các lượt gọi mô hình trên mô hình AI do MonoChat cung cấp được tính vào số dư của bạn như thường lệ. Các lượt gọi trên mô hình của riêng bạn do nhà cung cấp của bạn tính phí.
Harness do MonoChat cung cấp có thể tính thêm phí riêng theo mỗi lượt chạy, mỗi phút và mỗi lượt gọi công cụ, và, với harness được lưu trữ, tính theo token mà nhà cung cấp của nó báo cáo. Chúng xuất hiện trong Giao dịch dưới dạng AI Agent Run, AI Agent Duration, AI Agent Tool Call và các danh mục token AI.
Harness bạn thêm bằng thông tin xác thực của riêng mình không có phí MonoChat; nhà cung cấp của nó tính phí bạn.
Lượt chạy sẽ không bắt đầu khi số dư của bạn không đủ.

Sự kiện Tác tử AI đã chạy xong

Tác tử AI đã chạy xong là một nút sự kiện. Nó kích hoạt khi một lượt chạy gắn với khách hàng kết thúc, dù lượt chạy do luồng hay do API bắt đầu cùng với một phiên. Giống các nút sự kiện khác, nó có các thiết lập tùy chọn Điều kiện và Hết thời gian chờ. Dùng nó để bắt đầu một luồng riêng sau các lượt chạy tác tử, ví dụ để ghi nhật ký kết quả hoặc thông báo cho một đội.

Bắt đầu tác tử từ mã

Các hàm tùy chỉnh và ứng dụng khách API có thể chạy tác tử bằng các phương thức sau (quyền Chạy / Xem / Hủy lượt chạy tác tử AI trong tự động hóa):

Phương thức	Chức năng
`business.tenants.automation.ai.aiAgentRuns.create`	Bắt đầu một lượt chạy. Trả về `aiAgentRunId` và `aiAgentSessionId`.
`business.tenants.automation.ai.aiAgentRuns.show`	Trả về một lượt chạy (`_id`) cùng trạng thái, mức sử dụng, các bước và kết quả.
`business.tenants.automation.ai.aiAgentRuns.cancel`	Hủy một lượt chạy đang chờ hoặc đang chạy (`_id`).

create nhận aiHarnessClientId, input (nhiệm vụ), tùy chọn sessionId (để làm việc trong một cuộc hội thoại), aiAgentSessionId, taskKey và isNewSession, cùng options với các thiết lập giống nút: instructions, aiModelClientId, fallbackAiModelClientId, fastAiModelClientId, harnessModel, toolCustomFunctionIds, aiScopeIds, aiMcpClientDatas, messageHistoryLimit, speechToTextAiModelClientId, forwardIntermediateMessages, willSendAnswer và budget bắt buộc. Qua API, forwardIntermediateMessages và willSendAnswer mặc định là false.

const { aiAgentRunId } = await sdk.method({ name: 'business.tenants.automation.ai.aiAgentRuns.create' }).callAsync({
  payload: {
    aiHarnessClientId: 'HARNESS_ID',
    input: 'Summarise the open orders of this customer.',
    sessionId: 'SESSION_ID',
    options: {
      instructions: 'You are the order assistant of our store.',
      aiModelClientId: 'MODEL_ID',
      toolCustomFunctionIds: ['FUNCTION_ID'],
      budget: { maxLlmCalls: 4, maxToolCalls: 6, maxTotalTokens: 20000, maxDurationSeconds: 30, maxRetries: 2 },
    },
  },
})

Lượt chạy là bất đồng bộ: đọc nó sau bằng show, hoặc phản ứng với nó bằng sự kiện Tác tử AI đã chạy xong. Khi không có sessionId, mỗi lần gọi bắt đầu một phiên tác tử mới trừ khi bạn truyền aiAgentSessionId mà lần gọi trước đã trả về; khi đó tác tử thấy các lượt chạy đã hoàn thành trước đó của phiên tác tử ấy như lịch sử của nó. Xem Method để biết cách gọi phương thức từ một hàm.

Quyền

Quyền	Cho phép
Xem / Tạo / Cập nhật / Xóa AI harness trong tự động hóa	Quản lý AI Harness
Xem lượt chạy tác tử AI trong tự động hóa	Xem Lượt chạy AI Agent
Chạy tác tử AI trong tự động hóa	Gọi `aiAgentRuns.create`
Hủy lượt chạy tác tử AI trong tự động hóa	Gọi `aiAgentRuns.cancel`

Xem Vai trò.

Lượt chạy AI Agent: xem mỗi lượt chạy đã làm gì
Mô hình AI
Máy khách MCP
Phạm vi AI
Luồng

Các thành phần​

AI Harness​

Thêm harness​

Custom Endpoint​

Nút Tác tử AI​

Các trường​

Điều gì xảy ra khi luồng đến nút​

Đầu ra​

Phiên tác tử​

Thanh toán​

Sự kiện Tác tử AI đã chạy xong​

Bắt đầu tác tử từ mã​

Quyền​

Liên quan​