Cohere (Independent Publisher) (Preview)

Cohere is making natural language processing part of every developer's toolkit. Harness the power of language understanding. Join the developers and businesses who are using Cohere to generate, categorize and organize text at a scale that was previously unimaginable.

This connector is available in the following products and regions:

Service	Class	Regions
Logic Apps	Standard	All Logic Apps regions except the following:      -   Azure Government regions      -   Azure China regions      -   US Department of Defense (DoD)
Power Automate	Premium	All Power Automate regions except the following:      -   US Government (GCC)      -   US Government (GCC High)      -   China Cloud operated by 21Vianet      -   US Department of Defense (DoD)
Power Apps	Premium	All Power Apps regions except the following:      -   US Government (GCC)      -   US Government (GCC High)      -   China Cloud operated by 21Vianet      -   US Department of Defense (DoD)

Contact
Name	Troy Taylor
URL	https://www.hitachisolutions.com
Email	ttaylor@hitachisolutions.com

Connector Metadata
Publisher	Troy Taylor
Website	https://cohere.ai/
Privacy policy	https://cohere.ai/privacy
Categories	AI

Creating a connection

The connector supports the following authentication types:

Default	Parameters for creating connection.	All regions	Not shareable

Default

Applicable: All regions

Parameters for creating connection.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Name	Type	Description	Required
API Key in the form 'Bearer API_Key'	securestring	The API Key in the form 'Bearer API_Key' for this api	True

Throttling Limits

Name	Calls	Renewal Period
API calls per connection	100	60 seconds

Actions

Generate classification	Creates a prediction about which label fits the specified text inputs best.
Generate detokenized text	Converts tokens using byte-pair encoding and returns their text representation.
Generate text [DEPRECATED]	This action generates realistic text conditioned on a given input.
Generate text embeddings	Returns text embeddings which are lists of floating point numbers that captures semantic information about the text that it represents.
Generate tokens	Splits input text into smaller units called tokens using byte-pair encoding (BPE).
Get chat	Generates a text response to a user message.
Identify language	Detects which language each of the provided texts is written in.
Summarize text [DEPRECATED]	Generates a summary in English for a given text.

Generate classification

Operation ID:

ClassifyPost

Creates a prediction about which label fits the specified text inputs best.

Parameters

Name	Key	Required	Type	Description
Inputs	inputs		array of string	The inputs.
Model	model		string	The model.
Text	text		string	The text.
Label	label		string	The label.
Preset	preset		string	The preset.
Truncate	truncate		string	The truncate.

Returns

Name	Path	Type	Description
ID	id	string	The identifier.
Classifications	classifications	array of object
ID	classifications.id	string	The identifier.
Input	classifications.input	string	The input.
Prediction	classifications.prediction	string	The prediction.
Confidence	classifications.confidence	float	The confidence.
Confidences	classifications.confidences	array of object
Option	classifications.confidences.option	string	The option.
Confidence	classifications.confidences.confidence	float	The confidence.
Confidence	classifications.labels.Not spam.confidence	float	The confidence.
Confidence	classifications.labels.Spam.confidence	float	The confidence.
Version	meta.api_version.version	string	The version.
Is Deprecated	meta.api_version.is_deprecated	boolean	Whether is deprecated.

Generate detokenized text

Operation ID:

DetokenPost

Converts tokens using byte-pair encoding and returns their text representation.

Parameters

Name	Key	Required	Type	Description
Tokens	tokens		array of integer	The tokens.

Returns

Name	Path	Type	Description
Text	text	string	The text.
Version	meta.api_version.version	string	The version.
Is Deprecated	meta.api_version.is_deprecated	boolean	Whether is deprecated.

Generate text [DEPRECATED]

Operation ID:

GeneratePost

This action generates realistic text conditioned on a given input.

Parameters

