Add the power of the Box AI API to your custom apps at Content Cloud Summit on May 15
Learn more and register!Sends an AI request to supported LLMs and returns an answer specifically focused on the creation of new text.
The history of prompts and answers previously passed to the LLM. This provides additional context to the LLM in generating the response.
"Here is the first draft of your professional email about public APIs."
The answer previously provided by the LLM.
"2012-12-12T10:53:43-08:00"
The ISO date formatted timestamp of when the previous answer to the prompt was created.
"Make my email about public APIs sound more professional."
The prompt previously provided by the client and answered by the LLM.
The items to be processed by the LLM, often files.
"123"
The id of the item.
"file"
The type of the item.
Value is always file
"This is file content."
The content to use as context for generating new text or editing existing text.
"Write an email to a client about the importance of public APIs."
The prompt provided by the client to be answered by the LLM.
A successful response including the answer from the LLM.
An unexpected client error.
An unexpected server error.
curl -i -X POST "https://api.box.com/2.0/ai/text_gen" \
-H "content-type: application/json" \
-H "authorization: Bearer <ACCESS_TOKEN>" \
-d '{
"prompt": "Write an email to a client about the importance of public APIs.",
"items": [
{
"id": "12345678",
"type": "file",
"content": "More information about public APIs"
},
{
"id": "87654321",
"type": "file",
},
],
"dialogue_history": [
{
"prompt": "Make my email about public APIs sound more professional",
"answer": "Here is the first draft of your professional email about public APIs",
"created_at": "2013-12-12T10:53:43-08:00"
},
{
"prompt": "Can you add some more information?",
"answer": "Public API schemas provide necessary information to integrate with APIs...",
"created_at": "2013-12-12T11:20:43-08:00"
}
],
}'
List<BoxAIDialogueEntry> dialogueHistory = new ArrayList<>();
dialogueHistory.add(
new BoxAIDialogueEntry(
"Make my email about public APIs sound more professional",
"Here is the first draft of your professional email about public APIs.",
BoxDateFormat.parse("2013-05-16T15:26:57-07:00")
)
);
BoxAIResponse response = BoxAI.sendAITextGenRequest(
api,
"Write an email to a client about the importance of public APIs.",
Collections.singletonList(new BoxAIItem("123456", BoxAIItem.Type.FILE)),
dialogueHistory
);
await client.ai.createAiTextGen({
prompt: 'Parapharse the document.s',
items: [
{
id: fileToAsk.id,
type: 'file' as AiTextGenItemsTypeField,
content:
'The Earth goes around the sun. Sun rises in the East in the morning.',
} satisfies AiTextGenItemsField,
],
dialogueHistory: [
{
prompt: 'What does the earth go around?',
answer: 'The sun',
createdAt: dateTimeFromString('2021-01-01T00:00:00Z'),
} satisfies AiTextGenDialogueHistoryField,
{
prompt: 'On Earth, where does the sun rise?',
answer: 'East',
createdAt: dateTimeFromString('2021-01-01T00:00:00Z'),
} satisfies AiTextGenDialogueHistoryField,
],
} satisfies AiTextGen);
client.ai.create_ai_text_gen('Parapharse the document.s', [CreateAiTextGenItems(id=file_to_ask.id, type=CreateAiTextGenItemsTypeField.FILE.value, content='The Earth goes around the sun. Sun rises in the East in the morning.')], dialogue_history=[CreateAiTextGenDialogueHistory(prompt='What does the earth go around?', answer='The sun', created_at=date_time_from_string('2021-01-01T00:00:00Z')), CreateAiTextGenDialogueHistory(prompt='On Earth, where does the sun rise?', answer='East', created_at=date_time_from_string('2021-01-01T00:00:00Z'))])
await client.Ai.CreateAiTextGenAsync(requestBody: new AiTextGen(prompt: "Parapharse the document.s", items: Array.AsReadOnly(new [] {new AiTextGenItemsField(id: fileToAsk.Id, type: AiTextGenItemsTypeField.File, content: "The Earth goes around the sun. Sun rises in the East in the morning.")}), dialogueHistory: Array.AsReadOnly(new [] {new AiTextGenDialogueHistoryField(prompt: "What does the earth go around?", answer: "The sun", createdAt: Utils.DateTimeFromString(dateTime: "2021-01-01T00:00:00Z")),new AiTextGenDialogueHistoryField(prompt: "On Earth, where does the sun rise?", answer: "East", createdAt: Utils.DateTimeFromString(dateTime: "2021-01-01T00:00:00Z"))})));
{
"answer": "Public APIs are important because of key and important reasons.",
"completion_reason": "done",
"created_at": "2012-12-12T10:53:43-08:00"
}