Cohere （獨立發行者）（預覽版）

Cohere 正在使自然語言處理成為每個開發人員工具包的一部分。利用語言理解的力量。加入開發人員和企業的行列，使用 Cohere 以以前難以想像的規模產生、分類和組織文字。

此連接器適用於以下產品和區域：

服務	Class	Regions
副駕駛工作室	進階	除下列區域外的所有 Power Automate 區域： - 美國政府（GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部（DoD）
邏輯應用程式	標準	所有 Logic Apps 區域，但下列區域除外： - Azure Government 區域 - Azure 中國區域 - 美國國防部（DoD）
Power Apps	進階	除下列區域外的所有 Power Apps 區域： - 美國政府（GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部（DoD）
Power Automate（自動化服務）	進階	除下列區域外的所有 Power Automate 區域： - 美國政府（GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部（DoD）

連絡人
名稱	特洛伊·泰勒
URL	https://www.hitachisolutions.com
Email	ttaylor@hitachisolutions.com

連接器中繼資料
Publisher	特洛伊·泰勒
網站	https://cohere.ai/
隱私策略	https://cohere.ai/privacy
類別	AI

正在建立連線

連接器支援下列驗證類型：


預設值	建立連線的參數。	所有區域	不可共享

預設

適用：所有地區

建立連線的參數。

這不是可共用的連線。如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。

名稱	類型	Description	為必填項目
API 金鑰，格式為「持有人API_Key」	securestring	此 API 的 API 金鑰，格式為「持有人API_Key」	對

節流限制

名稱	呼叫	續約期間
每個連線的 API 呼叫	100	60 秒

動作

摘要文字 [已棄用]	為給定文本生成英文摘要。
獲取聊天	產生使用者訊息的文字回應。
產生分類	建立關於哪個標籤最適合指定文字輸入的預測。
產生去標記化文字	使用位元組對編碼轉換權杖，並傳回其文字表示法。
產生文字 [已棄用]	此動作會產生以給定輸入為條件的真實文字。
產生文字內嵌	傳回文字內嵌，這是浮點數的清單，可擷取其所代表文字的語意資訊。
產生權杖	使用位元組對編碼（BPE）將輸入文字分割成稱為權杖的較小單位。
識別語言	偵測每個提供的文字是用哪種語言編寫的。

摘要文字 [已棄用]

作業識別碼：: SummarizePost

為給定文本生成英文摘要。

參數

名稱	機碼	類型	Description
長度	length	string	長度。
格式	format	string	格式。
型號	model	string	模型。
萃取性	extractiveness	string	榨取性。
溫度	temperature	float	溫度。
文字	text	string	文字。

傳回

名稱	路徑	類型	Description
ID	id	string	識別碼。
總結	summary	string	總結。
版本	meta.api_version.version	string	版本。
已被取代	meta.api_version.is_deprecated	boolean	是否已被取代。

獲取聊天

作業識別碼：: ChatPost

產生使用者訊息的文字回應。

參數