Name	Key	Required	Type	Description
Prompt	prompt		string	The prompt.
Model	model		string	The model.
Num Generations	num_generations		integer	The number of generations.
Max Tokens	max_tokens		integer	The maximum number of tokens.
Preset	preset		string	The preset.
Temperature	temperature		float	The temperature.
k	k		integer	The k value.
p	p		float	The p value.
Frequency Penalty	frequency_penalty		float	The frequency penalty.
Presence Penalty	presence_penalty		float	The presence penalty.
End Sequences	end_sequences		array of string	The end sequences.
Stop Sequences	stop_sequences		array of string	The stop sequences.
Return Likelihoods	return_likelihoods		string	The return likelihoods.
Truncate	truncate		string	The truncate.

Returns

Name	Path	Type	Description
ID	id	string	The identifier.
Generations	generations	array of object
ID	generations.id	string	The identifier.
Text	generations.text	string	The text.
Prompt	prompt	string	The prompt.

Generate text embeddings

Operation ID:

EmbedPost

Returns text embeddings which are lists of floating point numbers that captures semantic information about the text that it represents.

Parameters

Name	Key	Required	Type	Description
Texts	texts		array of string	The texts.
Model	model		string	The model.
Truncate	truncate		string	The truncate.

Returns

Name	Path	Type	Description
ID	id	string	The identifier.
Texts	texts	array of string	The texts.
Embeddings	embeddings	array of array	The embeddings.
items	embeddings	array of float
Version	meta.api_version.version	string	The version.
Is Deprecated	meta.api_version.is_deprecated	boolean	Whether is deprecated.

Generate tokens

Operation ID:

TokenPost

Splits input text into smaller units called tokens using byte-pair encoding (BPE).

Parameters

Name	Key	Required	Type	Description
Text	text		string	The text.

Returns

Name	Path	Type	Description
Tokens	tokens	array of integer	The tokens.
Token Strings	token_strings	array of string	The token strings.
Version	meta.api_version.version	string	The version.
Is Deprecated	meta.api_version.is_deprecated	boolean	Whether is deprecated.

Get chat

Operation ID:

ChatPost

Generates a text response to a user message.

Parameters

Name	Key	Required	Type	Description
Message	message	True	string	Text input for the model to respond to.
Model	model		string	The name of a compatible Cohere model or the ID of a fine-tuned model.
Preamble	preamble		string	When specified, the default Cohere preamble will be replaced with the provided one. Preambles are a part of the prompt used to adjust the model's overall behavior and conversation style, and use the SYSTEM role.
Role	role		string	The role.
Message	message		string	The previous message.
Conversation ID	conversation_id		string	An alternative to chat history. Providing a conversation_id creates or resumes a persisted conversation with the specified ID. The ID can be any non empty string.
Prompt Truncation	prompt_truncation		string	Dictates how the prompt will be constructed.
ID	id		string	The identifier of the connector.
User Access Token	user_access_token		string	When specified, this user access token will be passed to the connector in the Authorization header instead of the Cohere generated one.
Continue On Failure	continue_on_failure		boolean	When true, the request will continue if this connector returned an error.
Search Queries Only	search_queries_only		boolean	When true, the response will only contain a list of generated search queries, but no search will take place, and no reply from the model to the user's message will be generated.
Title	title		string	The document title.
Text	text		string	The document text.
Citation Quality	citation_quality		string	Dictates the approach taken to generating citations as part of the RAG flow by allowing the user to specify whether they want accurate results or fast results.
Temperature	temperature		float	A non-negative float that tunes the degree of randomness in generation. Lower temperatures mean less random generations, and higher temperatures mean more random generations.
Max Tokens	max_tokens		integer	The maximum number of tokens the model will generate as part of the response. Note: Setting a low value may result in incomplete generations.
Max Input Tokens	max_input_tokens		integer	The maximum number of input tokens to send to the model. If not specified, max_input_tokens is the model's context length limit minus a small buffer.
k	k		integer	Ensures only the top k most likely tokens are considered for generation at each step. Defaults to 0, min value of 0, max value of 500.
p	p		float	Ensures that only the most likely tokens, with total probability mass of p, are considered for generation at each step. If both k and p are enabled, p acts after k. Defaults to 0.75. min value of 0.01, max value of 0.99.
Seed	seed		float	If specified, the backend will make a best effort to sample tokens deterministically, such that repeated requests with the same seed and parameters should return the same result. However, determinism cannot be totally guaranteed.
Stop Sequences	stop_sequences		array of string	A list of up to 5 strings that the model will use to stop generation. If the model generates a string that matches any of the strings in the list, it will stop generating tokens and return the generated text up to that point not including the stop sequence.
Frequency Penalty	frequency_penalty		float	Used to reduce repetitiveness of generated tokens. The higher the value, the stronger a penalty is applied to previously present tokens, proportional to how many times they have already appeared in the prompt or prior generation.
Presence Penalty	presence_penalty		float	Used to reduce repetitiveness of generated tokens. Similar to frequency_penalty, except that this penalty is applied equally to all tokens that have already appeared, regardless of their exact frequencies.
Name	name		string	The name of the tool to be called. Valid names contain only the characters a-z, A-Z, 0-9, _ and must not begin with a digit.
Description	description		string	The description of what the tool does, the model uses the description to choose when and how to call the function.

