AI client

O módulo azion/ai do pacote azion é o client da Azion Lib para a Azion AI API, um assistente que responde a perguntas sobre os produtos e serviços da Azion. Você envia uma conversa, e ele retorna a resposta inteira com chat ou em chunks, à medida que o modelo a escreve, com streamChat.

Instale o pacote:

npm install azion

O pacote azion recebe apenas correções de bugs, e a manutenção dele termina em dezembro de 2026.

Todos os exemplos desta página são módulos ES em TypeScript que rodam no Node.js e usam await de nível superior. Os tipos entram por import type, então os exemplos ainda carregam quando uma ferramenta remove as anotações de tipo antes de executá-los.

Autenticação

As funções chat e streamChat leem seu personal token da variável de ambiente AZION_TOKEN. Um client criado com createClient guarda o próprio token, passado no campo token.

Um arquivo .env com as duas variáveis fica assim:

Shell

01AZION_TOKEN=[TOKEN VALUE]

02AZION_DEBUG=true

Variável	Descrição
`AZION_TOKEN`	Seu personal token da Azion.
`AZION_DEBUG`	Com `true`, `chat` imprime o objeto de resposta inteiro antes da resposta, e `streamChat` imprime cada objeto de chunk.

Para saber como os pacotes da Azion Lib resolvem o token e a configuração de debug, consulte Como a Azion Lib funciona.

Envelope de resposta

Toda chamada retorna um objeto AzionAIResult, { data, error }. Em caso de sucesso, data contém a resposta e error é null. Em caso de falha, data é null e error é um Error do JavaScript. Uma chamada recusada não lança exceção.

Leia a falha em error.message. A propriedade message de um Error não é enumerável, então JSON.stringify(error) imprime {} e esconde o motivo.

createClient

Cria um client que guarda um token e as opções de requisição e expõe chat e streamChat como métodos. createClient também é o export padrão de azion/ai.

TypeScript

01function createClient(config?: Partial<{

02 token: string;

03 options?: AzionClientOptions;

04}>): AzionAIClient;

Parâmetro	Tipo	Obrigatório	Descrição
`token`	`string`	Não	Seu personal token da Azion.
`options`	`AzionClientOptions`	Não	Opções de requisição para todas as chamadas que o client faz.

Retorna um AzionAIClient. Seus métodos recebem os mesmos argumentos que as funções chat e streamChat.

Este exemplo cria um client e faz uma pergunta a ele:

TypeScript

01import { createClient } from 'azion/ai';

02import type { AzionAIClient } from 'azion/ai';

04const client: AzionAIClient = createClient({

05 token: process.env.AZION_TOKEN, // Replace with your actual token

06 options: {

07 // Add any additional options here

08 },

09});

const { data, error } = await client.chat({ messages: [{ role: 'user', content: 'What is Azion Object Storage? One sentence.' }] });

12console.log(data ? data.choices[0].message.content : error);

O modelo escreve uma resposta diferente a cada execução. Esta saída está cortada depois da resposta, antes da lista de páginas da documentação:

Texto

Azion Object Storage is a globally distributed, S3-compatible storage solution that organizes data into buckets, supports granular permissions, and integrates seamlessly with Azion's Edge Network for efficient data management and processing.

02…

chat

Envia uma conversa para a Azion AI API e retorna a resposta inteira quando o modelo termina de escrevê-la. A função recebe dois argumentos posicionais, não um objeto.

TypeScript

01function chat(

02 request: AzionAIRequest,

03 options?: AzionClientOptions,

04): Promise<AzionAIResult<AzionAIResponse>>;

Parâmetro	Tipo	Obrigatório	Descrição
`request`	`AzionAIRequest`	Sim	A conversa a enviar.
`options`	`AzionClientOptions`	Não	Opções de requisição.

Retorna data como um AzionAIResponse. A resposta está em choices[0].message.content.

TypeScript

01import { chat } from 'azion/ai';

02import type { AzionAIRequest, AzionAIResponse, AzionAIResult } from 'azion/ai';

04const request: AzionAIRequest = {

05 messages: [{ role: 'user', content: 'Explain what the Azion Web Platform is.' }],

06};

07const { data: response, error }: AzionAIResult<AzionAIResponse> = await chat(request, { debug: false });

08if (response) {

09 console.log('AI response:', response.choices[0].message.content);

10} else {

11 console.error('Chat failed', error);

12}

Em caso de sucesso, o exemplo imprime AI response: seguido da resposta.

streamChat

Envia uma conversa para a Azion AI API e entrega a resposta em chunks enquanto o modelo a escreve. Use para mostrar a resposta à medida que ela chega.

TypeScript

01function streamChat(

02 request: AzionAIRequest,

03 options?: AzionClientOptions,

04): AsyncGenerator<AzionAIResult<AzionAIStreamResponse>>;

Parâmetro	Tipo	Obrigatório	Descrição
`request`	`AzionAIRequest`	Sim	A conversa a enviar.
`options`	`AzionClientOptions`	Não	Opções de requisição.