名稱	機碼	必要	類型	Description
Message	message	True	string	模型要回應的文字輸入。
型號	model		string	相容 Cohere 模型的名稱或微調模型的 ID。
前文	preamble		string	指定時，預設的 Cohere 前導碼將取代為提供的前導碼。序言是提示的一部分，用於調整模型的整體行為和對話風格，並使用 SYSTEM 角色。
Role	role		string	角色。
Message	message		string	上一則訊息。
交談識別碼	conversation_id		string	聊天記錄的替代方案。提供conversation_id會建立或繼續具有指定識別碼的持續交談。 ID 可以是任何非空字串。
提示截斷	prompt_truncation		string	規定如何建構提示。
ID	id		string	連接器的識別碼。
使用者存取權杖	user_access_token		string	指定時，此使用者存取權杖將傳遞至 Authorization 標頭中的連接器，而不是 Cohere 產生的連接器。
失敗時繼續	continue_on_failure		boolean	如果為true，則如果此連接器傳回錯誤，要求會繼續進行。
僅搜尋查詢	search_queries_only		boolean	當 true 時，回應只會包含產生的搜尋查詢清單，但不會進行任何搜尋，而且不會產生模型對使用者訊息的回覆。
Title	title		string	文件標題。
文字	text		string	文件文字。
引文品質	citation_quality		string	指定在 RAG 流程中產生引文的方法，方法是允許使用者指定他們想要準確的結果還是快速的結果。
溫度	temperature		float	一個非負浮點數，可調整生成中的隨機性程度。較低的溫度意味著更少的隨機世代，而較高的溫度意味著更多的隨機世代。
最大代幣數	max_tokens		integer	模型將在回應中產生的權杖數目上限。附註：設定較低的值可能會導致生成不完整。
最大輸入令牌數	max_input_tokens		integer	要傳送至模型的輸入權杖數目上限。如果未指定，則max_input_tokens是模型的內容長度限制減去小型緩衝區。
k	k		integer	確保在每個步驟中只考慮生成前 k 個最有可能的代幣。預設為 0，最小值為 0，最大值為 500。
p	p		float	確保在每個步驟中只考慮最有可能的標記，總機率質量為 p。如果同時啟用 k 和 p，則 p 會在 k 之後行動。預設為 0.75。最小值為 0.01，最大值為 0.99。
Seed	seed		float	如果指定，後端會盡最大努力以決定性方式取樣權杖，讓具有相同種子和參數的重複要求應該傳回相同的結果。然而，決定論並不能完全保證。
停止序列	stop_sequences		array of string	模型將用來停止產生的最多 5 個字串的清單。如果模型產生符合清單中任何字串的字串，它將停止產生權杖，並傳回產生的文字，直到該點為止，不包括停止序列。
頻率懲罰	frequency_penalty		float	用於減少生成代幣的重複性。值越高，對先前存在的代幣施加的懲罰就越強，與它們在提示或上一代中已經出現的次數成正比。
存在懲罰	presence_penalty		float	用於減少生成代幣的重複性。與frequency_penalty類似，不同之處在於此懲罰同樣適用於所有已經出現的代幣，無論其確切頻率如何。
名稱	name		string	要呼叫的工具名稱。有效名稱僅包含字元 a-z、A-Z、0-9、_，且不得以數字開頭。
Description	description		string	工具功能描述，模型使用描述來選擇何時以及如何呼叫函數。

傳回

名稱	路徑	類型	Description
文字	text	string	文字。
世代識別碼	generation_id	string	世代識別碼。
引文	citations	array of object
開始	citations.start	integer	開始。
結束	citations.end	integer	結束。
文字	citations.text	string	文字。
文件 ID	citations.document_ids	array of string	文件識別碼。
Documents	documents	array of object
ID	documents.id	string	識別碼。
其他屬性	documents.additionalProp	string	其他屬性。
是否需要搜尋	is_search_required	boolean	是否需要搜尋。
搜尋查詢	search_queries	array of object
文字	search_queries.text	string	文字。
世代識別碼	search_queries.generation_id	string	世代識別碼。
搜尋結果	search_results	array of object
文字	search_results.search_query.text	string	文字。
世代識別碼	search_results.search_query.generation_id	string	世代識別碼。
ID	search_results.connector.id	string	識別碼。
文件 ID	search_results.document_ids	array of string	文件識別碼。
錯誤訊息	search_results.error_message	string	錯誤訊息。
失敗時繼續	search_results.continue_on_failure	boolean	是否繼續失敗。
完成原因	finish_reason	string	完成原因。
工具調用	tool_calls	array of object
名稱	tool_calls.name	string	名稱。
聊天記錄	chat_history	array of object
Role	chat_history.role	string	角色。
Message	chat_history.message	string	訊息。
版本	meta.api_version.version	string	版本。
已被取代	meta.api_version.is_deprecated	boolean	是否已被取代。
是實驗性的	meta.api_version.is_experimental	boolean	是否是實驗性的。
輸入權杖	meta.billed_units.input_tokens	integer	輸入權杖。
輸出權杖	meta.billed_units.output_tokens	integer	輸出權杖。
搜尋單位	meta.billed_units.search_units	integer	搜索單位。
Classifications	meta.billed_units.classifications	integer	分類。
輸入權杖	meta.tokens.input_tokens	integer	輸入權杖。
輸出權杖	meta.tokens.output_tokens	integer	輸出權杖。
Warnings	meta.warnings	array of string	警告。