Returns

Name	Path	Type	Description
Text	text	string	The text.
Generation ID	generation_id	string	The generation identifier.
Citations	citations	array of object
Start	citations.start	integer	The start.
End	citations.end	integer	The end.
Text	citations.text	string	The text.
Document IDs	citations.document_ids	array of string	The document identifiers.
Documents	documents	array of object
ID	documents.id	string	The identifier.
Additional Properties	documents.additionalProp	string	The additional properties.
Is Search Required	is_search_required	boolean	Whether is search required.
Search Queries	search_queries	array of object
Text	search_queries.text	string	The text.
Generation ID	search_queries.generation_id	string	The generation identifier.
Search Results	search_results	array of object
Text	search_results.search_query.text	string	The text.
Generation ID	search_results.search_query.generation_id	string	The generation identifier.
ID	search_results.connector.id	string	The identifier.
Document IDs	search_results.document_ids	array of string	The document identifiers.
Error Message	search_results.error_message	string	The error message.
Continue On Failure	search_results.continue_on_failure	boolean	Whether to continue on failure.
Finish Reason	finish_reason	string	The finish reason.
Tool Calls	tool_calls	array of object
Name	tool_calls.name	string	The name.
Chat History	chat_history	array of object
Role	chat_history.role	string	The role.
Message	chat_history.message	string	The message.
Version	meta.api_version.version	string	The version.
Is Deprecated	meta.api_version.is_deprecated	boolean	Whether is deprecated.
Is Experimental	meta.api_version.is_experimental	boolean	Whether is experimental.
Input Tokens	meta.billed_units.input_tokens	integer	The input tokens.
Output Tokens	meta.billed_units.output_tokens	integer	The output tokens.
Search Units	meta.billed_units.search_units	integer	The search units.
Classifications	meta.billed_units.classifications	integer	The classifications.
Input Tokens	meta.tokens.input_tokens	integer	The input tokens.
Output Tokens	meta.tokens.output_tokens	integer	The output tokens.
Warnings	meta.warnings	array of string	The warnings.

Identify language

Operation ID:

LanguagePost

Detects which language each of the provided texts is written in.

Parameters

Name	Key	Required	Type	Description
Texts	texts		array of string	The texts.

Returns

Name	Path	Type	Description
ID	id	string	The identifier.
Results	results	array of object
Language Code	results.language_code	string	The language code.
Language Name	results.language_name	string	The language name.
Version	meta.api_version.version	string	The version.
Is Deprecated	meta.api_version.is_deprecated	boolean	Whether is deprecated.

Summarize text [DEPRECATED]

Operation ID:

SummarizePost

Generates a summary in English for a given text.

Parameters

Name	Key	Required	Type	Description
Length	length		string	The length.
Format	format		string	The format.
Model	model		string	The model.
Extractiveness	extractiveness		string	The extractiveness.
Temperature	temperature		float	The temperature.
Text	text		string	The text.

Returns

Name	Path	Type	Description
ID	id	string	The identifier.
Summary	summary	string	The summary.
Version	meta.api_version.version	string	The version.
Is Deprecated	meta.api_version.is_deprecated	boolean	Whether is deprecated.