Retorna um gerador assíncrono, não uma promise: leia-o com for await. Cada chunk é um envelope próprio, com data como um AzionAIStreamResponse. O texto do chunk está em choices[0].delta.content, que um chunk pode omitir.

TypeScript

01import { streamChat } from 'azion/ai';

02import type { AzionAIRequest, AzionAIStreamResponse, AzionAIResult } from 'azion/ai';

04const request: AzionAIRequest = {

05 messages: [{ role: 'user', content: 'List 5 use cases for Azion Functions.' }],

06};

07const stream: AsyncGenerator<AzionAIResult<AzionAIStreamResponse>> = streamChat(request, { debug: false });

08for await (const chunk of stream) {

09 if (chunk.data) {

10 process.stdout.write(chunk.data.choices[0]?.delta.content || '');

11 } else {

12 console.error('Error:', chunk.error);

13 }

14}

15process.stdout.write('\n');

O modelo escreve uma resposta diferente a cada execução. Esta saída está cortada depois do primeiro caso de uso:

Texto

Sure, let me look into the documentation for use cases related to Azion Functions. I'll find some relevant examples for you...

11 Here are 5 use cases for Azion Functions:

1. **Event-Driven Applications**: Create serverless applications that respond to events in real time, enabling ultra-low latency and high scalability. Functions can be reused across different applications and configured with environment variables.

14…

Erros

Uma chamada que falha retorna um Error em error. Leia o texto dele em error.message.

Mensagem	Causa	O que fazer
`HTTP error! status: 403`	A Azion AI API recusou o token.	Use um personal token válido em `AZION_TOKEN` ou no `token` do client.

Tipos

O módulo exporta estes tipos. Importe-os com import type.

AzionAIClient

O client que createClient retorna.

Método	Argumentos	Retorno
`chat`	`request: AzionAIRequest`, `options?: AzionClientOptions`	`Promise<AzionAIResult<AzionAIResponse>>`
`streamChat`	`request: AzionAIRequest`, `options?: AzionClientOptions`	`AsyncGenerator<AzionAIResult<AzionAIStreamResponse>>`

AzionClientOptions

Opções de requisição que chat e streamChat recebem em options, e que createClient recebe para todas as chamadas dele.

Propriedade	Tipo	Obrigatório	Descrição
`debug`	`boolean`	Não	Imprime o objeto de resposta inteiro, ou cada objeto de chunk de um stream, antes da resposta.
`force`	`boolean`	Não	—

AzionAIRequest

A conversa que chat e streamChat enviam.

Propriedade	Tipo	Obrigatório	Descrição
`messages`	`AzionAIMessage[]`	Sim	As mensagens da conversa, em ordem.
`azion`	`AzionAIConfig`	Não	—
`stream`	`boolean`	Não	—

AzionAIMessage

Uma mensagem da conversa.

Propriedade	Tipo	Obrigatório	Descrição
`role`	`'system' \| 'user' \| 'assistant'`	Sim	O autor da mensagem.
`content`	`string`	Sim	O texto da mensagem.

AzionAIConfig

As configurações que uma requisição carrega em azion. Todo campo é uma string opcional.

TypeScript

01interface AzionAIConfig {

02 session_id?: string;

03 url?: string;

04 app?: string;

05 user_name?: string;

06 client_id?: string;

07 system_prompt?: string;

08 user_prompt?: string;

09}

AzionAIResult

O envelope que toda chamada retorna, assim como cada chunk de um stream. Para saber como lê-lo, consulte Envelope de resposta.

Propriedade	Tipo	Obrigatório	Descrição
`data`	`T \| null`	Sim	A resposta, ou `null` quando a chamada falha.
`error`	`Error \| null`	Sim	O erro, ou `null` quando a chamada tem sucesso.

AzionAIResponse

O retorno de chat. A resposta está em choices[0].message.content.

TypeScript

01interface AzionAIResponse {

02 choices: {

03 finish_reason: string;

04 index: number;

05 message: {

06 content: string;

07 role: string;

08 };

09 logprobs: null;

10 }[];

11 created: number;

12 id: string;

13 model: string;

14 object: string;

15 usage: {

16 completion_tokens: number;

17 prompt_tokens: number;

18 total_tokens: number;

19 completion_tokens_details: {

20 reasoning_tokens: number;

21 };

22 };

23}

AzionAIStreamResponse

Um chunk de streamChat. O texto do chunk está em choices[0].delta.content.

TypeScript

01interface AzionAIStreamResponse {

02 choices: {

03 delta: {

04 content?: string;

05 };

06 finish_reason: string | null;

07 index: number;

08 logprobs: null;

09 }[];

10 created: number;

11 id: string;

12 model: string;

13 object: string;

14 system_fingerprint: string;

15}

Recursos relacionados

Azion Lib

As bibliotecas que a Azion Lib oferece e o pacote de onde cada uma vem.

Client

Um único client que alcança as funções de AI junto com Storage, SQL, Purge, Domains e Applications.

Como a Azion Lib funciona

Como os pacotes encontram seu token, ativam a saída de debug e retornam os envelopes.

Tokens pessoais

Crie o token que as funções de AI enviam em cada requisição.