產生分類

作業識別碼：: ClassifyPost

建立關於哪個標籤最適合指定文字輸入的預測。

參數

名稱	機碼	類型	Description
輸入	inputs	array of string	輸入。
型號	model	string	模型。
文字	text	string	文字。
標籤	label	string	標籤。
Preset	preset	string	預設。
截斷	truncate	string	截斷。

傳回

名稱	路徑	類型	Description
ID	id	string	識別碼。
Classifications	classifications	array of object
ID	classifications.id	string	識別碼。
Input	classifications.input	string	輸入。
Prediction	classifications.prediction	string	預測。
信賴度	classifications.confidence	float	信心。
保密	classifications.confidences	array of object
Option	classifications.confidences.option	string	選項。
信賴度	classifications.confidences.confidence	float	信心。
信賴度	classifications.labels.Not spam.confidence	float	信心。
信賴度	classifications.labels.Spam.confidence	float	信心。
版本	meta.api_version.version	string	版本。
已被取代	meta.api_version.is_deprecated	boolean	是否已被取代。

產生去標記化文字

作業識別碼：: DetokenPost

使用位元組對編碼轉換權杖，並傳回其文字表示法。

參數

名稱	機碼	必要	類型	Description
Tokens	tokens		array of integer	代幣。

傳回

名稱	路徑	類型	Description
文字	text	string	文字。
版本	meta.api_version.version	string	版本。
已被取代	meta.api_version.is_deprecated	boolean	是否已被取代。

產生文字 [已棄用]

作業識別碼：: GeneratePost

此動作會產生以給定輸入為條件的真實文字。

參數

名稱	機碼	類型	Description
Prompt	prompt	string	提示。
型號	model	string	模型。
數字世代	num_generations	integer	代數。
最大代幣數	max_tokens	integer	權杖數目上限。
Preset	preset	string	預設。
溫度	temperature	float	溫度。
k	k	integer	k 值。
p	p	float	p 值。
頻率懲罰	frequency_penalty	float	頻率懲罰。
存在懲罰	presence_penalty	float	存在懲罰。
結束序列	end_sequences	array of string	結束序列。
停止序列	stop_sequences	array of string	停止序列。
返回可能性	return_likelihoods	string	返回的可能性。
截斷	truncate	string	截斷。

傳回

名稱	路徑	類型	Description
ID	id	string	識別碼。
世代	generations	array of object
ID	generations.id	string	識別碼。
文字	generations.text	string	文字。
Prompt	prompt	string	提示。

產生文字內嵌

作業識別碼：: EmbedPost

傳回文字內嵌，這是浮點數的清單，可擷取其所代表文字的語意資訊。

參數

名稱	機碼	類型	Description
文本	texts	array of string	文本。
型號	model	string	模型。
截斷	truncate	string	截斷。

傳回

名稱	路徑	類型	Description
ID	id	string	識別碼。
文本	texts	array of string	文本。
嵌入技術	embeddings	array of array	嵌入。
items	embeddings	array of float
版本	meta.api_version.version	string	版本。
已被取代	meta.api_version.is_deprecated	boolean	是否已被取代。

產生權杖

作業識別碼：: TokenPost

使用位元組對編碼（BPE）將輸入文字分割成稱為權杖的較小單位。

參數

名稱	機碼	必要	類型	Description
文字	text		string	文字。

傳回

名稱	路徑	類型	Description
Tokens	tokens	array of integer	代幣。
權杖字串	token_strings	array of string	權杖字串。
版本	meta.api_version.version	string	版本。
已被取代	meta.api_version.is_deprecated	boolean	是否已被取代。

識別語言

作業識別碼：: LanguagePost

偵測每個提供的文字是用哪種語言編寫的。

參數

名稱	機碼	必要	類型	Description
文本	texts		array of string	文本。

傳回

名稱	路徑	類型	Description
ID	id	string	識別碼。
Results	results	array of object
語言代碼	results.language_code	string	語言代碼。
語言名稱	results.language_name	string	語言名稱。
版本	meta.api_version.version	string	版本。
已被取代	meta.api_version.is_deprecated	boolean	是否已被取代。

共用方式為

Cohere （獨立發行者） （預覽版）