> For the complete documentation index, see [llms.txt](https://docs.skydeck.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.skydeck.ai/pt/genstudio-workspace/tools/pair-programmer/how-to-use.md).

# Como Usar

Para começar a usar o Pair Programmer, você precisará especificar a linguagem de programação que está usando ou deseja usar. Por padrão, o campo está definido para Python.

Uma vez que você enviar sua linguagem de programação, você receberá uma mensagem semelhante à abaixo (embora a redação exata possa diferir) que detalha o que o Pair Programmer tem a oferecer e fornece alguns comandos úteis:

<figure><img src="/files/lyA5jnJCup76I8qSJ6FK" alt="exemplo de programador em par"><figcaption></figcaption></figure>

Se tudo parecer correto, você pode então escrever sua pergunta de programação na área de prompt.

### /change

O comando `/change` permite que você modifique suas preferências ao interagir com o Pair Programmer. Atualmente, ele suporta duas opções:

* **Linguagem de programação** – Mudar a linguagem de programação. Por exemplo, digite `/change language=Java` para mudar para Java.
* **Linguagem de interação** – Mudar a linguagem de comunicação. Por exemplo, digite `/change language=Spanish` para mudar para espanhol.

### /implement

O comando `/implement` é usado quando você deseja criar um novo programa. Segue um procedimento de cinco passos para garantir uma abordagem completa:

Por exemplo, você poderia inserir `/implement task=DescriçãoDaTarefa`. Por favor, substitua `DescriçãoDaTarefa` pela descrição da tarefa que você deseja implementar.

#### Exemplo

Vamos supor que você queira implementar um programa que calcule a soma de todos os elementos em uma lista.

{% code overflow="wrap" %}

```
/implementar task=Crie uma função Python que calcule a soma de todos os elementos em uma lista. A função deve receber uma lista de inteiros como entrada e retornar um inteiro como saída.
```

{% endcode %}

### /modificar

O comando `/modificar` é usado quando você deseja fazer alterações ou ajustes em um programa existente. Digite `/modificar código=CódigoDoPrograma modificações=ModificaçõesDoPrograma`. Por favor, substitua `CódigoDoPrograma` pelo programa que você deseja modificar, e `ModificaçõesDoPrograma` por uma descrição do que você deseja alterar.

#### Exemplo

Por exemplo, imagine que você tem uma função Python que calcula a área de um retângulo e você quer modificá-la para calcular a área de um círculo em vez disso.

{% code overflow="wrap" %}

```
/modify code=
def area_retangulo(comprimento, largura):
    return comprimento * largura

modifications=
Altere a função para calcular a área de um círculo em vez disso, usando a fórmula `pi * raio^2`. A função deve receber um único argumento para o raio.
```

{% endcode %}

### /test

O comando `/test` é usado quando você quer que eu crie casos de teste para um determinado programa. Insira `/test code=CodigoDoPrograma description=DescriçãoDoPrograma`. Substitua `CodigoDoPrograma` pelo programa que você deseja testar, e `DescriçãoDoPrograma` por uma descrição do que o programa faz.

#### Exemplo

Digamos que você tenha uma função Python que calcula o fatorial de um número e você quer criar casos de teste para ela

{% code overflow="wrap" %}

```
/test code=
def fatorial(n):
    if n == 0:
        return 1
    else:
        return n * fatorial(n-1)

description=
Esta função calcula o fatorial de um número dado. O fatorial de um número n é o produto de todos os inteiros positivos menores ou iguais a n.
```

{% endcode %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.skydeck.ai/pt/genstudio-workspace/tools/pair-programmer/how-to-use.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
